Jak zvládnout první REST API a nespálit se při ladění

Nejlepší začátek je posadit děti doprostřed prázdného pokoje a nechat je vyprávět, co dělají nejraději – kde stavějí kostky, kde si čtou, kde poslouchají hudbu. Podle toho rozdělte prostor na „tichou" a „aktivní" část. Tichá zóna patří ke spaní a soustředění, aktivní k hraní a pohybu. Pokud je to možné, umístěte postele k protilehlým stěnám, nikoli vedle sebe. Každé dítě tak získá vizuálně vlastní polovinu, i když je místnost malá.

Častou chybou je, že se na noční stolek hromadí víc knih, než kolik jich stihnete přečíst, spolu s hrnkem od čaje a kapesními noži. Tím vzniká vizuální nepořádek, který mozek vnímá i v noci a snižuje se tím kvalita spánku. Pravidlo „jedna kniha, jeden hrnek, jedna věc navíc" vám pomůže udržet desku stolku volnou. Pokud patříte k lidem, kteří si čtou více knih najednou, vyberte si jednu na desku a zbytek uložte na polici pod stolkem, případně do menšího košíku připraveného vedle stolku.

Při odesílání dat v těle požadavku si dejte pozor na serializaci. V JavaScriptu použijete JSON.stringify() a v Pythonu json.dumps(). Pokud data nezkonvertujete z objektu na řetězec, server je nedokáže přečíst a vrátí 400 Bad Request. Také se vyplatí zkontrolovat, zda máte v těle správné názvy polí. API obvykle očekává přesné klíče, jako je "name" nebo "email", a jakýkoliv překlep znamená chybu validace. Server vám sice pošle seznam problémů, ale často až po delším ladění, proto je lepší si dokumentaci projít předem.

Typickým problémem při prvních pokusech je špatné zacházení s hlavičkami. Některé API používají kompresi gzip, takže pokud nezahrnete hlavičku Accept-Encoding, server vám pošle nekomprimovanou odpověď, ale klient jako curl to zvládne automaticky. Horší je, když API vyžaduje hlavičky, které nejsou v oficiální dokumentaci – třeba X-API-Key. V takovém případě si pečlivě prostudujte sekci autentizace a porovnejte, zda posíláte správný název. Malý rozdíl, jako třeba X-API-Key versus x-api-key, dokáže vygenerovat chybu 403, kterou řešíte hodiny.

Na desku stolku patří jen tři věci: lampa, kniha a místo na odložení brýlí. Lampa by měla mít nastavitelné rameno a směřovat světlo přímo na stránky, ne do očí. Ideální je model s teplou barvou světla a možností stmívání. Knihu si položte na jednoduchý stojánek, který udrží otevřenou správnou stranu – vyhnete se tak držení knihy jednou rukou a druhou si podpíráte hlavu, což je jistá cesta k usnutí. Vše ostatní, co potřebujete, ale nepoužíváte denně, patří do šuplíku nebo na spodní poličku.

Stejně opatrní buďte při běžném nošení. Kov snadno reaguje na agresivní chemikálie – chlorovaná voda v bazénu, čisticí prostředky s bělidlem nebo odstraňovač laku na nehty dokážou poškodit povrch i slitinu. Při úklidu, práci na zahradě nebo sportu s činkami je lepší prsten sundat a uložit na bezpečné místo. Nejčastější chybou je nechat ho v kapse u kalhot, odkud vypadne při praní, nebo ho položit na okraj umyvadla, kde snadno sklouzne do odpadu. Pro tyto případy pořiďte malou pevnou krabičku a mějte ji stále na stejném místě v šatní skříni či na poličce v koupelně.

Začněte tím, že stolek kompletně vyprázdníte a vytřete. Pak si sedněte do postele přesně tak, jak obvykle čtete. Všímejte si, kam dosáhnete bez zvednutí ramen a kam se musíte natáhnout. Optimální je, když máte předloktí opřené o matraci a ruka volně spočívá na desce stolku. Pokud je stolek výrazně níž nebo výš, pořiďte si malý stolní stojánek na knihu nebo zvedněte desku podložkou. Tím předejdete bolesti ramen i krční páteře při dlouhém čtení.

První praktický krok je pochopit strukturu požadavku. Nejdůležitější je URL, metoda a hlavičky. Hlavička Content-Type říká serveru, v jakém formátu posíláte data – obvykle application/json. V hlavičce Accept naopak deklarujete, jaký formát chcete přijmout. Mnoho API vyžaduje autentizaci pomocí hlavičky Authorization, kde posíláte token. Bez této hlavičky dostanete odpověď 401 Unauthorized, i když je zbytek požadavku v pořádku. Typická chyba je poslat token v těle nebo v URL, což je nejen nefunkční, ale také bezpečnostní riziko.

Typická chyba, do které se snadno spadne, je snažit se o naprostou rovnost. Ve skutečnosti děti nerady sdílejí úplně stejně – chtějí hlavně to, aby se s nimi počítalo. Dejte každému možnost vyzdobit si svůj koutek, ať už plakátem, kresbou, nebo policí s vlastními věcmi. Nechte je měnit dekorace podle věku a vkusu. Pokud se děti hádají o to, kdo bude spát u okna, nestranně rozhodněte a za půl roku si role vyměňte. Takový systém učí kompromisu a ukazuje, že pravidla platí pro oba.