REST API: co se stane mezi odesláním a odpovědí

Typická chyba začátečníků je podcenit údržbu. Akvadukty se pravidelně čistily, kontrolovaly a opravovaly. Únik vody znamenal pro město katastrofu. U dnešního potrubí to znamená alespoň jednou ročně projít trasu, zkontrolovat spoje a odstranit nánosy. Pokud voda obsahuje hodně železa nebo vápníku, počítejte s častější kontrolou. Zanedbaná trubka se neozve, dokud nepraskne.

Sušička a aviváž: dva nejčastější zabijá

Vlněné svetry a lněné košile jsou náchylné na dvě věci: teplo a mechanické tření. Praní v horké vodě způsobí sražení vlněných vláken, zatímco len ztratí pevnost a začne se drolit. Vlnu perte ručně nebo v pračce na program pro jemné prádlo při teplotě do 30 stupňů, s malým množstvím prostředku na vlnu. Len zvládne i 40 stupňů, ale vždy bez aviváže, která ho potáhne a sníží savost. Sušte vodorovně, nikdy v závěsu — vlna se vytáhne a ztratí tvar. Žehlete len z rubu, dokud je mírně vlhký.

Pod schody bývá tma a často i vydýchaný vzduch. Bez denního světla se z koutku stane sklad. Pokud tam nevede okno, použijte nepřímé osvětlení – pásek LED podél šikminy nebo nástěnné svítidlo s otočným ramenem. Důležité je, aby světlo nesvítilo přímo do očí vsedě, ale na stránku. Teplá bílá (2700–3000 K) je pro čtení příjemnější než studená. Větrání řešte mřížkou ve dveřích nebo v podlaze, jinak se vám tam bude držet vlhkost a knihy mohou plesnivět.

Sušení rozhoduje o tom, zda závěsy ještě někdy pověsí

Když poprvé posíláte požadavek na REST API, často vidíte jen dvě věci: odeslaný požadavek a přijatou odpověď. Mezi nimi se ale odehrává řada kroků, jejichž znalost rozhoduje o tom, zda budete umět rychle najít chybu. Pojďme se podívat na to, co se děje, když klepnete na tlačítko Odeslat, a na co si dát pozor.

Při ladění prvního API se vyplatí začít jednoduchým nástrojem, který zobrazí celý požadavek i odpověď. Uvidíte tak přesně, co se odeslalo a co přišlo. Častá chyba je ignorovat stavové kódy a spoléhat jen na to, že „něco přišlo". Pokud server vrátí 401, znamená to, že chybí nebo je neplatný autentizační token. Pokud 404, zdroj neexistuje – možná máte překlep v URL. U 400 je problém v datech, která jste poslali.

Dalším krokem je práce s formátem odpovědi. Většina API vrací JSON. Ten je potřeba parsovat a ošetřit případy, kdy pole chybí nebo má jiný typ, než očekáváte. Nikdy nepředpokládejte, že odpověď bude vždy stejná. Server může vrátit i chybový JSON s jinou strukturou. Ošetřete proto oba stavy: úspěch i chybu. Pomůže vám to předejít pádům aplikace.

Závěrem: první REST API vás naučí trpělivosti. Vždy si nejprve ověřte, že požadavek je správně sestavený, pak sledujte stavové kódy a nakonec kontrolujte tělo odpovědi. Vyhnete se tak zbytečnému hledání chyb, které vznikly jen kvůli chybějící hlavičce nebo špatné metodě.

Hlavičky a tělo: kde se ztrácí data Hlavičky nesou metadata. Nejdůležitější je Content-Type, která říká, v jakém formátu data posíláte. Pokud pošlete JSON, ale neuvedete application/json, server může tělo odmítnout nebo interpretovat jinak. Na straně odpovědi sledujte Status Code. 2xx znamená úspěch, 4xx chybu na straně klienta (špatný požadavek, neautorizováno, nenalezeno), 5xx chybu serveru. Nezapomeňte, že i odpověď s kódem 200 může obsahovat chybovou zprávu – vždy kontrolujte i tělo odpovědi.

Než vůbec odešlete data, musíte správně sestavit požadavek. Každý požadavek má metodu (GET, POST, PUT, DELETE), adresu zdroje, hlavičky a případně tělo. Metoda určuje, co chcete udělat: GET čte, POST vytváří, PUT nahrazuje, DELETE maže. Pokud použijete špatnou metodu, server sice může odpovědět, ale chování nebude odpovídat vašemu záměru. Typická chyba je poslat data v těle u GET požadavku – server je ignoruje, protože GET tělo standardně nepodporuje.