Edytujesz REST API: co se stane mezi odesláním a přijetím dat

Větrání, vlhkost a prach pod šikmým strop<br><br>Ještě než udeří první silnější mrazy, truhlíky přesuňte na chráněné místo. Ideální je studený skleník, zasklená veranda, garáž s oknem nebo prostor u zdi orientované na jih. Teplota by se měla držet mezi 2 a 8 °C. Vytápěná místnost je pro většinu bylinek nevhodná, protože při teplu a nedostatku světla rostliny vyhánějí tenké výhony a pak uhynou. Pozor také na průvan a na místa, kde se drží vlhko.<br><br>Izolaci naskládejte tak, aby vyplnila celou tloušťku krokví a nevznikly dutiny u krokví a v rozích. Mezi izolací a parozábranou nesmí zůstat vzduchová kapsa, jinak se v ní drží vlhkost. U dvou vrstev izolace druhou vrstvu křížte, aby překryla spáry první. Nemačkejte izolaci do tenkých štěrbin; raději doplňte tenčí vrstvu. Před zaklopením zkontrolujte, že nikde neprosvítá a že izolace není prověšená.<br><br>Zrcadlo je nejsilnější nástroj, ale jen když visí správně. Umístěte ho na stěnu proti dveřím nebo oknu, odkud přichází světlo, a to tak, aby odráželo co nejvíc volného prostoru – ne dveře, které se otevírají, ani tmavý kout. Velké zrcadlo od podlahy ke stropu přidá místnosti celou jednu vizuální rovinu. Naopak mnoho malých zrcátek roztroušených po stěnách působí chaoticky a prostor drobí. Zrcadlo v rámu zvolte úzký, jinak zbytečně ukrajuje z odrazu.<br><br>Nejčastější chyby začátečníků mají společné jedno: spěch. Zapomenutá čárka v JSON, chybějící uvozovky kolem řetězců, poslání dat jako prostý text místo JSON, nebo špatně zakódovaná diakritika v adrese. Adresa musí být percent-encoded, jinak ji server může přečíst špatně. Dále lidé zapomínají, že GET nesmí měnit data, a používají ho k zápisu. To funguje jen do chvíle, než narazíte na cache nebo na server, který to odmítne.<br><br>Druhým signálem je brzdění. Dítě musí umět zastavit nohou o zem i brzdou na řídítkách, a to dřív, než vyjede z dvorku. Vyzkoušejte to na mírném svahu: rozjeďte se spolu, dítě jede vedle vás a na povel zastaví. Pokud místo brzdění strká nohy do stran a kolo se kymácí, je brzda zatím jen dekorace. Třetím signálem je rozjezd. Dítě, které se umí rozjet bez cizí pomoci, zvládne i první metry bez koleček, protože rozjezd je nejtěžší část jízdy.<br><br>Začněte tím, že si požadavek rozložíte na čtyři části: metodu, adresu, hlavičky a tělo. Metoda určuje, co chcete udělat – GET pro čtení, POST pro vytvoření, PUT nebo PATCH pro úpravu, DELETE pro smazání. Adresa musí být přesná včetně cesty k prostředku, například /uzivatele/42. Do hlaviček patří Content-Type s hodnotou application/json a případně Authorization s tokenem. Tělo posíláte jen u metod, které mění data, a musí jít o platný JSON. Když chybí Content-Type, server často tělo ignoruje a vrátí chybu, která vypadá jako problém na vaší straně, i když jde jen o chybějící hlavičku.<br><br>Odpověď si vždy prohlédněte celou, ne jen tělo. Hlavičky obsahují informace o typu obsahu, o limitu požadavků nebo o tom, kam se má klient přesměrovat. Tělo bývá ve formátu JSON, ale může být i prázdné – u úspěšného smazání je to běžné a není to chyba. Pokud server vrací data v jiné struktuře, než jste čekali, ověřte si dokumentaci. API se vyvíjí a starší verze mohou mít jiné názvy polí. Nikdy nehádejte názvy klíčů, raději si je vypište z reálné odpovědi.<br><br>Praktický postup je jednoduchý. Nejdřív si požadavek složte v nástroji, kde vidíte hlavičky i tělo. Odešlete ho a přečtěte si stavový kód. Teprve pak řešte obsah. Když dostanete chybu, změňte vždy jen jednu věc a zkuste to znovu. Tím zjistíte, co ji způsobilo. Až budete mít funkční požadavek, teprve ho přepište do kódu. Ušetříte tím hodiny hledání závorky na špatném místě.<br><br>Co se děje na serveru a proč přichází chyba Server požadavek nejprve ověří. Zkontroluje, jestli zná danou cestu, jestli metoda odpovídá tomu, co cesta podporuje, a jestli jste přihlášení. Teprve pak se podívá do těla. Pokud posíláte data, která neodpovídají očekávané struktuře, vrátí stavový kód 400 s popisem, co je špatně. Nezapomeňte, že stavové kódy nejsou jen čísla pro programátory – nesou informaci. 2xx znamená úspěch, 4xx chybu na straně klienta, 5xx chybu na straně serveru. Záměna 401 a 403 je častá: 401 znamená, že vám chybí nebo je neplatný přihlašovací údaj, 403 že jste přihlášení, ale na danou operaci nemáte právo.<br><br>Když poprvé posíláte požadavek na REST API, často skončíte u chybové hlášky a nejistoty, co se vlastně pokazilo. Přitom celý proces má jen několik kroků a každý z nich se dá samostatně ověřit. Většina začátečníků ale přeskočí základy a rovnou ladí tělo odpovědi, aniž by tušili, jestli požadavek vůbec dorazil na server.