REST API: co se stane mezi odesláním a přijetím dat

Světlo řešte předem. Malá noční lampička u postele stačí, ale nesmí svítit přímo do očí. Zkontrolujte, jestli žaluzie nebo závěsy skutečně zatmí pokoj – byt v paneláku létě se rozednívá brzy a děti se budí s prvním světlem. Teplota v místnosti má být kolem dvaceti stupňů. Přetopený pokoj je častější chyba než zima, protože rodiče přitápějí, aby hostovi nebylo chladno.

Požadavek má vždy tři části, na kterých záleží: metodu, cestu a hlavičky. If you cherished this short article and you would like to obtain a lot more information concerning odkaz kindly take a look at the web site. Metoda říká, co chcete udělat — GET čte, POST vytváří, PUT nahrazuje, PATCH mění část, DELETE maže. Cesta určuje, se kterým zdrojem pracujete, a hlavičky nesou metadata. Nejčastější chyba je posílat data pro čtení v těle požadavku u GET. Tělo patří k POST, PUT a PATCH, nikdy ne k GET nebo DELETE. Server, který to ignoruje, se chová nepředvídatelně.

Přírodní pektin v broskvích není rovnoměrně rozložený. Nejvíce ho je v blízkosti pecky a v mírně nezralých plodech. Proto vybírejte broskve, které jsou zralé, ale ještě pevné. Příliš měkké a přezrálé plody mají pektinu málo a také více vody. Tu je pak potřeba odpařit, dokončení interiéru což znamená delší vaření a tmavší barvu džemu. Pokud máte jen velmi zralé broskve, přidejte jednu menší nezralou broskev nebo trochu jablečného pyré – jablka jsou na pektin bohatá a chuť broskví to nenaruší.

Věnečky, které po upečení drží tvar a zůstanou křehké i po naplnění, stojí na dvou věcech: správně odpařeném těstu a dokonalém vysušení. Odpalované těsto není složité, ale nesnese improvizaci v poměrech a teplotě. Základem je přesně odvážená mouka, voda, tuk a vejce. Pokud přidáte vejce „od oka", těsto může být řídké, věnečky se roztečou, nebo naopak tuhé a uvnitř vlhké. Proto používejte kuchyňskou váhu a vejce přidávejte postupně, dokud těsto neudrží na stěrce dlouhý, lesklý cíp, který se ohne, ale neodtrhne.

Po instalaci udělejte test: zatáhněte za horní roh regálu směrem k sobě, ale silou, jakou dokáže vyvinout batole. Pokud se nábytek pohne nebo zavrže, kotvení povolte a zopakujte. Jednou za čas zkontrolujte, zda se šrouby nepovolily – zejména v panelácích, kde se dům sezónně pohybuje. A pamatujte, že žádná police není bezpečná, pokud na ni dítě vidí a chce na ni dosáhnout. Lepší než spoléhat na kotvy je nabídnout dětem nízké otevřené boxy, kam si samy dosáhnou.

Největší past na konci je autentizace. Neposílejte heslo v každém požadavku a nikdy ho nedávejte do adresy. Token patří do hlavičky a server ho musí ověřit dřív, než sáhne do databáze. Stejně tak nastavte limity na velikost těla a počet požadavků, jinak se z prvního experimentu stane snadný cíl. Když tyto základy dodržíte, další endpointy přidáte bez přepisování toho, co už běží.

Před nasazením si požadavky projděte ručně. Odešlete neplatný vstup, příliš dlouhý řetězec, chybějící hlavičku i neexistující identifikátor. Sledujte, co server vrátí, a hlavně jestli se v logu objeví srozumitelná informace. Právě tady se láme rozdíl mezi API, které někdo použije, a API, které skončí v koši. Testy pište na chování, ne na implementaci, aby přežily refaktoring.

Stavové kódy nejsou dekorace Odpověď začíná stavovým kódem a ten musí odpovídat realitě. Vracet 200 i při chybě je nejrozšířenější začátečnická chyba, protože klient nemá jak poznat, že se něco pokazilo. Používejte 201 po vytvoření, 204 po smazání bez obsahu, 400 pro špatný vstup, 404 pro neexistující zdroj, 409 pro konflikt a 500 jen pro skutečnou chybu na serveru. Pokud posíláte chybu, přiložte tělo s jednoznačným kódem a popisem. Klient pak nemusí hádat, co se stalo.

Pečte při střední teplotě, kolem 160 až 170 stupňů, krátce. Cukroví je hotové ve chvíli, kdy okraje začnou zlátnout, ale střed zůstává světlý. Nechte ho dvě minuty na plechu, teprve pak přendejte na mřížku. Horké cukroví je mimořádně lámavé a při manipulaci se láme. Pokud se vám i tak drobí, přidejte do příštího těsta lžíci mletých ořechů nebo škrobové moučky, která pojí bez tuhnutí.

Postavit první funkční REST API znamená pochopit, co se děje mezi okamžikem, kdy klient odešle požadavek, a chvílí, kdy dorazí odpověď. Většina začátečníků přeskočí tuto část a rovnou sahá po frameworku. Výsledek bývá stejný: aplikace funguje, ale jakákoli chyba je nečitelná a ladění zabere celý den. Začněte od protokolu HTTP, protože ten určuje byt v panelákušechna pravidla hry.

Tělo odpovědi držte konzistentní. Ať už vracíte jeden objekt nebo seznam, struktura má být předvídatelná. Datum posílejte v jednom formátu, obvykle s časovým pásmem. Čísla neposílejte jako řetězce, jinak si klient musí domýšlet typ. U seznamů řešte stránkování dřív, než data narostou — kurzor nebo limit s offsetem, ale vždy se stejným chováním. Zmatek vzniká ve chvíli, kdy jeden endpoint vrací pole a druhý obal s klíčem data. Vyberte si jednu podobu a držte se jí.