5 kroků, jak poslat první REST požadavek a rozumět odpovědi

Pracovní osvětlení pod skříňkami volte s krytím proti páře a mastnotě. Stačí úzký pás, který osvětlí desku rovnoměrně, ne ostrý kužel. Pokud máte skříňky až ke stropu, nepřidávejte další světlo nad ně, jen byste osvětlili prázdný prostor. Důležitá je barva světla: teple bílé kolem 3000 K působí v kuchyni přirozeně, studené bílé nad 5000 K dělá prostor chladným a menším, i když je technicky jasnější.

Jakmile ruční požadavek projde, přepiš ho do kódu. Většina jazyků má HTTP klienta, který za tebe sestaví spojení i hlavičky. Nastav timeout, ošetři chybové stavy podle stavového kódu a loguj celou odpověď při selhání. Nezapomeň, že REST je bezstavový — každý požadavek musí nést všechny potřebné informace, žádné spoléhání na předchozí volání. Když tohle dodržíš, první funkční volání bude hotové a další endpointy přidáš podle stejného vzoru.

Uzavírání je druhé rozhodnutí, které uděláš. Suchý zip se snadno nazouvá i zouvá a dobře se utahuje, proto se hodí pro první výstup. Šňůrky drží pevněji a lépe se přizpůsobí tvaru chodidla, ale jejich vázání zdržuje. Guma bez zapínání je nejrychlejší, ovšem méně odpouští špatnou velikost. Pro začátek je suchý zip nejrozumnější volbou: nastavíš ho přesně a neztratíš čas při střídání cest.

U úložného prostoru rozhoduje hloubka, ne šířka. Standardní skříň má hloubku přes půl metru, což u šikminy znamená, že horní hrana narazí do stěny dřív, než využijete dno. Řešením jsou skříně s hloubkou kolem čtyřiceti centimetrů, nebo vestavné police zasunuté do nejnižší části. Zásuvky pod šikminou volte nízké a široké, ne vysoké a úzké – do vysoké zásuvky se při otevírání nevejdou dveře. Police kotvěte do nosné konstrukce, ne jen do sádrokartonu; šikmá stěna často vede izolaci a kotva v ní nedrží. Když si nejste jistí, použijte chemickou kotvu nebo konzoly vedené do stropu.

Noční stolek nemusí být jen krychle u postele. Zvolte úzký model s výškou odpovídající matraci, nebo ho nahraďte policí připevněnou ke zdi. Vejde se na ni lampa, sklenice s vodou a kniha. Pod ní může být otevřený prostor na koš nebo přenosný koš s prádlem. Jestli stojíte o další úložiště, použijte prostor mezi postelí a stěnou – tenký regál do patnácti centimetrů tam projde a nezabere místo na chodbu.

Praktický postup je opakovatelný: odešli požadavek, zkontroluj stavový kód, přečti hlavičky, teprve pak parsuj tělo. Když něco nefunguje, nehádej — vypiš si celou odpověď včetně hlaviček. Často zjistíš, že problém je v chybějícím tokenu, překlepu v cestě nebo v tom, že server očekává jiný formát data. U POST a PUT nezapomeň, že tělo musí být platný JSON: chybějící uvozovky, čárka navíc nebo neescapovaný znak shodí celý požadavek.

Mezi časté chyby patří také záměna metod. GET nemá měnit data, POST vytváří, PUT nahrazuje, PATCH částečně upravuje a DELETE maže. Pokud pošleš GET tam, kde server čeká POST, dostaneš 405. Další pastí je práce s kódováním — diakritika v URL musí být procentně zakódovaná, jinak se cesta rozpadne. A pozor na autentizaci: token patří do hlavičky Authorization, ne do těla ani do parametrů v URL, kde ho může zachytit log.

Než začneš psát jakýkoli klientský kód, potřebuješ vědět, na jakou adresu a jakou metodou se ptát. REST API komunikuje přes HTTP, takže první požadavek sestavíš ručně v terminálu pomocí nástroje curl. Základní tvar je jednoduchý: zvol metodu (GET pro čtení, POST pro vytvoření), přidej hlavičku s typem obsahu a za lomítko doplň cestu ke zdroji. Pokud posíláš data, přilož je jako tělo požadavku ve formátu JSON. Vynechání hlavičky Content-Type je nejčastější začátečnická chyba — server pak tělo nepochopí a vrátí chybu, i když data vypadají správně.

Co se skutečně děje mezi odesláním a odpovědí Server požadavek přijme, přečte metodu, cestu a hlavičky, ověří oprávnění a teprve pak sáhne po datech. Odpověď má vždy stavový kód, hlavičky a volitelné tělo. Stavové kódy čti jako první informaci: 2xx znamená úspěch, 4xx chybu na straně klienta (špatný požadavek, chybějící autentizace, neexistující zdroj), 5xx selhání serveru. Tělo odpovědi bývá JSON, ale není to pravidlo — vždy se podívej na hlavičku Content-Type. Pokud ji ignoruješ a parsuješ odpověď naslepo, narazíš na chybu při první změně na straně serveru.

Přes den hrozí jiný typ ztrát. Jestřáb útočí shora a slepice na otevřeném prostranství nemá kam utéct. Pomůže kryté výběhy, přístřešky, keře a vysoká tráva, které ptákům dají možnost ukrýt se během několika vteřin. Volně pobíhající hejno bez krytu je pro dravce snadný cíl a žádný strašák to nevyřeší. Odpadají i krmítka daleko od kurníku, která soustředí ptáky na jednom předvídatelném místě.