Největší chybou je chtít hru dokonalou. Děti si zapamatují cestu, ne p…

První funkční REST API vzniká ve chvíli, kdy klient pošle požadavek a server vrátí odpověď. Většina začátečníků se soustředí na samotný obsah odpovědi, ale zapomíná na to, co cestu mezi nimi řídí: hlavičky, stavové kódy a serializaci dat. Právě tam vzniká nejvíc chyb, které se později těžko hledají, protože klient dostane data, ale neví, co znamenají.

Začněte rozcvičkou, která není nudná. Místo kroužků na place postavte děti do řady a nechte je napodobovat pohyby zvířat: rak jde pozadu, žába skáče po čtyřech, čáp našlapuje pomalu a vysoko. Každé zvíře má přesně daný počet rekonstrukce koupelny krok za krokemů a směr. Děti se smějí, ale zároveň se učí koordinaci. Častou chybou je, že vedoucí předcvičuje příliš rychle. Zpomalte a nechte děti, ať vymyslí vlastní zvíře – zapojí se i ti, kteří se jinak stydí.

Moderní podlaha a dřevěný nábytek na míru vedle sebe fungují jen tehdy, když se nerozbíjí teplo a struktura. Nejde o to, aby všechno ladilo do jednoho odstínu, ale aby mezi sebou oba materiály komunikovaly. Než začnete cokoliv přesouvat nebo kupovat, položte na podlahu vzorky dřeva – víko od krabice, odstřižek dýhy, vzorník. Na skutečném světle u vás doma uvidíte, co vzorkovna v obchodě zamlčela.

Většina lidí si myslí, že oblečení se opotřebí nošením. Ve skutečnosti rozhoduje péče po nošení. Špatné praní, sušení a skladování zkracují životnost základních kousků mnohem víc než běžné nošení. Tričko, džíny nebo vlněný svetr vydrží roky, pokud respektujete pár pravidel.

Stavové kódy a tělo odpovědi rozhodují o dalším kroku Server musí odpovědět stavovým kódem, který odpovídá realitě. 200 znamená úspěch, 201 vytvoření, 400 chybu na straně klienta, 404 nenalezeno, 500 chybu serveru. Častá chyba je vracet 200 i u chyby a schovat problém do těla odpovědi. Klient pak musí hádat, jestli šlo o úspěch, nebo ne. Tělo odpovědi měj vždy ve stejném formátu, obvykle JSON, a u chyb přidej strojově čitelný kód a lidsky srozumitelnou zprávu.

Při ladění si vystačíš s nástrojem, který umí zobrazit hlavičky i tělo. Nejdřív zkontroluj Content-Type a Accept. Pokud klient posílá data jako JSON, musí to být v hlavičce. Server, který očekává JSON, ale dostane formulářová data, často vrátí podivnou chybu. Dále sleduj autentizaci. Token patří do hlavičky Authorization, ne do URL. V URL se může dostat do logů a odtud uniknout.

Začni tím, že požadavek popíšeš co nejpřesněji. Metoda určuje operaci: GET čte, POST vytváří, PUT nahrazuje, PATCH mění část, DELETE maže. Pokud metodu změníš jen kvůli tomu, že klient neumí poslat tělo požadavku, API se stane nepředvídatelné. Stejně důležitá je cesta k prostředku. Drž se podstatných jmen v množném čísle a vyhýbej se slovesům v URL. Jasná cesta je půlka úspěchu.

Islandský přístup je poučný i pro jiné země. Nezáleží jen na tom, zda je pod povrchem teplo, ale také na tom, jak dobře se podaří teplo přenést do budov a jak hospodárně se s ním zachází. Když se voda vrací zpět do podloží a soustava se udržuje v rovnováze, může geotermální zdroj sloužit po desetiletí. Kdo zvažuje podobný systém, měl by nejprve změřit teplotní profil vrtu, ověřit chemické složení vody a teprve potom navrhovat rozvod. Jinak se investice prodraží a zařízení bude fungovat jen na část svého potenciálu.

Poslední krok je ověření z druhé strany. Napiš jednoduchý test, který pošle požadavek a zkontroluje stavový kód, hlavičky i tvar těla. Testuj i chybové stavy: chybějící pole, neplatný typ, příliš dlouhý vstup. Právě tam se ukáže, jestli je API použitelné. Když odpověď sedí na požadavek, nic domýšlet a ty máš jistotu, že první REST API přežije i reálné nasazení.

Serializace je další místo, kde se to láme. Datum posílej v jednom formátu, ideálně v ISO 8601 s časovým pásmem. Čísla neposílej jako řetězce, pokud to není nutné. U textů si dej pozor na diakritiku a kódování UTF-8. Pokud klient pošle neplatný JSON, server musí vrátit 400 a přesně popsat, co je špatně. Nikdy nevracej celý stack trace, protože tím prozradíš strukturu aplikace.

Největší chybou je chtít hru dokonalou. Děti si zapamatují cestu, ne přesnost šifer. Když se něco nepovede, stačí říct, že další indicie je jinde, a hra pokračuje. Až skončí, schovejte papírky do krabice – za měsíc je můžete použít znovu na jiném místě a s jiným cílem.