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

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ý.

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 do 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.

Poslední věc: drobné opravy dělejte hned. Uvolněný knoflík, vytržený šev nebo mírně odlepená podrážka se řeší za pět minut. Když to odložíte, za měsíc je to na vyhození. Stejně tak občas promažte zip voskem nebo suchým mýdlem a přetřete kožené části krémem. Pravidelná malá péče zabere pár minut týdně a vrátí se vám v tom, že základní kousky zůstanou ve formě roky, ne měsíce.

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 zařídit malou kuchyni se zachová, když požadavek není v pořádku. Právě tam se láme většina začátečnických implementací.

Samotné odstranění krytiny je potřeba naplánovat podle typu podlahy. PVC a linoleum se dají stáhnout i s lepidlem, pokud jsou starší a křehké. Laminát se demontuje po dílcích a může se znovu použít, pokud není poškozený zámek. U dlažby je nutné počítat s tím, že se rozbije, a lepidlo se musí odsekat. Tady platí jedno pravidlo: neodstraňovat víc, než je nutné. Stoupačky obvykle vedou v rohu nebo u stěny, takže stačí uvolnit pás široký 50–60 cm podél celé trasy potrubí. Zbytek podlahy zůstane nedotčený a ušetří se čas i práce.

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.

Pohyb se musí přidávat postupně. Pes s nadváhou nemá kondici na dlouhé běhy. Začněte kratšími procházkami několikrát denně a prodlužujte je o pět až deset minut týdně. Vhodné je střídat chůzi, klus a zastávky, ne pes na vodítku, který se jen courá. Pokud pes kulhá nebo se po procházce těžce zvedá, zpomalte. Hubnutí má být pozvolné – úbytek kolem jednoho až dvou procent hmotnosti za týden. Rychlejší tempo škodí játrům a kloubům.

Vyhněte se třem častým chybám. První je kupovat drahé hotové svačinky, které vypadají zdravě, ale obsahují hodně cukru a soli. Druhá je připravovat příliš mnoho. Dítě, které jídlo nestíhá sníst, přestane svačinu vnímat jako příjemnou a začne ji vyhazovat. Třetí chyba je nedostatek tekutin. Do batohu patří voda, případně neslazený čaj. Sladké nápoje svačinu zbytečně srážejí, i když jsou po ruce.

V den stěhování funguje jen jedno pravidlo: každá krabice má číslo a každé patro v nové budově má určenou osobu, která za převzetí odpovídá. Vytiskněte si seznam, kam který nábytek patří, a nalepte ho na dveře místností. Bez toho vzniká zmatek, kdy se stoly skládají na chodbě a hledá se, co je čí. Po skončení udělejte krátkou kontrolu: co chybí, co je poškozené a co se má barvy stěn do obývákuřešit. Sepište to hned, dokud si to všichni pamatují, ne až za týden.

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.

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.

In case you loved this post and you would want to receive much more information about tato stránka generously visit our web-page.