Začněte jedním procesem, ne celou firmou Vyberte si jeden jednoduchý úkol, který se opakuje denně nebo týdně, a zautomatizujte jen jeho. Typicky jde o sběr poptávek z webového formuláře, které se mají rovnou zapsat do tabulky a poslat potvrzovací e-mail. Většina online tabulek i formulářů nabízí propojení přímo v nastavení, bez jakéhokoliv programování. Pokud potřebujete spojit dvě různé aplikace, použijte vizuální nástroj, kde se kroky skládají přetažením a nastavením podmínek. Spouštěčem bývá nová položka, nový e-mail nebo změna stavu, akcí pak zápis, přesun nebo odeslání zprávy.
Prvním signálem bývá zápach z tlamy, který nezmizí ani po vyčištění zubů. Pes může mít viditelné hnědé usazeniny na zubech, zejména u dásně. Dáseň bývá zarudlá, oteklá nebo naopak bledá a ustupující. V pokročilejším stadiu pes sliní více než obvykle, může mít zakrvácenou slinu nebo krev na hračkách a misce. Často také žvýká jen na jedné straně tlamy, upouští potravu nebo odmítá tvrdé krmivo. Někteří psi si tlamu tře packou, jiní naopak nechtějí, abyste se jim do tlamy vůbec dívali.
Skladování rozhoduje o tom, jak dlouho textilie vydrží. Závěsy nikdy neukládejte složené do igelitových pytlů – látka potřebuje vzduch, jinak chytne zatuchlý pach a mohou se v ní usadit plísně. Ubrusy skládejte volně, ne do ostrých žehlících hran, a mezi jednotlivé kusy vložte tenký papír. Pokud dodržíte tyto zásady, závěsy i ubrusy vám vydrží o několik let déle a nebudete je muset nahrazovat jen proto, že ztratily barvu nebo tvar.
Teplota a program rozhodují víc než značka prostředku U ubrusů je nejdůležitější znát původ skvrn. Čerstvou skvrnu od kávy nebo vína vyperte co nejdříve, ideálně do dvou hodin. Stačí ji opláchnout studenou vodou z rubu a potom vyprat na třicet stupňů. Horká voda skvrnu zajistí, což je jedna z nejčastějších chyb – lidé si myslí, že čím teplejší voda, tím lépe vypere. U bílých ubrusů z bavlny můžete jít na šedesát stupňů, u barevných a potištěných zůstaňte na třiceti až čtyřiceti. Syntetické ubrusy perte na třicet stupňů a vždy zapněte program pro jemné prádlo.
Poslední věc, na kterou se zapomíná, je verzování. První verze API vypadá jako konečná, ale za půl roku budete potřebovat změnit formát odpovědi. Když verzi nemáte v adrese nebo v hlavičce, rozbijete všechny existující klienty. Stačí jednoduché /v1/ a máte prostor pro změny. A nezapomeňte na logování. Bez záznamu požadavků a odpovědí se při chybě nedozvíte, co se stalo. Logujte metodu, cestu, stavový kód a čas, ale nikdy necitlivá data.
Častou chybou je příliš řídké těsto. Pokud se leje z lžíce jako hustá smetana, bude nutné přidat mouku, a tím se ztratí křupavost. Těsto má držet tvar a lehce se roztírat. Vajíčka pomáhají spojit hmotu, ale dvě stačí i na větší množství brambor; více vajec dělá těsto gumovým a mastným. Sůl přidávejte až těsně před smažením, protože dřívější solení vytahuje z brambor další vodu. Trochu drceného kmínu a čerstvě mletého pepře stačí, česnek se hodí spíš do těsta než na povrch, kde se snadno spálí.
Před koupí si změřte vzdálenost od zdi. Čelo postele nesmí být natěsno u zdi, pokud za ním vede zásuvka nebo topení. Mezera tři až pět centimetrů zabrání tomu, aby se látka otlačila a aby se za čelem držela vlhkost. Zároveň tím získáte prostor pro pozdější úpravu, pokud budete chtít čelo posunout nebo vyměnit.
Autentizaci neřešte až na konci. API bez ověření je otevřené dveře. Pro začátek stačí token v hlavičce Authorization. Nikdy neposílejte heslo v URL, protože se ukládá do logů a historie prohlížeče. Token mějte krátkodobý a obnovujte ho. Pokud API používá více klientů, zvažte, zda potřebujete rozlišovat oprávnění. Bez toho se dostanete do situace, kdy jeden klient může mazat data druhého.
Závěsy a ubrusy patří k textiliím, které toho vydrží hodně, ale právě proto se u nich nejčastěji opakují stejné chyby. Největší problém nebývá špatný prací prostředek, ale to, že se perou příliš často, příliš horkou vodou a bez ohledu na materiál. Základní pravidlo zní: čtěte štítek před každým praním, i když stejný kus perete po páté. Údaje na štítku se totiž mohou lišit i u zdánlivě stejných látek od různých výrobců.
Formát odpovědi držte konzistentní. Pokud vracíte JSON, vracejte JSON vždy, i pro chyby. Stejně tak hlavička Content-Type musí odpovídat skutečnosti. Častá chyba je poslat text/html s JSON obsahem, což některé klienty zmate. U seznamů myslete na stránkování. Nikdy nevracejte všechny záznamy najednou, jinak při růstu dat přestane API odpovídat. Použijte parametry jako limit a offset nebo kursor. A v odpovědi uveďte, kolik záznamů celkem existuje, aby klient věděl, jestli má načítat dál.
- ID: 425911
Be the first to review “První REST API: chyba, která zničí i funkční odpověď”
Reviews
There are no reviews yet.