Když požadavek i odpověď ladíš, zapisuj si přesné znění obou stran. Většina problémů se vyřeší porovnáním toho, co jsi skutečně odeslal, s tím, co server očekává. REST API není magie, je to jen dohoda o formátu a výměně dat. Kdo ji dodrží, dostane odpověď napoprvé.
Největší množství tuku bramborák nasaje ve chvíli, kdy je olej málo rozpálený. Studený olej se vsákne do okrajů, placka se rozpadá a lepí se na dno. Olej musí být rozpálený tak, aby se kolem bramboráku okamžitě vytvořila kroužek bublinek. Poznáte to i podle kousku těsta, který do pánve hodíte: pokud syčí a během pár sekund se ohne nahoru, je čas. Teplotu držte středně vysokou, ne na maximu — příliš žhavý olej placku spálí zvenčí a uvnitř nechá syrovou.
Nejprve si ujasněte, zda vůbec můžete platit online. Některé složenky mají variabilní symbol a číslo účtu, takže je lze zadat do internetového bankovnictví. Jiné jsou určené výhradně k úhradě v hotovosti na přepážce – typickyrůzné poplatky nebo platby na poště. Zkontrolujte, zda na složence není poznámka „pouze v hotovosti” nebo „platba na přepážce”. Pokud ano, online platba nepřichází v úvahu a musíte na přepážku.
Jak postupovat při samotném upevněn
Stačí malý kousek těsta nebo strouhanka. Když ji vhodíte do oleje, měla by okamžitě obklopit bublinkami a vyplavat nahoru během dvou až tří sekund. Pokud klesne ke dnu a nic se neděje, olej je studený. Pokud se okamžitě prudce rozprskne a zčerná, je přepálený. V tu chvíli stáhněte pánev z plotny, nechte olej mírně zchladnout a pokračujte. Další jednoduchý test: dřevěná vařečka ponořená do oleje – kolem ní se musí tvořit drobné bublinky.
Odkládací plocha je další věc, kterou lidé podceňují. Malý stolek nebo police na dosah ruky stačí na hrnek, brýle a rozečtenou knihu. Vysoký stolek nutí k nepřirozenému předklonu, nízký zase k ohýbání. Výška by měla odpovídat tomu, když sedíte s rukama volně podél těla – deska má být zhruba v úrovni loktů. Na stolek nepokládejte nic, co nesouvisí s odpočinkem. Notebook, telefon ani hromada časopisů koutek nezútulní, naopak z něj udělají pracovní kout.
Začni tím, že si ujasníš metodu a cestu. Pro čtení dat slouží GET, pro vytvoření POST, pro úpravu PUT nebo PATCH a pro smazání DELETE. Cesta obvykle obsahuje kolekci v množném čísle, například seznam položek, a případně identifikátor konkrétní položky. Záměna jednotného a množného čísla je častá chyba, stejně jako odeslání GET tam, kde server očekává POST.
Praktický postup: nejprve ověř dostupnost endpointu, potom pošli minimální platný požadavek a teprve pak přidávej další pole. Sleduj, co server vrací, a porovnej to s tím, co jsi poslal. Mezi typické chyby patří špatná autentizace, chybějící hlavička s tokenem, překlep v názvu pole a neošetřené prázdné hodnoty. U čísel a textů si hlídej typy, protože záměna řetězce za číslo způsobí neplatný požadavek.
Hlavičky a tělo rozhodují o výsledku U POST a PUT posíláš data v těle požadavku. Server musí vědět, v jakém formátu přicházejí, proto nastav hlavičku Content-Type na application/json. Zapomenutá hlavička je nejčastější důvod, proč server vrátí 415 nebo 400. Naopak při čtení odpovědi se hodí hlavička Accept, kterou říkáš, že chceš JSON. Tělo požadavku musí být platný JSON: dvojité uvozovky, žádné čárky navíc na konci, správně uzavřené závorky.
Odpověď nese stavový kód, který má vždy stejný význam. 2xx znamená úspěch, 4xx chybu na straně klienta a 5xx chybu na straně serveru. Ne každý úspěch ale znamená data: 204 znamená, že operace proběhla, ale tělo je prázdné. U chyb čti i tělo odpovědi, bývá v něm konkrétní popis, co je špatně. Slepé opakování stejného požadavku bez změny obvykle nepomůže.
První REST API obvykle vypadá jednoduše: pošleš požadavek a čekáš odpověď. Jenže právě mezi odesláním a přijetím odpovědi se odehrává většina chyb, které začátečníka zdrží na celý den. Klient odešle HTTP požadavek na konkrétní URL, server ho přijme, zpracuje a vrátí odpověď s hlavičkami a tělem. Pokud v kterémkoli kroku něco nesedí, nedostaneš data, ale chybový kód.
