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

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.

Balte po kategoriích, ne po lidech. Každá krabice dostane číslo, název oddělení a seznam obsahu. Křehké věci označte výrazně a zvlášť. Archivní dokumenty řešte podle zákona a interních pravidel, ne podle toho, co se vejde do auta. Předání nového sídla si nechte písemně potvrdit od pronajímatele i od stěhovací firmy. Fotografujte stav před a po. Ušetří to hádky o poškozenou zeď nebo rozbitý monitor.

Největší problém bývá v prohlížeči. Blokátory reklam, rozšíření na soukromí a režim inkognito umí sledovací cookie zlikvidovat ještě před dokončením objednávky. Stejně tak pomáhá, když máte v prohlížeči přihlášených víc účtů nebo když mezi kliknutím na cashback odkaz a dokončením nákupu uplyne příliš dlouhá doba. Některé obchody mají navíc vlastní pravidla: cashback neuznají, pokud použijete slevový kód z externího zdroje, který není uvedený v jejich podmínkách. Proto se vždy vyplatí přečíst si podmínky cashbacku ještě před kliknutím, ne až po zaplacení.

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.

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.

IT je samostatná kapitola. Servery, telefony, tiskárny a síťové prvky se musí odpojit až po zálohování a označit kabelem i štítkem, kam patří. Naplánujte přepojení na nové adrese ještě předtím, než lidé usednou k počítačům. Typická chyba je, že se stěhuje hardware v pátek a v pondělí se čeká na technika, který má plný diář. Druhá chyba: nikdo neověří, zda nová adresa má dostatečnou kapacitu připojení a zda jsou zásuvky tam, kde mají být.

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.

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.

Prvním krokem je soupis všeho, co se stěhuje. Projděte kancelář místnost po místnosti a udělejte seznam: nábytek, IT vybavení, archiv, kuchyňka, sklad. U každé položky rozhodněte, zda jde do nového sídla, do archivu, k recyklaci, nebo zaměstnanci domů. Tento seznam je základ pro nabídky od stěhovacích firem i pro plán, kolik bude potřeba krabic a fólií. Bez něj se stane, že se platí přeprava věcí, které už nikdo nepoužívá.

Závěsy zavěste co nejvýš, ideálně ke stropu, a nechte je končit až u podlahy. Tyč umístěná nad okenním rámem prodlouží okno a s ním i celou stěnu. Vyhněte se vzorovaným látkám a těžkým závěsům, které pohlcují světlo. Nejvzdušnější variantou jsou světlé látky sahající od stropu k podlaze, případně kombinace se světlou roletou. Stejný princip platí pro barvy: držte se dvou až tří odstínů v jedné škále. Kontrastní pruhy nebo výrazné akcenty na jedné stěně sice upoutají pozornost, ale místnost rozpůlí a opticky zmenší.