První požadavek obvykle míří na takzvaný endpoint, tedy konkrétní URL, která reprezentuje zdroj. Pro začátek zvolte něco jednoduchého, třeba seznam položek. Pošlete GET a sledujte, co přijde. V odpovědi uvidíte stavový kód, hlavičky a tělo. Stavový kód 200 znamená úspěch, 404 neexistující zdroj, 401 nebo 403 problém s oprávněním, 500 chybu serveru. Nepokračujte dál, dokud nerozumíte, proč vám API vrací konkrétní kód. Často stačí opravit hlavičku Accept, která říká, v jakém formátu chcete odpověď – obvykle JSON.<br>
<br>
<br>
<br>
Jak si osahat první požadavek a hlavičky Když už víte, co chcete poslat, otevřete si nástroj jako je terminál s curl nebo Postman. Pro první pokus stačí jednoduchý GET na veřejné testovací API. Například požadavek na adresu, která vrací seznam uživatelů. V odpovědi uvidíte JSON s daty, ale také hlavičky. Ty obsahují metadata – status code, content-type, případně rate limiting. Pozor na status code: 200 znamená OK, 404 nenalezeno, 500 vnitřní chyba serveru. Mnoho začátečníků kontroluje jen to, že odpověď „přišla", ale zapomíná na status. V praxi se vyplatí v kódu vždy zkontrolovat response.status, jinak můžete zpracovávat chybovou odpověď jako platná data.<br>
<br>
<br>
<br>
Když se poprvé pustíte do REST API, nejčastější otázka zní: co přesně se stane, když odešlu požadavek? Odpověď je jednodušší, než se zdá. REST API funguje jako rozhraní mezi vaším kódem a databází, ale bez přímého připojení k databázi. Posíláte HTTP požadavek na konkrétní URL a server vám vrátí odpověď, obvykle ve formátu JSON. To je celé. Celý proces se dá rozložit do tří fází: sestavení požadavku, odeslání, zpracování odpovědi. A právě tady začíná praxe – ne teorie.<br>
<br>
<br>
<br>
Nezapomeňte ani na doplňky, které dělají každodenní provoz rychlejší. Na klíče a drobnosti si pořiďte malou nástěnnou poličku s háčky, která nezabere místo na zemi. Do rohu umístěte úzkou lavici s úložným prostorem, do kterého dáte šály nebo kabelky. Tím získáte místo k sezení při obouvání a zároveň schováte věci, které by jinak ležely na zemi. Vyhněte se ale přeplácání – každý prvek by měl mít svůj smysl a nezavazet.<br>
<br>
<br>
<br>
<span style="font-weight: 600;">Začněte jednoduchou hrou,</span> která nepotřebuje žádnou přípravu – sbíráním přírodnin podle barev. Každé dítě dostane za úkol najít tři věci v určité barvě, třeba žlutou, zelenou a hnědou. Pro mladší děti stačí dvě barvy, starší si poradí s pěti. Bouřlivý úspěch má varianta, kdy stavíte domečky pro skřítky z kůry, mechu a kamínků. Nezapomeňte ale na pravidlo: přírodní materiály berte z lesa, ale neberte živé rostliny ani lišejníky ze stromů – místo toho použijte spadané větvičky a suché listí.<br>
<br>
<br>
<br>
Naučte se poznat muchomůrku bílou, která je smrtelně jedovatá a vypadá jako žampion. Liší se od něj tím, že má bílé lupeny, zatímco žampion má lupeny růžové až hnědé. U mladých plodnic je ale rozdíl méně patrný. Vždy si proto vezměte lupen mezi prsty a třete – u žampionu se zbarví dohněda, u muchomůrky zůstane bílý. A ještě jedna rada: nikdy nekonzumujte houby, které jste sbírali v zahrádkářské kolonii, kde se mohou používat chemické postřiky.<br>
<br>
<br>
<br>
Nejbezpečnější je založit si vlastní herbář nebo fotodokumentaci. Vyfoťte si každou houbu před sběrem, i s okolím, a po příchodu domů ji porovnejte s atlasem. Pokud máte sebemenší pochybnost, houbu vyhoďte – i malý kousek muchomůrky zelené může způsobit selhání jater. Pamatujte, že otrava se projevuje až po 6 až 24 hodinách, kdy je již pozdě na výplach žaludku.<br>
<br>
<br>
<br>
Častým problémem je autentizace. Mnoho API vyžaduje API klíč, který posíláte v hlavičce Authorization. Klíč nikdy nevkládejte přímo do URL, protože se může zalogovat do serverových záznamů a uniknout. Místo toho použijte hlavičku, jak je popsáno v dokumentaci. Pokud API používá token, který expiruje, připravte si logiku pro jeho obnovu. Na začátku si vystačíte s ručním testováním, ale pro opakované volání si napište malý skript, který token získá a použije. Tím se vyhnete ručnímu kopírování a chybám.<br>
<br>
<br>
<br>
<span style="font-weight: 600;">Když místo nestačí,</span> využijte dveře a strop Vnitřní strana vstupních dveří je nedoceněný prostor. Stačí na ni připevnit háčky nebo úzký organizér s kapsami na rukavice, šály a drobnosti. Naopak těžké zimní bundy na dveře nevěšte – dveřní závěsy nejsou na takovou zátěž stavěné a brzy se uvolní. Pro těžké oblečení využijte stěnu, ale ne jen tak ledajakou. Nad věšák přidejte polici na čepice, nebo využijte stropní tyč, která je spíše neobvyklá, ale ve velmi úzké chodbě dokáže uvolnit prostor pod ní.<br>
<br>
<br>
<br>
Když se vám konečně podaří poslat požadavek a získat odpověď, nezapomeňte na zpracování chyb ve vašem kódu. Nikdy nepředpokládejte, že odpověď má očekávaný tvar. Zkontrolujte, zda je tělo validní JSON, a ošetřete situaci, kdy přijdou neočekávaná data. Tím se vyhnete pádu aplikace a uživatel dostane smysluplnou hlášku. První REST API je hlavně o trpělivosti a čtení dokumentace. Čím víc požadavků pošlete, tím rychleji pochopíte, jak API myslí, a další integrace půjdou snáz.
