Co se stane, když klient pošle špatný požadavek na API?

Do vymačkaných brambor přidejte vejce, sůl, mletý pepř, prolisovaný česnek a jen tolik hladké mouky, aby se těsto sotva spojilo. Dvě až tři lžíce na kilogram brambor stačí. Kdo přidá půl hrnku mouky, If you adored this article and you would like to obtain more info relating to stránka generously visit the page. dostane bramborovou placku, ne bramborák. Velmi dobře funguje i lžíce krupice místo části mouky – krupice váže vodu a povrch je pak ostřejší. majoránka patří jen do některých krajových verzí, https://Wikibuilding.org klidně ji vynechte.

Další chybou je zapomenout na větrání. Zasklená lodžie bez možnosti otevřít okna nebo bez přívodu vzduchu se v létě přehřívá a v zimě v ní vlhne zdivo. Zvažte alespoň jednu otevíravou část, ideálně v kombinaci s venkovními žaluziemi nebo markýzou. Stínění řešte současně se zasklením, později se špatně montuje a často hyzdí fasádu.

Odpověď by měla mít jednotnou strukturu. U úspěchu stačí vlastní data a případně metadata o stránkování. U chyby se osvědčilo vracet objekt s krátkým strojovým kódem, lidsky čitelnou zprávou a volitelně polem s podrobnostmi u jednotlivých polí. Nikdy neposílejte barvy stěn do obýváku odpovědi výpis zásobníku volání ani SQL dotaz. Prozrazují strukturu aplikace a v produkci se stávají bezpečnostním rizikem. Zprávy pište konkrétně: místo „neplatný vstup" uveďte, které pole a proč neprošlo.

Jablečná přesnídávka bez vaření je nejrychlejší cesta, jak dostat do dítěte ovoce, když nemá chuť na celý kus. Stačí jablko, trocha kyseliny a mixér. Přesto se spousta lidí dopustí chyby, po které přesnídávka zhnědne během pár minut a dítě ji odmítne. Není to o kvalitě jablek ani o drahém vybavení. Je to o pořadí kroků a o tom, čím jablko ochráníte před vzduchem.

Každý požadavek má čtyři části, které se vyplatí kontrolovat v tomto pořadí: metodu, cestu, hlavičky a tělo. Metoda určuje, co se má stát — GET čte, POST vytváří, PUT nahrazuje, PATCH mění část, DELETE maže. Cesta určuje, s čím se pracuje. Hlavičky nesou metadata, nejčastěji Content-Type a Accept. Tělo nese vlastní data, obvykle ve formátu JSON. Pokud si nejste jistí, začněte od hlavičky Content-Type. Chybějící nebo špatně uvedený typ obsahu je nejčastější důvod, proč server tělo vůbec nepřečte a vrátí obecnou chybu.

Co funguje a co je jen zbytečná prá

Druhý návyk se týká vstupů a výstupů. Každá funkce by měla mít jasně dané, co přijímá a co vrací. Když funkce někdy vrátí číslo a jindy řetězec, dřív nebo později na to narazíte. Typová kontrola v JavaScriptu není samozřejmost, takže si pomáhejte ručně. nábytek na míru začátek funkce dejte kontrolu, která ověří, že vstup je to, co očekáváte. Ušetříte si hodiny hledání, proč se sčítání chová jako spojování řetězců.

Dobře navržené rozhraní poznáte podle toho, že se dá ověřit jedním příkazem a že chybová odpověď řekne, co opravit. Pokud musíte k pochopení odpovědi číst zdrojový kód serveru, návrh ještě není hotový.
První REST API vzniká nejčastěji tak, že někdo otevře terminál, pošle ručně jeden požadavek a kouká, co mu přijde zpátky. To je správný začátek. Rozdíl mezi funkčním a problematickým rozhraním ale není v tom, že vrátí data, nýbrž v tom, jak se zachová, když požadavek není v pořádku. Právě tam se láme většina začátečnických implementací.

Při testování posílejte nejdřív platný požadavek, teprve pak ho rozbijte. Zkuste chybějící povinné pole, nesprávný datový typ, příliš dlouhý řetězec, neplatný token a cestu k neexistujícímu zdroji. U každého případu si zapište očekávaný kód a skutečný výsledek. Právě tyto negativní scénáře odhalí chyby dřív než uživatelé. Až budete mít jistotu, přidejte verzování do cesty a ověřte, že stará verze stále funguje.

Stavové kódy nejsou kosmetika Server musí odpovědět nejen obsahem, ale i stavovým kódem, který odpovídá situaci. 200 znamená úspěch, 201 vznik nového zdroje, 204 úspěch bez těla. 400 znamená, že požadavek je špatně sestavený, 401 že chybí nebo je neplatné ověření, 403 že ověření prošlo, ale chybí oprávnění. 404 znamená, že cesta nebo zdroj neexistuje, 409 konflikt, například duplicitní záznam, 422 že data jsou syntakticky v pořádku, ale obsahově nesmyslná. Záměna 400 a 422 nebo vracení 200 i při chybě patří k nejčastějším chybám. Klient se pak chová nepředvídatelně, protože nemá jak poznat, že se něco pokazilo.