První REST API: chyba, která zablokuje odpověď

Nejlepší místo je suchá, dobře větraná místnost s pokojovou teplotou. Tenisky postavte volně na podlahu nebo na stojan tak, aby vzduch proudil kolem celé boty, nejen shora. Pokud je můžete pověsit za patu na šňůru, pomůže to odtékat vodě z povrchu. Vložky a tkaničky položte vedle na ručník. Výměna novinového papíru uvnitř bot urychlí sušení – první náplň vyměňte po hodině, další po dvou až třech hodinách. U kožených tenisek papír uvnitř střídejte ještě častěji, protože kůže nesnáší dlouhé vlhko a snadno ztvrdne.

Během zkušebního provozu si veďte poznámky. Zapisujte každý případ, kdy automatizace selhala nebo kdy jste museli zasáhnout ručně. Nejčastější chyby jsou tři: chybějící povinné údaje ve vstupu, duplicitní záznamy a chybějící oznámení o selhání. Pokud automatizace tiše přestane fungovat a nikdo si toho nevšimne, ztrácíte data i důvěru. Proto vždy nastavte alespoň jeden jednoduchý kontrolní výstup – třeba zprávu, když se zpracování nezdaří.

Na závěr: podkroví pod šikminou nepotřebuje velké zásahy, ale přesné rozměry a přizpůsobení nábytku sklonu střechy. Kdo začne nákupem nábytku a měřením až potom, skončí s nevyužitými rohy a zbytečně drahými úpravami. Kdo nejdřív změří a nakreslí, získá plnohodnotný obytný prostor i tam, kde to na první pohled vypadá nemožně.

Než pošleš první požadavek na server, ujasni si, co vlastně chceš dostat zpět. Většina začátečníků přeskočí tuto úvahu a rovnou píše kód, pak tráví hodiny hledáním chyby v odpovědi, která vůbec nemá správný tvar. REST API není magie – je to jen dohoda o tom, jaká data pošleš a jaká dostaneš. Pokud tato dohoda chybí, i funkční kód vypadá jako rozbitý.

Začni metodou GET, protože nic nemění a snadno se testuje. Požadavek pošli na konkrétní adresu, ale dávej pozor na dvě věci: hlavičku Accept s hodnotou application/json a správné kódování parametrů v URL. Mezera nebo český znak v dotazu bez zakódování rozbije požadavek ještě předtím, než opustí tvůj počítač. Pokud server odpoví stavovým kódem 404, neznamená to nutně, že cesta neexistuje – často je jen špatně zapsaný identifikátor zdroje.

Nejčastější chyba je hluboká skříň postavená na kratší stěnu. Vypadá prakticky, ale opticky ji předsune dopředu a zbytek místnosti se zmáčkne. Řešením je nízká, ale široká sestava, nebo naopak úzká skříň, která kopíruje delší stěnu. Pokud potřebujete úložný prostor, vsaďte na vestavěné skříně zarovnané s omítkou. Když jsou dvířka v barvě stěny a bez výrazných úchylek, splynou s povrchem a předsíň zůstane vzdušná.

Při odesílání dat metodou POST nebo PUT nezapomeň nastavit hlavičku Content-Type na application/json a tělo skutečně serializovat. Ruční skládání JSON řetězce je častý zdroj chyb – uvozovky, čárky a escapování českých znaků se snadno rozbijí. Použij funkci pro převod objektu na JSON a zkontroluj, že výsledek je platný. Server ti neřekne „máš tam chybějící uvozovku", prostě vrátí 400 a ty budeš hledat problém jinde.

Největší pastí je testovat jen šťastnou cestu. Zkus poslat neplatný vstup, chybějící parametr, příliš dlouhý řetězec nebo nepodporovanou metodu. Právě tehdy zjistíš, jak se API chová a co máš ošetřit. Pokud server vrací chyby bez struktury, je to signál, že s ním bude těžká práce – a možná je lepší nejdřív upravit vlastní požadavek než obviňovat protistranu.

Po obdržení odpovědi ověř, že skutečně přišel JSON, a teprve pak přistupuj k polím. Pokud server vrátí HTML chybovou stránku, parsování JSON selže a ty uvidíš nesmyslnou výjimku. Vždy loguj celou odpověď včetně hlaviček, dokud API neběží spolehlivě. Až bude všechno fungovat, teprve pak logování zredukuj. Odpověď často obsahuje vnořené objekty – přistupuj k nim po jednotlivých krocích a kontroluj, zda pole existuje, místo abys předpokládal, že tam vždy bude.

Stavové kódy nejsou dekorace Odpověď vždy nejdřív zkontroluj podle stavového kódu, teprve potom čti tělo. Kód 200 znamená úspěch, 201 vznik zdroje, 400 chybu na straně požadavku, 401 chybějící přihlášení, 403 nedostatečné oprávnění a 500 chybu serveru. Typická chyba začátečníka je ignorovat 204, což je úspěch bez těla – kód pak padá na tom, že se snaží parsovat prázdný řetězec. Stejně tak je chyba spoléhat na textovou zprávu v těle odpovědi místo na stavový kód.

Textil je nejrychlejší cesta. Povlečení, závěsy, kobereček a potahy polštářů stačí vyměnit a ladění se přenese bez malování. Držte se dvou barev a jednoho vzoru — pokud má obývák vzorované polštáře, v ložnici použijte stejný vzor jen v menším měřítku, třeba na jednom polštáři. Větší množství vzorů vedle sebe působí neklidně a ruší spánek.