5 věcí, které rozhodují o první odpovědi z API

Na závěr si připravte krátké vyhodnocení. Děti ocení, když si mohou projít trasu znovu a ukázat, co našly. Můžete je nechat vymyslet vlastní šifru pro příště – tím se z pasivní hry stane tvoření. Pokud hru opakujete, obměňte šifry i trasy, aby děti nepamatovaly řešení zpaměti. A hlavně: udělejte si poznámky, co fungovalo a co ne. Příští příprava pak zabere polovinu času.

Zrcadlo i světlo musí ladit s povrchem stěn. Lesklá stěna za zrcadlem vytváří dvojitý odraz a prostor se rozpadá. Matná nebo polomatná barva odraz zklidní. Zrcadlo naopak nepatří na tmavou stěnu bez přesahu – jeho rám by měl být tenký nebo stejný jako barva stěny, aby se odraz spojil s okolím a nevypadal jako obraz. U velkého zrcadla počítej s tím, že odráží i to, co v předsíni nechceš vidět: kabely, krabice, neuklizené boty. Buď je schovej, nebo zrcadlo namiř jinam.

Horní světlo nechte na stropě, ale ne jako jediný zdroj. Vyberte svítidlo, které světlo rozptyluje do stran, ne přímo dolů. Pokud strop není vysoký, zapuštěné bodovky vypadají lépe než velké závěsné lustry, které ubírají prostor. Rozmístěte je tak, aby osvětlily i rohy – právě tmavé rohy kuchyni zmenšují nejvíc. Pomůže i světlý nátěr stropu a stěn, protože odráží světlo dál do místnosti. Tmavá barva na zdi za linkou pohlcuje světlo a místnost se opticky uzavře.

Stavové kódy a tělo odpovědi jako společná informace Stavový kód sám o sobě nestačí. Dvojka znamená úspěch, ale i tehdy může být v těle odpovědi prázdné pole nebo chybová zpráva. Čtyřka ukazuje na problém na straně klienta, pětka na stranu serveru. Než začneš hledat chybu v kódu, přečti si tělo odpovědi. Servery do něj často vkládají konkrétní pole, která selhala, a důvod. Bez tohoto čtení budeš hádat, která hodnota je špatně.

Autentizace bývá druhou nejčastější příčinou neúspěchu. Token se posílá v hlavičce Authorization, obvykle ve formátu Bearer a hodnota. Zkontroluj, zda token nevypršel a zda ho posíláš u každého požadavku, který ho vyžaduje. U veřejných endpointů naopak hlavičku neposílej, některé servery ji odmítnou. Pokud používáš API klíč, ověř, zda patří do hlavičky nebo do parametru v adrese. Záměna těchto dvou míst je častá a chyba se neoprávněný přístup.

Proč přesnídávka hnědne a jak zařídit malou kuchyni tomu zabránit Po nakrojení jablko oxiduje a během několika minut ztrácí světlou barvu i část vitaminu C. Řešením není citronová šťáva v hrnku, ale pár kapek na kusy jablek ještě před mixováním. Stačí doslova několik kapek na dvě střední jablka. Další chybou je mixování za vysokých otáček příliš dlouho. Vyšší teplota z nožů urychlí oxidaci a přesnídávka zhnědne i s citronem. Mixujte krátce, v pulsech, dokud směs není hladká, ale ne déle.

Při ladění si zapisuj celý požadavek i odpověď, včetně hlaviček. Bez toho neuvidíš, co se skutečně odeslalo. Nástroje pro vývojáře v prohlížeči nebo jednoduchý HTTP klient stačí. Pokud pracuješ v kódu, použij logování na úrovni, kterou později snadno vypneš. Vyhni se vypisování citlivých údajů, jako jsou tokeny a hesla. Ty se do logů nepatří.

První REST API vypadá jednoduše: pošleš požadavek, dostaneš odpověď. V praxi se ale většina času ztratí na detailech, které se v tutoriálech vynechávají. Následující řádky popisují, co se skutečně děje mezi odesláním requestu a zpracováním response, a na co si dát pozor, aby ladění netrvalo celý den.

Konzistenci upravte podle věku dítěte. Pro batole stačí jemně rozmixovaná hmota, pro starší dítě ji nechte lehce hrubší, aby si zvykalo na kousky. Pokud je přesnídávka příliš hustá, přidejte lžíci převařené vody nebo neslazeného jablečného džusu, ne mléka — to se s kyselinou z jablek může srazit. Naopak příliš řídkou směs zahušťujte nastrouhaným jablkem, ne cukrem ani sušenkami.

Poslední věc, kterou si ohlídej, je opakování požadavku. Síť může selhat a odpověď nedorazit. Automatické opakování bez rozmyslu ale u operací, které mění data, vytvoří duplicity. U požadavků na vytvoření záznamu použij idempotentní klíč nebo nejprve zkontroluj, zda už záznam neexistuje. U čtení můžeš opakovat bez obav. Rozdíl mezi bezpečnými a měnícími operacemi je základ, který se vyplatí mít v hlavě od prvního requestu.

Začni tím, že si požadavek prohlédneš ještě před odesláním. Metoda, cesta, hlavičky a tělo musí odpovídat tomu, co server očekává. Typická chyba je odeslání dat jako prostý text, zatímco API čeká JSON. Nastav hlavičku Content-Type na application/json a tělo zabal do platného JSON. Pokud posíláš dotazovací parametry, dej pozor na jejich kódování. Mezera v hodnotě parametru se bez zakódování změní na + nebo se ztratí, což server vyhodnotí jako chybějící vstup.