Co se stane, když první REST API pošle odpověď se špatným kódem

Začněte tím, že si požadavek rozložíte na čtyři části: 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 identifikuje zdroj, ne akci. Hlavičky nesou metadata: typ obsahu, autorizaci, verzi. Tělo existuje jen tam, rekonstrukce koupelny krok za krokem kde předáváte data. Pokud do cesty strkáte slovesa jako /getUser nebo /deleteItem, dřív nebo později narazíte na nekonzistenci.

Poslední věc je návratnost. Křeslo, které se nevejde do dveří nebo výtahu, je zbytečný problém. Změřte si i šířku chodby a dveřní otvor. Pokud kupujete online, zjistěte si podmínky vrácení dřív, než objednáte. Ušetříte si tím cestu a nervy, kdyby se ukázalo, že vám doma nesedí.

If you have any queries relating to where and how to use http://bookmarksknot.club/story.Php?title=moderni-domacnost-recept-na-pohodli, you can make contact with us at our site. Sledujte také, zda nejde o únavu, hlad nebo přetížení z celého dne. Dítě, které po škole nebo školce potřebuje pohyb venku, nebude sedět u deskové hry, i kdyby byla sebelepší. Naopak dítě, které je unavené, potřebuje klid, ne další podněty. Zkuste hru přesunout na jiný čas, třeba na dopoledne o víkendu, a porovnejte reakce. Často stačí změnit denní dobu a problém zmizí.
Před prvním nasazením si napište testy na chování, ne na implementaci. Pošlete požadavek bez hlavičky s typem obsahu, s neplatným tokenem, s neexistujícím identifikátorem. Ověřte, že odpovědi mají správné kódy a že se nemění schéma. Testy vám odhalí chyby dřív, než je uvidí klient. Zvlášť si hlídejte, jestli server vrací hlavičku s typem obsahu u každé odpovědi — bez ní si klient domýšlí formát a jednou to vyjde, podruhé ne.

Poslední věc, kterou většina lidí podcení, je verzování a zpětná kompatibilita. Přidejte verzi do cesty nebo do hlavičky hned na začátku. Když později změníte tvar odpovědi, staří klienti přestanou fungovat. Pokud verzi nemáte, nemáte kam ustoupit a musíte měnit všechny klienty najednou. První REST API není o tom, že něco vrátí. Je o tom, že vrátí předvídatelnou odpověď i ve chvíli, kdy se něco pokazí.

Vyhněte se dvěma omylům. První: představa, že Nové Město je „novější" čtvrť. Je starší než řada částí, které vypadají historicky. Druhý: snaha stihnout všechno pěšky za jeden den. Radši si vyberte dvě náměstí a jednu osu. Mezi nimi si všímejte detailů — orientace kostelů, nároží domů, šířky chodníků. Právě v těchto maličkostech se ukazuje, že středověký plán nebyl improvizace, ale promyšlený rámec, který Praze vydržel staletí.

První REST API vzniká většinou jako jednoduchý požadavek z terminálu nebo z prohlížeče. Server odpoví, klient si přečte tělo a hotovo. Jenže právě v tom okamžiku se rozhoduje, jestli bude API použitelné i za měsíc, nebo se rozpadne při první chybě. Rozdíl není v použitém frameworku, ale v tom, jak zacházíte s odpovědí.

Tělo odpovědi držte konzistentní. Když vracíte objekt, vracejte ho pořád ve stejné struktuře. U seznamů použijte obal s polem a počtem, ne holé pole — později budete chtít přidat stránkování a nechcete měnit tvar odpovědi. Chyby posílejte ve jednotném formátu: kód, zpráva, případně seznam polí, která selhala. Nikdy neposílejte výpis zásobníku volání, ten patří do logu, ne klientovi.

Sporák, dřez a lednice musí být co nejblíž u sebe. V panelákové kuchyni to znamená, že mezi nimi nemá stát nic, co se nedá odsunout. Chladničku nikdy neumisťujte na opačný konec místnosti jen proto, že se tam vejde. Každý krok navíc při vaření znamená, že se vám něco připálí. Dřez by měl být v rohu, ne uprostřed linky, protože roh jinak zůstane mrtvý a nedá se využít.

Stavové kódy nejsou dekorace Odpověď musí vždy začít stavovým kódem. 200 znamená úspěch, 201 vytvoření, 204 smazání bez těla. 400 je chyba klienta ve datech, 401 chybějící autorizace, 403 nedostatečné oprávnění, 404 neexistující zdroj, 409 konflikt, 422 nezpracovatelná data. 500 je chyba na serveru. Nejčastější chyba začátečníka je vracet 200 i při chybě a schovat problém do těla. Klient pak nemá jak rozlišit úspěch od neúspěchu a musí parsovat text.

První krok je průzkum. Vyžádejte si od správce nebo SVJ projektovou dokumentaci. Pokud není, udělejte si vlastní sondu: opatrně vyvrtejte několik otvorů do mazaniny v místech, kde předpokládáte vedení trubek. Trubky v paneláku bývají ocelové, měděné nebo plastové, často v ochranné bužírce. Nikdy nevrtejte naslepo do míst, kde by mohlo vést topení. Zásah do trubky znamená odstavení celého stoupacího vedení a opravu na náklady toho, kdo vrtal.