REST API v prvním pokusu: kde končí požadavek a začíná odpověď

Šišky, klacky a kameny jako stavebni

U těla odpovědi platí jednoduché pravidlo: formát musí odpovídat tomu, co klient poslal v Accept. Pokud vracíte JSON, držte se jednoho tvaru i pro chyby. Užitečné je posílat strukturu s polem chyb a krátkým popisem, ne jen holý řetězec. U seznamů nezapomeňte na stránkování – parametry pro počet položek a posun. Bez nich první testovací data projdou, ale v ostrém provozu se odpověď nafoukne a klient ji nestihne zpracovat. Stejně tak je vhodné vracet identifikátor nově vytvořeného zdroje, jinak klient neví, co má dál volat.

Nejčastější chyby prvního API nebývají v algoritmu, ale v nepozornosti. Chybějící validace vstupu vede k tomu, že se do databáze uloží nesmysl. Špatně nastavené CORS zablokuje volání z prohlížeče, i když server funguje. Zapomenutý limit velikosti těla požadavku způsobí pád při větším souboru. A příliš mnoho operací v jedné cestě znesnadní jakoukoli změnu. Vyplatí se proto psát malé, předvídatelné endpointy a u každého si předem rozmyslet, co vrátí při úspěchu i při chybě. První funkční API nemusí být dokonalé, ale musí být čitelné – pro vás i pro toho, kdo ho bude volat po vás.

1. Zpevni desku a nastav správnou výšku Stolek, který se při položení knihy kýve, úložné prostory v malém bytě čtení spolehlivě znechutí. Zkontroluj šrouby nohou a dotáhni je, případně podlož pod nerovnou nohu filcovou podložku. Výška desky by měla odpovídat tomu, jak sedíš. Pokud čteš v křesle s nohama na zemi, potřebuješ desku výš, než když ležíš na posteli. Pomůže jednoduchý podstavec z tvrdého dřeva nebo dvě silné knihy, které podložíš pod nohy. Nepřeháněj to — příliš vysoký stolek nutí krčit ramena a po dvaceti minutách bolí za krkem.

Poslední úprava se týká sedu. Čtecí koutek u nočního stolku neznamená sedět na posteli s hlavou u zdi. Přisuň si k posteli nízkou stoličku nebo polštář, o který se opřeš. Kolena měj v pravém úhlu a lokty volně, ne zvednuté. Když po patnácti minutách cítíš tlak v zádech, není chyba ve stolek, ale v poloze. If you liked this article and you would like to get extra info with regards to navštívit stránku kindly take a look at our own web page. Vyzkoušej dvě nebo tři varianty sezení a nech si tu, u které vydržíš celou kapitolu.

Častou chybou je přeplácaný nábytek. Místo velké skříně a komody zvolte jednu vyšší skříň, která využije výšku místnosti. Noční stolky mohou být malé, klidně jen deska upevněná ke zdi. Koberec by měl být světlý a spíše menší, aby nezakrýval celou podlahu. Zbytečně mnoho polštářů a přehozů na posteli působí těžkopádně. Stačí dva polštáře a jednobarevné povlečení. Vzory a potisky na textilu místnost zmenšují, proto je nahraďte jednobarevnými látkami.

Požadavek (request) má vždy několik částí, které se vyplatí kontrolovat v tomto pořadí. Nejdřív metoda a cesta, potom hlavičky, nakonec tělo. V hlavičkách nesmí chybět Content-Type u požadavků, které posílají data, a Accept u těch, které očekávají konkrétní formát. Tělo u GET nemá smysl, i když ho některé nástroje dovolí – server ho obvykle ignoruje a vzniká zmatek. U POST a PUT naopak tělo bez správné hlavičky znamená, že server data nepřečte, i když jsou syntakticky v pořádku. Typická chyba začátečníka je poslat JSON jako text bez uvedení typu obsahu.

První REST API většinou nevzniká z teorie, ale z potřeby něco poslat z jedné aplikace do druhé. Než začnete psát kód, rozhodněte, co je zdroj (resource) a co je operace. Zdroj je věc, se kterou pracujete – uživatel, objednávka, článek. Operace je to, úPrava interiéru co s ní děláte – čtení, vytvoření, úprava interiéru, smazání. V URL proto nemá být sloveso jako „vytvorUzivatele", ale podstatné jméno v množném čísle, například „uzivatele". Metoda HTTP pak nese význam: GET čte, POST vytváří, PUT nebo PATCH mění, DELETE maže. Kdo tohle poplete, ten později narazí na nekonzistentní chování, které se těžko vysvětluje i testerům.

Stavové kódy místo dohadování Odpověď (response) není jen data. Je to také stavový kód, který říká, jak požadavek dopadl. 200 znamená úspěch, 201 vytvoření nového zdroje, 204 smazání nebo úpravu bez vracených dat. Chyby na straně klienta mají 4xx – 400 pro špatný vstup, 401 pro chybějící přihlášení, 403 pro nedostatečné oprávnění, 404 pro neexistující zdroj. Chyby serveru jsou 5xx. Vracet 200 i u chyby je sice lákavé, protože klient „něco dostane", ale nutí ho to parsovat text a hádat. Rozhraní, které rozlišuje stavy poctivě, se ladí výrazně rychleji.

Tuhý šampon si doma vyrobíte ze dvou základních složek: ztužujícího základu a tekuté části, kterou tvoří bylinkový odvar a oleje. Základem bývá kokosový olej s vysokým obsahem laurové kyseliny, případně směs s bambuckým máslem. Tekutou složku tvoří silný odvar z bylin a rostlinné oleje. Poměr se pohybuje kolem 2:1 ve prospěch tuhých tuků, ale přesné množství závisí na teplotě v místnosti. V horku šampon měkne, v chladu tvrdne, proto je lepší držet se osvědčeného poměru a doladit ho podle prvního výsledku.