REST API v praxi: co se stane mezi odesláním a odpovědí

Začněte tím, že si v obýváku vyfotíte tři až čtyři konkrétní barevné plochy za denního světla. Nemyslím celkový dojem, ale skutečné vzorky: odstín stěny, barvu potahu, tón dřeva, barvu doplňku. Fotky si vytiskněte nebo otevřete na tabletu přímo v ložnici. Uvidíte, že stejná barva vypadá v jiném osvětlení jinak. To je první past – přenést přesnou barvu z jednoho prostoru do druhého téměř nikdy nefunguje, protože ložnice má obvykle menší okna a jiný směr světla.

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í.

Na závěr: předěláte-li předsíň tak, že světlo bude dopadat na světlé plochy a odrážet se od velkého zrcadla, získáte opticky několik desítek centimetrů navíc. Nepotřebujete k tomu stavební úpravy ani drahé vybavení. Stačí odstranit tmavé plochy, přidat jedno velké zrcadlo a zbavit se předmětů, které tam nemají co dělat.

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.

Základ je jednoduchý: na 500 g mouky dejte 250 g tuku (máslo, sádlo nebo jejich směs), 1 vejce, 2 lžíce octa, 150 ml studené vody a špetku soli. Ocet není kvůli chuti, ale kvůli lepku – těsto pak zůstane tažné a při válcování se netrhá. Tuk musí být studený, ale ne zmrzlý. Tvrdý kus másla se do mouky jen obtížně zapracovává a těsto se drolí.

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.

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.

Zkontrolujte také, zda má mobil povolený Bluetooth a zda není zapnutý režim letadla nebo úsporný režim, který připojení blokuje. U některých telefonů je potřeba povolit aplikaci Bluetooth přístup k poloze, jinak párování selže. Pokud máte v mobilu uložených mnoho starých zařízení, promažte seznam. Někdy pomůže i aktualizace systému, protože starší verze mohou mít chybu v ovladači Bluetooth.

Čtvrtým prvkem je textil a výplně. Materiál by měl být prodyšný a bez ostrých hran v místech, kde se dítě dotýká. Odnímatelné a pratelné potahy nejsou jen otázka hygieny – umožňují zkontrolovat, zda pod nimi nejsou uvolněné šrouby nebo prasklé plasty. Pátým prvkem je reflexní označení. Kočárek musí mít odrazky na bocích i na zadní straně, ideálně v barvě, která je vidět za šera. Běžná chyba je koupit kočárek v tmavé barvě bez reflexů a řešit to až dodatečným lepením pásků, které se časem odlepí.

Nejčastější příčinou je, že sluchátka jsou stále připojená k jinému zařízení. Bluetooth umí držet spojení jen s jedním zdrojem zvuku. Pokud jste je naposledy používali s notebookem, tabletem nebo starým telefonem, mohou se k němu automaticky hlásit, jakmile se dostanou do dosahu. Vypněte Bluetooth na všech ostatních zařízeních v okolí, případně je úplně odpojte v jejich nastavení. Teprve pak zkuste spárování znovu. Toto je chyba, kterou lidé přehlédnou nejčastěji, protože se na novém mobilu „nic neděje".

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á.