Jak zprovoznit první REST API a nespálit se při volání
Když začínáte s REST API, nejdřív si ověřte, že rozumíte tomu, co je požadavek a co odpověď. Požadavek se skládá z metody, URL, hlaviček a případně těla. Odpověď vrací stavový kód, hlavičky a data. Než napíšete první řádek kódu, vyzkoušejte si volání v nástroji, který umožňuje odeslat požadavek bez programování. Tím získáte představu o tom, jak API skutečně funguje, a vyhnete se zbytečným chybám v kódu.<br>
<br>
<br>
<br>
Základem je číst pečlivě symboly údržby na štítcích a řídit se jimi. Mnoho lidí je ignoruje s tím, že „to přece vydrží". Jenže teplota praní, zákaz sušení v sušičce nebo pokyn k chemickému čištění nejsou náhodné. Například běžné džíny by se měly prát na rubu, ve studené vodě a s minimem pracího prostředku. Časté praní jim škodí víc než běžné nošení, takže pokud nejsou viditelně znečištěné, stačí je vyvětrat nebo vykartáčovat.<br>
<br>
<br>
<br>
U vlněných a kašmírových svetrů platí, že je nejlepší prát ručně ve vlažné vodě se speciálním pracím prostředkem. Vyvarujte se ždímání a kroucení, místo toho svetr jemně vymačkejte a sušte naplocho na ručníku. Nikdy ho nevěšte na ramínko, protože vlastní vahou se vytáhne a ztratí tvar. Stejně tak se vyplatí investovat do kvalitního kartáče na odstraňování žmolků – pravidelná údržba povrchu udrží svetr hebký a reprezentativní.<br>
<br>
<br>
<br>
Druhý typický problém je nejednoznačnost signálu. Pokud pomezní rozhodčí signalizuje faul, ale hlavní rozhodčí nevidí jeho vlajku, vzniká chaos. Hráči se zastaví, soupeř pokračuje a nakonec padne karta za situaci, která vůbec nemusela být přestupkem. Řešení je jednoduché: rozhodčí by měl mít předem dohodnutý systém komunikace s asistenty. Například zvednutá ruka s kartou znamená „čekám na tvůj názor" a teprve po pokynu hlavního se karta uděluje. Bez toho je každý výrok loterií.<br>
<br>
<br>
<br>
Jakmile API začne vracet správná data, zaměřte se na zpracování odpovědi v kódu. Vždy kontrolujte stavový kód před tím, než začnete parsovat data. Pokud je kód jiný než 2xx, neočekávejte, že tělo bude obsahovat platná data. Dále ošetřete situaci, kdy je odpověď prázdná nebo má neočekávanou strukturu. Použijte try-catch pro zachycení chyb při zpracování JSON. Dobrým zvykem je také logovat si odpovědi pro pozdější ladění.<br>
<br>
<br>
<br>
Při odeslání prvního požadavku se zaměřte na tři věci: správnou metodu, správné hlavičky a správné tělo. Například pro získání dat použijte metodu GET, pro vytvoření záznamu POST. Hlavička s typem obsahu musí odpovídat tomu, co posíláte — pokud posíláte JSON, nastavte odpovídající hodnotu. Tělo požadavku musí být validní JSON, což zkontrolujete v libovolném validátoru. Častou chybou je zapomenutí hlavičky pro přijímaný formát, což vede k chybové odpovědi.<br>
<br>
<br>
<br>
Typickou chybou je snažit se stihnout oba stadiony za jeden den. Mezi Milánem a Mnichovem je to sice jen hodina letadlem, ale přestup na letišti a cesta do centra vám zabere minimálně půl dne. Navíc každý stadion má jiný systém vstupenek a kontrol. San Siro vás může překvapit tím, že se část pokladních otevírá až hodinu před výkopem, zatímco Allianz Arena preferuje vstupenky v mobilu. Doporučuji proto rozdělit návštěvy do dvou dní, klidně s jedním volným dnem mezi nimi. Vyhnete se tak stresu a užijete si každý zápas naplno.<br>
<br>
<br>
<br>
Co dělat, když API vrací chybu Když obdržíte chybový stavový kód, nespěchejte s opravou kódu. Nejprve si přečtěte tělo odpovědi — často obsahuje podrobnosti o tom, co je špatně. Stavové kódy 4xx znamenají chybu na straně klienta, tedy vašeho požadavku. Typicky jde o špatně zadanou URL, neplatný token, nebo chybějící povinné pole. Kódy 5xx znamenají chybu na straně serveru — v takovém případě počkejte a zkuste požadavek později. Rozhodně neignorujte hlavičky jako je rate limit, které vám řeknou, kolik volání ještě můžete provést.<br>
<br>
<br>
<br>
Posledním krokem je správné skladování. Kožené bundy a kabáty potřebují prodyšné potahy, aby kůže mohla dýchat a nevysychala. Džíny můžete skládat, neskládejte je ale na hromadu, kde se tvoří záhyby, které se obtížně žehlí. Svetry raději poskládejte do šuplíku, nezavěšujte je. A pokud oblečení nosíte jen občas, uložte ho na suchém a tmavém místě, nejlépe s vůní levandule, která odpuzuje moly. Taková péče není o hodinách strávených žehlením, ale o každodenních drobnostech, které sečtené dají roky navíc.<br>
<br>
<br>
<br>
Než začnete nakupovat, projděte si stávající oblečení a zjistěte, které barvy se u vás opakují. Pokud zjistíte, že máte pět modrých triček a žádné kalhoty, které by k nim ladily, máte jasno. Barevná paleta by měla vycházet z vašeho přirozeného tónu pleti a vlasů. Teplé tóny pleti zvýrazní zemitější barvy – hnědá, rezavá, olivová. Studené typy ocení šedou, tyrkysovou nebo fialovou. Tímto krokem eliminujete impulzivní nákupy a zaměříte se na to, co skutečně využijete.