První REST API: chyba, která zablokuje odpověď

Zrcadlo umisťujte tak, aby odráželo zdroj světla, ne zeď za vašimi zády. Nejlepší je na stěnu naproti oknu, případně naproti dveřím do obytné části. Když zrcadlo pověsíte příliš vysoko nebo příliš nízko, bude odrážet jen strop nebo podlahu a efekt se ztratí. Horní hrana by měla končit zhruba ve výšce očí a spodní hrana ideálně těsně nad nábytkem, aby se odraz spojil s podlahou v jednu plochu. Velké zrcadlo od podlahy ke stropu v úzké chodbě funguje lépe než několik malých kousků, protože sceluje prostor.

Poslední věc, kterou většina lidí podcení, je opakování požadavku. Při výpadku sítě nebo chybě 5xx je rozumné zkusit požadavek znovu, ale jen u idempotentních metod, tedy GET, PUT a DELETE. U POST může opakování vytvořit duplikát. Pomáhá idempotentní klíč, který serveru řekne, že jde o stejnou operaci. Bez něj se z běžného výpadku stane dvojitá objednávka nebo dvojitý záznam, a to se opravuje mnohem hůř než chybějící hlavička.

Pravidelně testujte, zda topítko skutečně hřeje. Vypněte ho na hodinu, změřte teplotu, poté ho zapněte a po hodině změřte znovu. Pokud se teplota nezmění, topítko nefunguje, i když svítí kontrolka. Kontrolka totiž signalizuje jen připojení k proudu, ne funkčnost topného tělesa. Další častá chyba je ponechat topítko zapnuté při výměně vody, kdy hladina klesne pod minimální úroveň – topítko se přehřeje a praskne.

Objemná tmavá sedačka a masivní skříň jsou nejčastější chybou v malém obýváku. Nábytek by měl být nízký, ideálně na nožičkách, aby pod ním bylo vidět podlaha. Podlaha, která pokračuje až ke zdi, prodlužuje prostor. Skříně a police ve světlém dřevě nebo v barvě stěn splynou s pozadím a nechají vyniknout jen to, co je důležité. Pokud potřebujete úložný prostor, volte uzavřené skříňky bez úchylek nebo s úchylkami v barvě dvířek. Otevřené police plné drobností vytvářejí vizuální šum, který místnost zaplní. Zkuste pravidlo: na jedné stěně maximálně jedna velká plocha, zbytek nechte prázdný.

Stavové kódy nejsou dekorace Odpověď nekončí u dat. První číslo, které musíte číst, je stavový kód. 200 znamená úspěch, 201 vytvoření, 204 smazání bez obsahu. Řada 4xx znamená chybu na straně klienta: 400 špatný vstup, 401 chybějící autentizace, 403 nedostatečné oprávnění, 404 neexistující zdroj, 429 příliš mnoho požadavků. Řada 5xx je problém serveru. Pokud kód ignorujete a rovnou parsujete JSON, narazíte na výjimku, protože chybová odpověď má jinou strukturu než úspěšná.

Nejčastější chyba je příliš silná vrstva. Dvě lžíce náplně mezi tenkými pláty vypadají štědře, ale po upečení těsto provlhne a rozpadne se při prvním kousnutí. Lepší je méně náplně a pevnější stisk okrajů. Kraje spojujte vodou, ne bílkem, které po upečení ztvrdne a odloupne se.

Křehké vánoční cukroví nedrží pohromadě většinou kvůli tuku, ne kvůli mouce. Máslo změklé při pokojové teplotě stačí utřít s cukrem do světlé pěny, ale jen dokud je těsto hladké. Jakmile se máslo při šlehání zahřeje nad zhruba 24 °C, začne se oddělovat a těsto se při pečení roztéká. Máslo vyndejte z lednice hodinu předem, ale v horké kuchyni ho nechte maximálně 30 minut. Cukr moučka prosejte, jinak zůstanou hrudky, které se při válení trhají.

Než pošlete jakýkoli požadavek, ověřte si metodu. GET slouží ke čtení, POST k vytvoření, PUT nebo PATCH k úpravě a DELETE k odstranění. Záměna PUT a POST je klasika, která skončí chybou 405 nebo nechtěným duplikátem. U GET nikdy neposílejte tělo, i když to některé knihovny dovolí. Parametry patří do URL, ne do těla. U POST a PUT naopak nastavte hlavičku Content-Type na application/json, jinak server tělo ignoruje nebo vrátí 415.

Autentizace bývá druhá nejčastější příčina nefunkčního požadavku. Token patří do hlavičky Authorization, obvykle ve formátu Bearer a s mezerou za slovem. Token může vypršet, být vázaný na IP adresu nebo mít omezený rozsah. Pokud dostanete 401 i s tokenem, zkontrolujte, zda posíláte správný typ, zda není prošlý a zda ho nevkládáte i do URL. Nikdy token neposílejte v query stringu, protože se může dostat do logů.

Když pošlete první požadavek na REST API, nejčastější chyba není v kódu, ale v očekávání. Vývojář si myslí, že server odpoví hned a ve stejném formátu, jaký viděl v tutoriálu. Ve skutečnosti rozhoduje o výsledku hned několik vrstev: správná metoda, hlavičky, tělo požadavku a hlavně to, co server skutečně vrací. První krok proto není psát kód, ale otevřít dokumentaci a zjistit, jaký tvar odpovědi mám čekat.

Do kopce tlač, z kopce brz

Pečte na nižší teplotu, než jakou uvádí většina receptů. 160 °C s horkovzduchem stačí, 180 °C už spálí spodní stranu dřív, než střed propeče. Plech vyložte papírem, ne jen vymažte. Cukroví se pak nepřilepí a nemusíte ho silou odlepovat, což je další častý důvod, proč se láme.