5 chyb, které ničí oblečení z druhé ruky

Když v prohlížeči odešleš požadavek na server, začne cesta, která má jasná pravidla. REST API je jen dohoda, jak spolu dvě strany mluví: klient pošle HTTP požadavek, server vrátí odpověď. Než začneš psát kód, zjisti si, na jaké adrese služba běží, jakou metodou se data čtou a jakou zapisují. Metody GET, POST, PUT a DELETE nejsou volitelné dekorace. Pokud je zaměníš, server buď vrátí chybu, nebo – což je horší – něco nechtěně změní.

Nejčastější chybou je snaha automatizovat příliš mnoho najednou. Začněte jednou úlohou, která zabere alespoň hodinu týdně. Otestujte ji na malém vzorku dat a teprve potom ji pusťte naostro. Dávejte pozor na formát údajů – datum, měna nebo diakritika v českých jménech mohou způsobit chybu. Vždy si nastavte upozornění, když automatizace selže, ať víte, kde hledat problém. Také si hlídejte, kdo má přístup k vašim datům, a nepoužívejte stejné heslo jako k firemnímu e-mailu.

Prvním krokem je vymyslet příběh, který celou hru spojí. Nemusí to být složité – stačí, že se ztratil klíč od truhly, zakletý poklad nebo zpráva od kamaráda. Příběh pak určuje, jaké šifry použijete. Pro nejmenší volte obrázkové šifry, kde každý symbol odpovídá jednomu písmenu. Pro školáky se hodí posun písmen v abecedě, čtení pozpátku nebo jednoduchá čísla, která odpovídají pořadí písmen. Vždy si předem vyzkoušejte, zda se šifra dá opravdu rozluštit – nic nekazí hru víc než nerozluštitelná indicie.

Další častou chybou je trestání strachu. Pes, který se bojí hlasitého zvuku nebo cizího člověka, potřebuje podporu, ne výtku. Pokud ho v takové chvíli potrestáte, naučí se, že se má bát ještě víc, a navíc že se vám nemá svěřovat. Místo toho ho odveďte z situace, dejte mu prostor a odměňte klidné chování, až se uvolní.

Oblečení z druhé ruky má často za sebou už několik životů. Vláken se dotkly pot, slunce, aviváž, sušička i nešetrné praní. To, co mu zbývá, závisí hlavně na tom, jak se k němu chováte po přinesení domů. Většina lidí ho zničí během prvních dvou týdnů – ne nošením, ale praním a sušením.

Než začnete cokoli kupovat, změřte si šířku chodby ve třech místech: u vchodu, uprostřed a u dveří do další místnosti. Zjistíte tak, kolik místa skutečně zbývá na průchod. Dospělý člověk potřebuje na pohodlný průchod alespoň 60 cm, dva lidé se vyhnou na 80–90 cm. Pokud je chodba užší, musíte volit hloubku nábytku do 30 cm, jinak budete do věšáku narážet ramenem.

Typickou chybou je také nesouvislá komunikace. Pes potřebuje jasná pravidla. Pokud jednou může na gauč a podruhé ne, přestává chápat, co je správně. Stejně tak funguje jen jeden způsob odměňování. Není nutné mít vždy pamlsek, ale je nutné mít vždy stejný klidný tón a stejný okamžik odměny. Důvěra roste z předvídatelnosti.

Až bude první požadavek fungovat, ulož si ho jako opakovaně použitelný příklad. Ověř si, že umíš přečíst data, zapsat je, upravit a smazat. Teprve pak přidej autentizaci a ošetření chyb. Kdo začne rovnou složitou integrací, stráví hodiny hledáním problému, který by odhalil jediný ruční test. Od požadavku k odpovědi vede krátká cesta, ale chce trpělivost a pozornost k detailům.

Při odesílání dat pozor na kódování a na strukturu. Tělo požadavku musí odpovídat tomu, co server čeká: jména polí, typy hodnot, povinné údaje. Chybějící uvozovky u čísla nebo textu způsobí, že server vrátí 400. Datum posílej v jednotném formátu, ideálně včetně časového pásma. Diakritiku nech v UTF-8, jinak se znaky rozsypou. A hlavně: nikdy neposílej hesla ani klíče v adrese požadavku, protože se ukládají do logů.

Prvním krokem je přestat tlačit na výkon. Mnozí majitelé chtějí rychlé výsledky, a tak opakují povel desetkrát za sebou, zvyšují hlas a nakonec psa fyzicky usměrňují. Tím vzniká přesně opačný efekt: pes přestane vnímat, co po něm chcete, a začne řešit, jak se vyhnout tlaku. Místo toho stačí krátké, klidné sezení. Tři opakování denně, vždy zakončená úspěchem, udělají víc než hodina nervózního drilem.

Nejčastější začátečnická chyba je ignorovat opakování a timeouty. Server může být krátce nedostupný a požadavek se nevyřídí. Nastav rozumnou dobu čekání a při selhání zkus požadavek znovu, ale jen u operací, které nic nemění. U zápisu opakování bez rozmyslu vytvoří duplicity. Pomůže ti idempotentní klíč nebo kontrola, jestli záznam už neexistuje. Také loguj stavové kódy a dobu odpovědi, ať víš, kde se co zdrželo.

Proč se vyplatí číst tělo odpovědi celé Tělo odpovědi nebývá jen data, která jsi chtěl. Server do něj často přidá stav, chybovou zprávu nebo stránkování. U seznamů sleduj, kolik položek přišlo a jestli existuje odkaz na další stránku. Pokud pole ignoruješ, budeš mít dojem, že API vrací málo dat, i když jich má tisíce. Formát bývá JSON, ale setkáš se i s XML nebo čistým textem. Vždy zkontroluj hlavičku s typem obsahu, ať nesnažíš parsovat něco, co JSON není.