První REST API: chyba, která zdrží odpověď nejvíc

Malá chodba neunese dvě botníky, věšák na kabáty a ještě skříň na sezónní obuv. Přesto se do ní vejde všechno, co potřebujete, pokud přestanete řešit, čím to zakrýt, a začnete řešit, kde to bude viset nebo stát. Rozdíl mezi funkční a nefunkční chodbou není v metrech čtverečních, ale v tom, kolik věcí leží na podlaze. Cokoli leží na zemi, zabírá místo dvakrát: jednou fyzicky a podruhé tím, že přes to musíte šlapat. Prvním krokem je proto vytáhnout z chodby vše, co tam nepatří – deštníky, tašky, které se tam jen odkládají, a boty, které se nenosí.

Poslední věc, kterou lidé v malé chodbě podceňují, je pravidlo pro vstup. Pokud každý člen domácnosti odloží boty i bundu okamžitě na své místo, chodba zůstane průchozí i večer. Pokud se věci hromadí na jedné židli, nepomůže ani sebevětší skříň. Vyhraďte každému jedno místo na věšáku a jedno pole v botníku a označte je – stačí barevná páska nebo jmenovka. Uvidíte, že po týdnu přestane vznikat hromada u dveří sama od sebe.

Kapsulový šatník funguje jen do chvíle, než přijde léto. Najednou zjistíte, že vaše pečlivě vybraná sada kousků nedává v horku smysl — látky jsou těžké, barvy působí unaveně a vrstvení, které jste měli vychytané, vás jen potí. Nejčastější chyba není v tom, že máte málo kousků. Je v tom, že letní kapsli stavíte jako úplně nový projekt, místo abyste ji napojili na tu stávající. Výsledkem je dvakrát tolik oblečení a pořád pocit, že si nemáte co vzít.

Nakonec myslete na odraz. Světlé matné povrchy na stěnách a přední straně linek vrátí víc světla než tmavé lesklé plochy, které dělají ostré odlesky a působí těžce. Zrcadlová nebo skleněná plocha umístěná proti oknu zdvojnásobí denní světlo a kuchyň opticky prodlouží. Než cokoli koupíte, zkuste večer zapnout jen provizorní světla v zamýšlených pozicích a postavte se tam, kde skutečně pracujete. Uvidíte stíny dřív, než utratíte peníze za svítidla, která byste museli vracet.

Než pošleš první požadavek na cizí API, ověř si, jaký obsahový typ server očekává. Kurýrní služby, platební brány i interní mikroslužby se liší: někdo chce application/json, jiný application/x-www-form-urlencoded. Když pošleš JSON s hlavičkou Content-Type: text/plain, server tě odmítne často nesmyslnou chybou 400. Do prohlížeče nebo nástroje pro ladění vlož hlavičky Accept i Content-Type a teprve pak řeš tělo požadavku.

Typické chyby, které ničí tvar i barvu: sušení na přímém slunci, na radiátoru, v sušičce nebo na vrcholu žehličky. Další chybou je přílišné vyždímání – teniska se ohne a mezipodešva zůstane zkroucená. Nikdy také nenechávejte mokré tenisky v uzavřené tašce nebo v koši. Pokud tenisky po usušení stále drží pach, posypte vnitřek jedlou sodou, nechte hodinu působit a vysajte. Barvu podpoříte tím, že světlé tenisky sušíte v bílém prostěradle, které zabrání přenosu barvy z okolí.

Nejčastější pastí je testování jen na šťastné cestě. Vyzkoušej chybějící parametr, příliš dlouhý řetězec, neplatný token a timeout. Nastav timeout na straně klienta kratší, než je timeout serveru, a ošetři přerušené spojení. U opakovaných požadavků používej idempotentní klíč, jinak při výpadku vytvoříš duplicitní záznam. A hlavně: každý požadavek i odpověď loguj ve strukturované podobě, bez tajných údajů. Až budeš příště ladit, ušetří ti to hodiny.

Mokré boty a bundy potřebují odvětrat, jinak chodba začne vonět zatuchlinou a materiál dřív odejde. Pokud je to možné, nechte mezi botníkem a zdí mezeru dva až tři centimetry a do spodní části botníku vyvrtejte několik otvorů. Bundy věšejte tak, aby se nedotýkaly zdi – mokrá bunda přilepená na zeď schne dvakrát déle a nechává na ní skvrny. V zimě se vyplatí mít u dveří malý odkapávací tác, který zachytí vodu z bot, místo abyste ji ráno vytírali.

Karel IV. založil Nové Město v roce 1348 a nešlo o okrajovou záležitost. Rozlohou bylo větší než Staré Město a jeho uliční síť se sbíhala k centrálnímu tržišti, dnešnímu Karlovu náměstí. Pokud se chcete v Novém Městě orientovat, nestačí sledovat turistické značky. Vyplatí se vyjít z logiky půdorysu: tři hlavní komunikační osy vedly od bran k centru a dodnes tvoří páteř čtvrti. Kdo se jimi řídí, nikdy nezabloudí.

Stavové kódy čti jako vodítko, ne jako chybu Odpověď není jen tělo. Stavový kód 201 znamená vytvořeno, 204 prázdné tělo, 429 příliš mnoho požadavků. U 429 čti hlavičku Retry-After a zpomal. U 5xx neopakuj požadavek okamžitě ve smyčce, ale s rostoucí prodlevou. Tělo chyby často obsahuje pole s kódem a popisem; loguj ho celé, ne jen „request failed". Právě tam bývá přesná příčina, například chybějící povinné pole.