Jak těsto zpracovat, aby se netrh
Pánev musí být opravdu horká, než na ni dáte první těsto. Tuk by měl být ve vrstvě asi 3–4 mm, ne více. Optimální teplota je kolem 170–180 °C – když na povrch kápnete trochu těsta, musí okamžitě zasyčet, ale nezhnědnout během pár sekund. Těsto na pánev rozetřete tence, maximálně do tloušťky 5 mm. Silná vrstva se uvnitř uvaří, ale tuk zůstane na povrchu. Během smažení placku neobracejte více než jednou. Každé další otáčení znamená, že se do těsta vsákne další tuk.
Nakonec počítejte s tím, že síť není spolehlivá. Požadavek může odejít, ale odpověď se ztratit. U operací, které mění data, proto používejte idempotentní metody tam, kde to jde, a opakování řešte opatrně. Jakmile pochopíte tok požadavek–odpověď, přestanete hádat a začnete cíleně opravovat to, co skutečně selhalo.
Když poprvé voláte REST API, nejčastější chyba není v kódu, ale v představě, že server něco „udělá” a hned vrátí výsledek. Ve skutečnosti jde o výměnu dvou zpráv: požadavku a odpovědi. Požadavek má vždy metodu (GET, POST, PUT, DELETE), adresu koncového bodu, hlavičky a někdy tělo. Odpověď má stavový kód, hlavičky a tělo. Pokud si tohle rozložíte, přestane být API magie.
Nejčastější chyba je přidání pistáciové pasty do příliš tuhého základu. Pasta se nevmíchá, jen se rozmázne po stěnách mísy. Řešení je jednoduché: nejdřív pastu nařeďte dvěma lžícemi měkkého másla nebo smetany a teprve tuto směs zapracujte do zbytku. Stejně tak nepřidávejte žádnou tekutinu naráz. Vždy po lžících a po každé míchejte do úplného spojení.
Praktický postup je jednoduchý. Nejprve pošlete požadavek bez autentizace a podívejte se, co server vrátí. Potom přidejte token. Pak teprve řešte tělo a parametry. U každé chyby si uložte celou odpověď včetně hlaviček, protože obsahují informace o limitu požadavků nebo o tom, co server očekával. Nikdy netvrďte, že „API nefunguje”, dokud nemáte konkrétní kód a text odpovědi.
Začněte tím, že si požadavek sestavíte ručně v terminálu nebo v nástroji pro testování. Metoda GET obvykle nese parametry v adrese, třeba filtr nebo stránkování. POST, PUT a PATCH posílají data v těle, nejčastěji ve formátu JSON. Do hlaviček patří Content-Type: application/json a podle potřeby Authorization s tokenem. Bez správné hlavičky server tělo ignoruje nebo vrátí chybu 415. První praktický krok tedy je: ověřit, že odesíláte přesně to, co server očekává.
Světlo, zvuk a teplota rozhodují víc než výzdo
Tělo odpovědi čtěte vždy až po kontrole stavového kódu. Server může vrátit HTML chybovou stránku místo JSON, a pokud ji slepě parsujete, dostanete nesrozumitelnou výjimku. Ošetřete i prázdné tělo — u DELETE nebo u odpovědi 204 žádný obsah nepřijde. Dále si hlídejte, zda server vrací data v obálce (např. klíč data) nebo přímo pole. Záměna těchto dvou tvarů je častý zdroj chyb při zpracování.
Stavové kódy nejsou dekorace Odpověď začíná číslem. 2xx znamená úspěch, 4xx chybu na straně klienta, 5xx chybu serveru. Typické chyby začátečníka: ignorovat 201 při vytvoření nového záznamu a čekat 200, nebo zaměňovat 401 (neautentizován) a 403 (nemá oprávnění). Když dostanete 400, problém je skoro vždy v těle požadavku — neplatný JSON, chybějící povinné pole, špatný datový typ. Při 404 zkontrolujte adresu, při 429 zpomalte, tedy přestaňte posílat další požadavky.
Křehké štrúdlové těsto nestojí na drahém másle ani na speciální mouce z obchodu. Rozhoduje poměr tuku, mouky a tekutiny a hlavně to, jak s těstem zacházíte. Domácí mouka jemně mletá nebo hrubší má jinou savost než ta kupovaná, proto se vždycky dívejte na konzistenci, ne na přesné gramy v receptu.
- ID: 403701
Be the first to review “REST API v praxi: co se stane mezi odesláním a odpovědí”
Reviews
There are no reviews yet.