Jump to content

První REST API: od požadavku k pochopení odpovědi

From Dusty Ways: Rebirth

Základním pravidlem je vzduch. Dřevo potřebuje cirkulaci ze všech stran, ne jenom shora. Proto ho nikdy neukládejte přímo na zem, ale na palety, latě nebo klády. Vzdálenost od země stačí deset až patnáct centimetrů, aby spodní vrstvy nevlhly od podloží. Stejně důležité je nechat mezi jednotlivými hromadami mezery. Pokud dřevo nacpete k sobě bez mezer, vlhkost zůstane uvnitř a proces sušení se zastaví.

Dalším krokem je správné nastavení hlaviček. Nejčastěji se setkáte s hlavičkami Content-Type a Accept. Content-Type říká serveru, v jakém formátu posíláte tělo požadavku (například JSON), zatímco Accept říká, jaký formát chcete v odpovědi. Pokud tyto hlavičky vynecháte nebo nastavíte špatně, server může vrátit chybu 415 Unsupported Media Type nebo odpovědět v nečekaném formátu. Vždy proto explicitně uvádějte obě hlavičky. Při práci s JSON dbejte i na to, aby tělo bylo skutečně validní JSON – častou chybou je zapomenutá čárka nebo nesprávné uvozovky, což vede k chybě 400 Bad Request.

Jak odhalit skryté problémy dřív, než dojde k výpadku Věnujte pozornost i samotnému chování topení. Pokud světelná kontrolka (pokud ji topení má) bliká, svítí jinou barvou nebo se nerozsvítí vůbec, je to signál. Další varovný příznak: topení se zapíná a vypíná příliš často – to naznačuje, že termostat nedrží přesně teplotu. Stejně tak pokud topení běží nepřetržitě, může to znamenat, že je zanesené vodním kamenem nebo že jeho výkon už nestačí. V takovém případě ho vyjměte a jemně očistěte měkkým kartáčkem – ale jen při vypnutém topení a po vychladnutí.

Teplota vody v akváriu je jedním z nejdůležitějších faktorů pro zdraví ryb i rostlin. Když topení začne selhávat, často to nepoznáte hned – teplota klesá postupně a ryby trpí téměř neznatelně. Přitom stačí pár desítek vteřin měsíčně, abyste odhalili problém dřív, než způsobí vážné škody. Nejde jen o to, aby topení topilo – jde o to, aby topilo správně a stabilně.

Jak číst odpověď a co si z ní vzít Odpověď obsahuje tři základní části: stavový kód, hlavičky a tělo. Stavový kód je trojmístné číslo, které vám okamžitě řekne, jestli požadavek uspěl. Dvojkové kódy (200, 201, 204) znamenají úspěch, trojkové přesměrování, čtyřkové chybu na straně klienta a pětkové chybu na straně serveru. Naučte se rozlišovat mezi 200 OK, 201 Created (po vytvoření zdroje) a 204 No Content (když odpověď nemá tělo). Častou chybou je spoléhat se jen na to, že „něco přišlo", a nekontrolovat stavový kód – pak vám unikne, že server vrátil chybu, i když se v těle objeví nějaká data.

Prevence spočívá v jednoduchém režimu. Jednou měsíčně odpojte topení od proudu a nechte ho vychladnout. Pak ho vyjměte a otřete suchým hadříkem. Zkontrolujte, zda je sklo nebo keramika bez trhlin. Poté topení ponořte do nádoby s vodou o teplotě přibližně odpovídající akváriu a zapojte ho. Sledujte, zda se začne ohřívat a jak rychle dosáhne nastavené teploty. Pokud to trvá déle než obvykle, je na čase zvážit výměnu. Tento test trvá pět minut a zachrání vás od nepříjemného překvapení.

Jak správně naskládat hromadu, aby nezatékalo Řezané a naštípané dřevo skládejte tak, aby bylo chráněné před deštěm a sněhem, ale ne před větrem. Ideální je hromada postavená ke zdi domu, ale s odstupem alespoň deset centimetrů, aby zeď nezvlhla. Střechu nad hromadou můžete udělat z prken, plechu nebo silné fólie – důležité je, aby přesahovala přes okraje a voda stékala dolů, ne do hromady. Nikdy nezakrývejte celou hromadu neprodyšnou plachtou, protože pod ní se sráží vlhkost a dřevo začne plesnivět.

Pokud máte úzkou chodbu, sáhněte po svislých úložných systémech. Na zeď připevněte lišty s háčky ve dvou řadách – jednu na bundy, druhou na tašky. Mezi ně zavěste kapsy na drobnosti, které uvolní místo na podlaze. Nezapomeňte, že háčky by měly být dostatečně silné, aby unesly zimní oblečení, a rozteč mezi nimi volte alespoň patnáct centimetrů, jinak se kabáty budou tlačit.

Nejprve se zaměřte na strukturu požadavku. Každý HTTP požadavek obsahuje metodu, URL, hlavičky a případně tělo. Metoda říká, co se má s prostředkem stát: GET pro čtení, POST pro vytvoření, PUT pro úplnou aktualizaci, PATCH pro částečnou změnu a DELETE pro smazání. URL identifikuje konkrétní zdroj, hlavičky nesou metadata (například typ obsahu nebo autorizaci) a tělo obsahuje data, která chcete odeslat. Typickou chybou začátečníků je používat GET pro akce, které mění stav systému, nebo naopak POST pro pouhé čtení. Držte se sémantiky metod, i když to někdy vyžaduje víc práce navíc.