Nakonec ošetřete chyby sítě. Požadavek může selhat na timeoutu, výpadku připojení nebo neplatném certifikátu. V produkci nastavte rozumný timeout a opakování jen u bezpečných metod, jako je GET. U POST opakování bez kontroly může vytvořit duplicitní záznam. Vždy logujte celý požadavek i odpověď bez citlivých údajů, abyste při ladění věděli, co se přesně poslalo. První REST API v praxi není o teorii, ale o trpělivém čtení toho, co server skutečně vrací.
Typ řeky určuje, co od helmy a vesty skutečně potřebujete. Na široké řece s peřejemi třetího stupně stačí lehká open-cell vesty a pevná helma, ale na úzkém korytě s podvodními kameny a sifony je to jinak. Rozhoduje objem plavení, teplota vody, charakter dna a to, zda pojedete na raftech nebo na nafukovacích kanoích. Než začnete vybírat, zjistěte konkrétní úsek: průtok, obtížnost a přístupnost břehů. Právě tam se láme rozdíl mezi bezpečnou jízdou a zbytečným rizikem.
Když se na konci září začnou větve ohýbat pod tíhou plodů, je čas rozhodnout, co s úrodou. Tři věci se dají zvládnout během jednoho odpoledne a nemusíte mít lis ani sušičku. Stačí hrnec, síto, pár sklenic a chuť experimentovat. Jablka, která padají na zem, nejsou na nic — právě z nich bývá nejsladší šťáva.
Na co si dát pozor při výběru termínu a dodavate
Ideální je krátká lekce několikrát týdně, vždy končit dřív, než přijde únava nebo vztek. Pokud dítě po deseti minutách odmítá pokračovat, skonči. Nenuť ho. Pokud se bojí, zkus jiný den a jiné místo. Někdy pomůže mírný svah, kde kolo jede samo a dítě se soustředí jen na rovnováhu. Naopak prudký kopec dolů je nejhorší volba, protože dítě nabere rychlost, kterou neumí zastavit.
Začněte vždy testovacím nástrojem, ne rovnou aplikací. Odešlete ručně GET na adresu, která vrací seznam položek. Sledujte stavový kód: 200 znamená úspěch, 201 vznik nového záznamu, 204 smazání bez těla odpovědi. U 4xx je chyba na straně klienta, u 5xx na straně serveru. Teprve když vidíte, jak vypadá správná odpověď, přeneste stejný požadavek do svého programu. Tím odlišíte problém v datech od problému v síti.
Prvním krokem je změřit šířku i hloubku prostoru a teprve pak hledat desku. Hloubka menší než půl metru nutí k nakloněné rovině nebo k úzké desce, na kterou se nevejde klávesnice i myš vedle sebe. Druhou chybou bývá deska příliš vysoko, protože se počítá s místem na nohy, které ve vertikálním řešení vůbec nepotřebuješ. Úzká deska nad sebou snese skříňky, police i věšák, ale musíš nechat prostor pro kabely a větrání notebooku. Když desku umístíš příliš blízko stropu, nebudeš mít kam dát lampu ani kam odložit hrnek.
U helmy sledujte především tvar a uchycení, ne barvu. Musí sedět nízko nad čelem, nesmí se posouvat při prudkém otočení hlavy a musí krýt spánky i týl. Na kamenitých řekách s mělkou vodou se vyplatí celoobličejový kryt nebo alespoň výrazný štítek proti větvím. Naopak na širokých, hlubokých tocích s dlouhými válci je lepší lehká helma s dobrým odvětráním, protože ji budete mít na hlavě několik hodin. Vždy zkuste helmu s mokrou hlavou nebo s čepicí, kterou plánujete nosit.
Typická chyba je půjčit si vestu o číslo větší „aby nebyla těsná”. Ve vodě pak proteče kolem těla a při pádu vás nevynese. Druhá chyba je helma bez zkoušky s pádlem: při záběru nesmí kšilt překážet ve výhledu. Na řekách s prudkým proudem a válci je nutné mít vestu s okamžitou stabilitou, ne s měkkou pěnou, která se po nasáknutí zdeformuje. U ledovcových řek počítejte s nižší teplotou vody a zvolte vestu s vyšším krytím ramen.
Každé REST API funguje na stejném základu: klient pošle HTTP požadavek na konkrétní URL a server vrátí odpověď. Než začnete psát jakýkoli kód, ujasněte si čtyři věci: metodu (GET, POST, PUT, DELETE), cestu k prostředku, hlavičky a případné tělo požadavku. Právě kombinace těchto částí určuje, co server udělá. Pokud si je pletete, dostanete chybu 400 nebo 405 a budete zbytečně hledat problém v kódu, i když je chyba v samotném požadavku.
Při práci s odpovědí kontrolujte nejen stavový kód, ale i strukturu dat. Server může vrátit 200 a přesto v těle nést chybovou zprávu. Proto vždy čtěte obsah, ne jen kód. U seznamů počítejte s tím, že data mohou být stránkovaná a v odpovědi chybí metadata o další stránce. Pokud je ignorujete, zobrazíte jen první část a budete se divit, proč záznamy chybí.
Hlavičky a tělo rozhodují o výsledku Nejčastější chyba začátečníků je chybějící hlavička Content-Type. Server bez ní nepozná, zda posíláte JSON, nebo formulářová data, a odpoví chybou 415. U POST a PUT vždy nastavte Content-Type: application/json a tělo pošlete jako platný JSON. Dbejte na uvozovky u klíčů i řetězců, žádné koncové čárky. Naopak u GET tělo neposílejte vůbec, parametry předávejte v URL za otazníkem. Pokud potřebujete autorizaci, přidejte hlavičku Authorization s tokenem, ale nikdy token neposílejte v URL, kde se ukládá do logů.
