5 věcí, které rozhodují při prvním REST API

Prvním rozhodnutím je orientace hlavních obytných místností. Funkcionalismus nestaví dům kolem fasády, ale kolem slunce a výhledu. Ložnice patří na východ, obývací pokoj s velkým oknem na jih nebo jihozápad. Kdo tohle obrátí, bude mít přes den přehřátý obývák a ráno studenou ložnici. Typická chyba je řídit se tím, kde je klidná ulice, a zapomenout, že okna se nedají přesunout dodatečně.

Na co se ptát, než začnete kopat do zd

První REST API vypadá jednoduše: pošleš požadavek a dostaneš odpověď. V praxi ale rozhoduje několik detailů, které se těžko dohledávají ve chvíli, kdy něco nefunguje. If you loved this post and you wish to receive details relating to další informace kindly visit the web-page. Následujících pět oblastí pokrývá většinu problémů, se kterými se při prvním nasazení setkáš.

Tělo odpovědi čti jako data, ne jako text. JSON je formát a jeho struktura se může změnit. Ošetři chybějící pole, null hodnoty a rozdílné typy. Datum může přijít jako řetězec v různých formátech, číslo jako řetězec, pole jako objekt. Nikdy nepředpokládej, že pole vždy dorazí. U stránkovaných odpovědí počítej s tím, že výsledek nemusí být kompletní. Sleduj hlavičky s odkazem na další stránku nebo metadata s celkovým počtem. Pokud je ignoruješ, dostaneš jen první dávku a budeš si myslet, že data chybí.

Kolo musí být co nejmenší, aby dítě dosáhlo oběma nohama na zem, když sedí v sedle. Při seřízení sedla platí, že nohy mají být mírně pokrčené, ne úplně propnuté. Řidítka nastavte výš, aby dítě nemuselo předklánět trup. Brzdy musí být citlivé a snadno dosažitelné malou rukou. Pomocná kolečka sundejte najednou, ne jedno po druhém. Pokud je kolo těžké nebo má příliš velká kola, bude se hůř ovládat. Vyhněte se levným kolům s těžkým rámem, ale i závodním modelům, které jsou pro začátek zbytečně agresivní.

Než začneš psát klientský kód, projdi si jeden požadavek ručně a prohlédni si celou odpověď včetně hlaviček. Zjistíš, co server skutečně vrací, jaké kódy používá a jak vypadá chybová struktura. Teprve pak obal komunikaci do funkcí, přidej timeout, opakování a logování bez citlivých údajů. První REST API není o tom napsat co nejvíc kódu, ale pochopit tok požadavku a odpovědi natolik, abys uměl pojmenovat, kde přesně se něco pokazilo.

Typické chyby při prvním API se opakují. Posílání neplatného JSONu s chybějící uvozovkou nebo čárkou navíc. Záměna 401 a 403. Spoléhání na to, že server vrátí data okamžitě, bez ošetření timeoutu a opakování. Ukládání citlivých údajů do logů. Testování pouze šťastné cesty a ignorování chybových stavů. A nakonec: neošetřené omezení počtu požadavků. Když API vrátí 429, neznamená to, že je rozbité, ale že máš zpomalit.

Pečte při 200 °C prvních deset minut, poté teplotu snižte na 170 °C a pečte dalších dvacet minut. Během pečení troubu neotvírejte, jinak věnečky spadnou. Pokud máte horkovzdušnou troubu, snižte teplotu o 20 °C. Na plech dejte pečicí papír, žádný tuk – těsto se jinak na dně připálí a nedrží tvar.

Předsíň bývá v malých bytech to první místo, kde se hromadí boty, bundy a tašky. Přitom právě tady se dá nejvíc získat. Předsíňová stěna, tedy stěna oddělující vstup od obytné části, nemusí být jen dělicí prvek. Může fungovat jako optický nástroj, který místnost prodlouží, prosvětlí a uklidí. Nejde o to koupit drahý nábytek, ale o to správně pracovat s materiálem, barvou a liniemi.

Metoda, cesta a hlavičky rozhodují před tělem Než začneš řešit, co poslat v těle požadavku, ujasni si metodu a cestu. GET slouží ke čtení, POST k vytvoření, PUT k nahrazení celku, PATCH k částečné změně a DELETE k odstranění. Když pošleš tělo u GET, server ho většinou ignoruje a ty hledáš chybu na špatném místě. Cesta má být podstatné jméno v množném čísle, ne sloveso: místo /getUser použij /users/42. Hlavička Content-Type musí odpovídat tomu, co skutečně posíláš, a Accept říká, co chceš dostat zpět. Když pošleš JSON bez Content-Type: application/json, řada serverů vrátí 400 nebo 415 a ty budeš zmateně kontrolovat tělo, které je přitom v pořádku.

Častá chyba je přeplnění. Malý byt v paneláku láká k tomu cpát do předsíně vše, co se nevejde jinam. Předsíňová stěna pak ztratí funkci a stane se skladištěm. Druhá chyba je tmavá barva na stěně i podlaze současně. Třetí je zrcadlo umístěné naproti vchodovým dveřím – odráží příchozího a působí neklidně. Nejlepší je zrcadlo na boční stěně, kde vede pohled do hloubky bytu.
Stavové kódy nejsou kosmetika. 200 znamená úspěch, 201 vytvoření, 204 úspěch bez těla, 400 chyba na straně požadavku, 401 chybějící nebo neplatná autentizace, 403 nedostatečné oprávnění, 404 nenalezeno, Https://Wiki.Novaverseonline.Com/Index.Php/Když_Se_RáNo_BudíTe_Unavení,_ZařIďTe_LožNici_Jinak 409 konflikt, 422 sémantická chyba a 500 chyba serveru. Když API vrací 200 i u chyby a teprve v těle uvede, že se něco nepovedlo, nutí tě parsovat každou odpověď a rozlišovat úspěch podle obsahu. To je častý zdroj chyb v klientském kódu.