Nakonec počítejte s tím, že první jízda bez koleček nebude rovná ani dlouhá. Stačí pár metrů a dítě samo zastaví. To je úspěch. Pochvalte ho za to, co zvládlo, ne za to, co ještě ne. Když se po několika pokusech vzteká nebo pláče, dejte kolu na týden pokoj a vraťte se k odrážedlu bez pedálů. Nátlak připravenost nezrychlí, jen ji oddálí.
Nejčastější chyba začátečníka je záměna PUT a PATCH. PUT očekává kompletní reprezentaci zdroje – pokud pošlete jen jedno pole, ostatní se mohou smazat nebo přepsat na výchozí hodnoty. PATCH posílá jen změnu. Další častá chyba je zapomenutá hlavička Content-Type. Server bez ní neví, jak tělo interpretovat, a vrátí chybu 415 nebo data uloží špatně. U GET požadavků zase lidé posílají tělo, což řada serverů ignoruje nebo odmítne. Tělo patří k POST, PUT a PATCH, výjimečně k DELETE, ale rozhodně ne k GET.
První REST API v praxi začíná ve chvíli, kdy odešlete HTTP požadavek a čekáte, co se vrátí. Většina lidí si myslí, že stačí zadat adresu a dostat data. Jenže odpověď není magie – je to výsledek toho, jak přesně jste požadavek sestavili. Než začnete psát jakýkoli klientský kód, ujasněte si čtyři věci: metodu, cestu, hlavičky a tělo. Metoda určuje, co chcete udělat (GET čte, POST vytváří, PUT nahrazuje, PATCH mění část, DELETE maže). Cesta určuje, s jakým zdrojem pracujete. Hlavičky nesou metadata – například typ obsahu nebo autorizaci. Tělo posílá data jen u metod, které je mají smysl posílat.
Podle typu řeky volte i vztlak. Na klidné vodě stačí vesta s nižším vztlakem, která je pohodlnější a lépe se v ní vesluje. Na divoké vodě potřebujete vyšší vztlak a pevný límec, který drží hlavu nad vodou, i když jste unavení. Vesta by měla mít také pevné poutko pro uchycení na laně a odrazky nebo výraznou barvu, abyste byli vidět. Před nasazením zkontrolujte, jestli popruhy nejsou popraskané a přezky nezrezlé. Vypůjčené vybavení vždy prohlédněte, i když vypadá dobře.
Co dělat, když dásně krvácí a jídlo se zasekáv
Jablka nakrájejte na menší kousky a vložte do mixéru. Přidejte lžíci vody nebo čerstvě vymačkané citronové šťávy, která zpomalí hnědnutí. Mixujte krátce, jen do hladka – příliš dlouhé mixování zbytečně zahřívá směs a může zničit vitaminy. Pokud chcete hustší konzistenci, použijte méně tekutiny, pro řídkou přesnídávku naopak přidejte trochu převařené a vychladlé vody.
Většina lidí, kteří s lezením na umělé stěně skončí po prvním pokusu, neodejde kvůli tomu, že by je nebavilo lézt. Odejdou proto, že si prvních třicet minut spálili na něčem, co se dalo snadno vynechat. Než vyrazíte, srovnejte si v hlavě, co vlastně chcete: vylézt jednu cestu nahoru, nebo se naučit základy. Na první návštěvu stačí to druhé.
Jakmile máte funkční požadavek, otestujte ho opakovaně se stejnými vstupy. Zjistíte, zda je odpověď konzistentní a zda se data nemění mezi voláními. Potom přidejte ošetření chyb: časové limity, opakování požadavku při dočasné chybě a logování stavových kódů. Vyhněte se ukládání citlivých údajů do adresy URL – mohou skončit v protokolech. Autorizaci posílejte v hlavičce, ne v parametrech. A především: dokumentujte si, co který endpoint očekává a vrací. Bez toho se při dalším požadavku ztratíte.
Při ladění si vždy nejdřív prohlédněte stavový kód a hlavičky, teprve pak tělo. Tělo může být prázdné i u úspěšné odpovědi – například u DELETE se často vrací 204 No Content. Pokud server vrací data ve formátu JSON, ověřte, že odpovídá schématu. Chybějící povinné pole poznáte až při zpracování, což bývá pozdě. U větších odpovědí se vyplatí stránkování – parametr pro stránku a velikost stránky. Bez něj můžete stáhnout tisíce záznamů a zablokovat klienta i server.
Co se děje mezi odesláním a odpovědí Po odeslání požadavku putuje text po síti na server. Server ho přijme, přečte metodu a cestu, najde příslušný endpoint a předá řízení obslužnému kódu. Ten zkontroluje hlavičky, ověří oprávnění, případně přečte tělo, provede operaci s databází nebo jinou službou a sestaví odpověď. Odpověď má vždy stavový kód, hlavičky a volitelné tělo. Stavové kódy 2xx znamenají úspěch, 3xx přesměrování, 4xx chybu na straně klienta, 5xx chybu serveru. Zapamatujte si, že 404 neznamená jen „stránka nenalezena”, ale „zdroj na této cestě neexistuje”. 401 znamená, že chybí nebo je neplatná autentizace. 403 znamená, že jste přihlášeni, ale nemáte oprávnění.
