Jak zvládnout první REST API bez zbytečných chyb

Světlo je v ložnici často podceňované. Jediný lustr uprostřed stropu vrhá ostré stíny a místnost působí ploše. Kombinujte tři zdroje: hlavní světlo (raději stropní bodovky), teplé lampy na nočních stolcích a nepřímé LED pásky za čelem postele nebo pod postelí. Tlumené boční světlo rozptyluje hranice prostoru, zatímco přímé osvětlení je zdůrazňuje. Zkuste také svítit na stěnu místo na střed místnosti – tím se zvýrazní její plocha a rohy se ztratí.

Důležité je kontrolovat nejen hotový text, ale také jeho části. Pokud máte delší článek, rozdělte ho na odstavce a každý otestujte zvlášť. Někdy se totiž shoda objeví až při dělení podle vět nebo klíčových slov. Vyhnete se tak situaci, kdy vám kontrola projde kvůli tomu, že duplicitní část je rozptýlená a systém ji nespojí. Stejně tak se vyplatí zkontrolovat nadpisy, popisky obrázků a metadata – i tyto prvky se často opisují doslova, a přitom na ně autoři zapomínají.

Když už odpověď dorazí, nespěchejte s radostí. Řada API vrací data zabalená do obálky, například objekt s klíči data, message nebo meta. Pokud budete předpokládat, že odpověď je přímo pole, narazíte. Nejprve si odpověď vytiskněte a prostudujte její strukturu. Často také narazíte na stránkování – server vám vrátí jen první stránku výsledků, třeba dvacet položek, a v hlavičce nebo těle najdete odkaz na další. Pokud chcete všechna data, musíte iterovat přes více stránek. Na to myslete při návrhu cyklu a nezapomeňte ošetřit případ, kdy žádná další stránka není.

Na závěr si osvojte logování a zpracování chyb. Nestačí jen odchytit výjimku a vypsat hlášku. Zaznamenejte si celou URL, metodu, hlavičky a tělo požadavku i odpovědi. To vám umožní rychle reprodukovat problém při ladění. Všímejte si také časování – pokud API odpovídá pomalu, může jít o problém na serveru, nebo o příliš velký objem dat. Požádejte o filtrování polí nebo použijte parametry jako limit a offset. Tím snížíte zátěž a zpřehledníte odpověď. První API je pak hlavně o trpělivosti a systematickém zkoušení – postupně získáte jistotu a další rozhraní už zvládnete bez větších obtíží.

Nezapomeňte také na ochranu proti predátorům. Zima je obdobím, kdy se hladové lišky a kuny snaží dostat do kurníku častěji, protože přirozené potravy ubývá. Zkontrolujte plot, ujistěte se, že je zahrabaný a bez děr. Vstup pro slepice opatřete pevnými dvířky, která večer spolehlivě zavřete. Zkontrolujte i střechu a spoje stěn – i malá škvíra se může stát vstupní branou pro hlodavce, kteří patří mezi přenašeče nemocí.

Na baru se vyplatí objednávat si nápoje po jednom, abyste nemuseli nosit plné sklenice přes celý sál. Pokud si chcete zatancovat, dejte si pozor na skleničky v ruce – taneční parket není místo na pití a rozlitý nápoj může snadno zničit večer vám i ostatním. Mezi tanečníky se pohybujte s respektem, nevrážejte do lidí a pokud chcete tančit s někým cizím, vždy se nejprve zeptejte. Většina Pražanů je na podobné interakce zvyklá a neznámý člověk, který se slušně zeptá, není problém.

Základním nástrojem je kontrola pomocí specializovaných služeb pro detekci duplicit. Většina z nich funguje na principu vložení textu do pole a spuštění analýzy. Výsledek vám ukáže procentuální shodu s internetovými zdroji a zvýrazní pasáže, které se objevují jinde. Pracujte však s výsledkem kriticky – nízké procento neznamená automaticky bezproblémový text a naopak vyšší shoda nemusí být vždy chybou, pokud jde o citaci, vlastní dřívější publikaci nebo obecně používanou frázi.

Nejčastější chybou začátečníků je ignorování stavových kódů HTTP. Kód 200 znamená úspěch, 201 že byl zdroj vytvořen, 400 špatný požadavek a 404 nenalezeno. Mnoho lidí se spolehne jen na to, že odpověď přišla, a začnou zpracovávat tělo zprávy. Jenže pokud server vrátí chybu, tělo obvykle obsahuje detailnější informaci o problému. Vždy proto nejprve zkontrolujte stavový kód a podle něj rozhodněte, jestli má smysl parsovat data. Tím se vyhnete záhadným výjimkám v kódu i zbytečnému ladění.

Typickou chybou prvních návštěvníků je přecenění vlastních sil. Alkohol teče proudem a atmosféra vás může strhnout, ale mějte na paměti, že ještě musíte dojít domů. Dejte si pozor na kombinování různých druhů alkoholu a mezi jednotlivými drinky si dejte sklenici vody. Pokud se necítíte dobře nebo se vám točí hlava, neváhejte odejít – v Praze jezdí noční spoje městské hromadné dopravy, ale pokud by nebyly dostupné, využijte oficiální taxislužbu nebo sdílenou jízdu. Nejdůležitější je, abyste se celý večer bavili a hlavně v pořádku dorazili domů.