Osvětlení dělá víc než nábytek. Jedno stropní světlo nad prostředkem kuchyně nestačí. Přidejte bodovku pod horní skříňky nad pracovní desku. Stačí jedna nebo dvě, ale musí svítit přímo na desku, ne do očí. Podsvícení se dá řešit páskem nalepeným ze spodní strany skříňky, napájeným ze zásuvky u linky.
Listové těsto je suché, lístkové, s výraznou máslovou chutí. Potřebuje krém jemný, ale ne příliš sladký, aby suchost těsta vyrovnal. Ideální je šlehačka s vanilkou, lehký žloutkový krém nebo tvaroh se smetanou. Naopak tmavé čokoládové krémy listové těsto přebijí a zákusek pak chutná jen po kakaové hmotě. U listového těsta platí, že krém se nanáší až těsně před podáváním, jinak vlhkost pronikne do vrstev a těsto ztratí křupavost.
Helma musí sedět na suché i na mokré hlavě. Zkoušejte ji s čepicí nebo tenkou neoprenovou kuklou, pokud s nimi budete plout. Utáhněte pásek tak, aby se helma při předklonu a záklonu hlavy neposunula, ale netlačila na spánky. Prostor mezi čelem a okrajem helmy má být minimální, jinak při nárazu do kamene hlava uvnitř „ujede” a náraz pohltí lebka, ne helma. Typická chyba je koupit helmu o číslo větší „kvůli pohodlí” – ve vodě pak plave a při pádu nesedí. Na divoké vodě s peřejemi volte pevnější skořepinu s krytím uší a zadní části hlavy; na klidných úsecích stačí lehčí odvětraný model, ale stále s pevným upínáním.
Při ladění si nejdřív ověřte, co skutečně odešlo ze serveru, ne co si myslíte, že odeslat měl. Logujte celý požadavek i odpověď včetně stavového kódu, ale nikdy nelogujte hesla ani tokeny. Testujte i chybové stavy: co se stane při výpadku databáze, při neplatném typu v JSONu, při příliš dlouhém řetězci. Právě tam se rozdíl mezi funkčním a spolehlivým API projeví nejvíc.
První vlastní REST API obvykle vypadá jako jednoduchý požadavek a ještě jednodušší odpověď. Jenže právě mezi nimi vzniká většina chyb, které se špatně hledají. Klient pošle data, server je nedostane v takové podobě, jakou čeká, a místo odpovědi přijde chybový kód, kterému nikdo nerozumí. Vyplatí se proto začít od místa, kde se požadavek skutečně rodí — od hlaviček a těla zprávy.
Svislé ukládání místo hromad na ze
Stavové kódy a tělo odpovědi, které mate klienta Nejčastější začátečnická chyba je vracet kód 200 i u chyby. Klient pak čte tělo, hledá v něm pole s výsledkem a narazí na něco úplně jiného. Rozlišujte situace: 400 pro neplatný vstup, 401 pro chybějící přihlášení, 404 pro neexistující zdroj, 500 pro selhání serveru. Kód nese informaci sám o sobě a tělo odpovědi má jen doplnit detail. Pokud posíláte chybu, držte se jednoho tvaru — například objekt s polem pro kód a popis. Rozdílné struktury u různých chyb zbytečně komplikují zpracování na straně klienta.
Odpověď by měla být čitelná i pro člověka, který API testuje ručně. To znamená vracet data konzistentně: stejné názvy polí, stejný typ hodnot, žádné null tam, kde má být prázdné pole. Datum posílejte v jednom formátu, ideálně včetně časového pásma. Nepleťte si význam prázdné hodnoty a chybějícího klíče — klient pak neví, zda má data považovat za nevyplněná, nebo za chybná.
Základní pravidlo zní: server nikdy nevěří tomu, co mu klient pošle. Pokud posíláte data ve formátu JSON, musí být v hlavičce Content-Type uvedeno application/json. Bez toho řada frameworků tělo požadavku vůbec nepřečte a vrátí chybu, i když je obsah syntakticky správně. Stejně tak je nutné ošetřit prázdné tělo, příliš velký payload a neplatné znaky. Kontrola vstupu není formalita, ale první místo, kde se dá předejít pádu celé služby.
Pult, police a výdejní okén
- ID: 447336
Be the first to review “První REST API: kde se ztrácí odpověď a proč”
Reviews
There are no reviews yet.