REST API v praxi: co se děje mezi odesláním a odpovědí > 자유게시판

• 목록
• 답변
• 글쓰기
• 게시판 리스트 옵션
  • 수정
  • 삭제

Nejčastější chyba je opakovat povel stále dokola a hlasitěji. Pes se učí, že první povel nic neznamená. Vyslovte povel jednou, jasně a klidně. Pokud pes nezareaguje, nepřidávejte slova – pomozte mu tělem. Například u „sedni" položte ruku s pamlskem nad čumák a pomalu ji posuňte dozadu. Jakmile pes sedne, okamžitě odměňte. Odměna musí přijít do dvou sekund, jinak pes spojí odměnu s něčím jiným.

První REST API obvykle vypadá jednoduše: pošleš požadavek, dostaneš odpověď. V praxi ale rozhoduje několik detailů, které se v tutoriálech přeskočí. Než začneš psát klientský kód, ujasni si, co server od klienta očekává. Každý požadavek má metodu, adresu, hlavičky a tělo. Metoda určuje, co se má stát s daty. GET čte, POST vytváří, PUT nahrazuje, PATCH částečně mění a DELETE maže. Pokud pošleš GET s tělem nebo POST bez správné hlavičky Content-Type, server odpoví chybou, i když je logika na tvé straně správná.

Testuj API ručně ještě před psaním aplikace. Pošli požadavek bez tokenu, s neplatným tokenem, s prázdným tělem a s neexistujícím identifikátorem. Sleduj, co se vrátí. Tím získáš přesnou představu o chování serveru a odhalíš chyby v dokumentaci. Dokumentace bývá neúplná nebo zastaralá. Pokud si nejsi jistý, zda má být parametr v adrese, nebo v těle, podívej se na skutečný požadavek v nástroji pro vývojáře. Ušetříš hodiny hledání chyby, která vznikla jen nesprávným umístěním hodnoty.

Základem je uzavřený noční výběh. Kurník musí být pevný, s podlahou nebo alespoň s betonovým pásem po obvodu, aby se dovnitř neprohrabal žádný predátor. Větrací otvory opatřete pletivem s oky do dvou centimetrů, nikdy ne drátěnou sítí, kterou kuna přeřízne nebo protrhne. Dvířka zajistěte západkou, kterou nezvládne otevřít ani šikovná kuna, ani malé dítě. Mezi střechou a stěnou nesmí zůstat mezera. Pravidelná kontrola spojů a výměna zkorodovaného pletiva je stejně důležitá jako samotná stavba.

Malý byt netrpí jen nedostatkem metrů, ale i tím, jak na první pohled působí. Předsíň bývá nejmenší a nejtmavší místnost, přesto právě ona rozhoduje o tom, jak se člověk v celém byt v panelákuě cítí. Předsíňová stěna, ať už jde o příčku, vestavěnou skříň nebo jen výrazný povrch, dokáže s vnímáním prostoru udělat víc než jakékoli zrcadlo pověšené dodatečně. Klíč je v tom, že předsíň funguje jako filtr: co vidíš při vstupu, to si mozek přenese do celého bytu.

Postel je největší předmět v místnosti, takže její umístění rozhoduje o všem ostatním. Postavte ji tak, aby na ni bylo možné vejít ze dvou stran, pokud to jde. Když to nejde, nechte volnou alespoň tu jednu stranu, po které se chodí nejčastěji, a druhou přisunutou ke zdi využijte jako úložnou. Čelo postele nepatří přímo pod okno, pokud v noci větráte nebo vám vadí světlo z ulice. Typická chyba je postel zaražená do rohu hned vedle dveří – vznikne mrtvý prostor za dveřmi, který už nikdy nevyužijete.

Stavy, chyby a to, co se často plete Největší zdroj zmatku je práce se stavovými kódy. Mnoho začátečníků kontroluje jen, zda požadavek nespadl, a pak čte tělo odpovědi. To je chyba. Stavový kód 200 znamená úspěch, 201 vytvoření, 204 smazání bez obsahu. Řada 4xx znamená chybu na straně klienta, 5xx na straně serveru. U 400 je v těle obvykle popis, co je špatně. U 401 chybí nebo je neplatný token. U 403 token existuje, ale nemá oprávnění. U 404 zdroj neexistuje. U 429 jsi překročil limit požadavků a má smysl počkat. Nikdy neignoruj tělo chybové odpovědi, často obsahuje konkrétní pole, které je potřeba opravit.

Nejdřív vysvětlete pravidla celá, teprve potom rozdělte děti do týmů. Když začnete rozdělovat dřív, polovina skupiny už neposlouchá. Počet hráčů v týmu držte vyrovnaný, ale nebojte se míchat věk. Starší dítě nemá být kapitán, který jen diriguje. Dejte mu konkrétní úkol, například hlídání času nebo počítání bodů. Menší děti potřebují jasný signál pro start i pro konec. Píšťalka, tlesknutí nebo zvednutá ruka stačí.

První funkční REST API není o tom, že všechno funguje na první pokus. Je o tom, že umíš přečíst odpověď, poznat, co je špatně, a opravit to. Začni jedním zdrojem, jednou metodou a jednou chybou. Až budeš rozumět tomu, proč server vrátil právě tento kód, zvládneš i složitější operace.

Adresa požadavku není jen cesta. Obsahuje také verzi API a identifikátor konkrétního zdroje. Drž se pravidla, že zdroj je vždy podstatné jméno v množném čísle, nikdy sloveso. Místo /getUser použij /users/123. Vyhneš se tak nejasnostem, když později přidáš další operace. Do hlaviček patří Authorization s tokenem, Accept s typem odpovědi a případně Accept-Language. Token neposílej v adrese URL, protože se může dostat do logů a historie prohlížeče. Pokud API používá API klíč, ověř si, zda patří do hlavičky, nebo do parametru, a nikdy ho neukládej na veřejné místo.