Světlo, které nezvětšuje, ale kreslí hloub
Začněte metodou GET, protože nic nemění. Pošlete ji na cestu, která vrací seznam položek, a sledujte tři věci: stavový kód, hlavičku Content-Type a tělo odpovědi. Stav 200 znamená, že server rozumí a posílá data. Stav 404 znamená, že cesta neexistuje, ale server odpovídá. Pokud nedorazí nic, problém je jinde – špatný port, firewall nebo překlep v názvu hostitele. Tělo odpovědi bývá JSON, ale Content-Type to musí potvrdit. Když server pošle HTML místo JSON, parsování selže a vy budete hledat chybu v kódu zbytečně.
Když sladíte světlo se zálivkou, balkon vydrží celou sezónu bez uhynulých květináčů. Začněte dvěma až třemi druhy, sledujte je dva týdny a teprve potom přidávejte další.
Dejte pozor i na samotnou kvalitu vody, kterou do filtru přivádíte. Pokud je voda tvrdá nebo obsahuje vyšší podíl železa a manganu, houba se zanese rychleji a její výměna musí být častější. V takovém případě pomůže předřadit hrubší mechanický filtr, který zachytí větší část nečistot ještě před hlavní houbou. Někdy je ale lepší houbu z filtru úplně vyřadit a nahradit ji jiným typem předfiltrace, pokud opakovaně zhoršuje chuť vody.
Čtvrtým znakem je barva a změna barvy po poškození. Růžovka má klobouk šedohnědý až růžový, dužnina na řezu mírně růžoví. Muchomůrka zelená je zelenavá až olivová a po otlačení se nemění. Pozor na muchomůrku tygrovanou, která má klobouk šedohnědý s bílými šupinkami a je jedovatá. Pátým znakem je růst a období. Růžovka roste v lesích od června do října, často ve skupinách. Muchomůrka zelená roste od července do listopadu, jednotlivě nebo v menších skupinách.
Odpověď nečtěte jen podle stavového kódu. 201 znamená vytvořeno a často obsahuje nové ID. 204 znamená úspěch bez těla – pokud čekáte JSON, dostanete prázdný řetězec a rozpadne se vám parsování. 401 a 403 vypadají podobně, ale liší se: 401 znamená, že chybí nebo je neplatné přihlášení, 403 že jste přihlášeni, ale nemáte oprávnění. Záměna těchto dvou kódů vede k hodinám hledání v autentizaci, která je přitom v pořádku.
Když poprvé posíláte požadavek na REST API, nejčastější chyba není v kódu, ale v představě, co se vlastně děje. Požadavek je jen text, který odešlete na konkrétní adresu. Server ho přečte, rozhodne se podle metody a cesty, sáhne do databáze a vrátí odpověď. Žádná magie. Pokud tuhle linku pochopíte, přestanete zkoušet náhodné kombinace a začnete cíleně ladit.
Druhý krok je vlákno. Stoprocentní bavlna je pohodlná, ale u levnějších variant se rychle objeví žmolky a barva bledne. Hledejte bavlnu s delším vláknem, případně směs s polyesterem v poměru, kde bavlna převažuje. Podíl umělého vlákna zvyšuje stálobarevnost a snižuje mačkavost, ale příliš mnoho polyesteru znamená, že se povlečení bude elektrizovat a hůř odvádět vlhkost. Vlněné a hedvábné povlečení je na omak příjemné, ale praní a sušení snáší hůř, takže u něj barva vydrží kratší dobu.
Praktický postup je jednoduchý. Nejdřív si požadavek sestavte ručně v nástroji, kde vidíte hlavičky i tělo. Teprve když dostanete správnou odpověď, přepište ho do kódu. Do kódu pak přidejte logování stavového kódu a celé odpovědi při chybě. Bez toho budete hádat. A nastavte časový limit – pokud server neodpoví do několika sekund, spojení se zasekne a aplikace zamrzne. Timeout není volitelný, je to součást správného požadavku.
Hlavičky, tělo a co opravdu posíláte U metody POST a PUT se tělo požadavku stává hlavním zdrojem chyb. JSON musí být syntakticky správně – chybějící uvozovka nebo čárka navíc vrátí 400. V hlavičce Content-Type musí být application/json, jinak server tělo ignoruje nebo ho přečte špatně. U autentizace se často zapomíná na hlavičku Authorization s tokenem. Token patří do hlavičky, ne do těla ani do adresy. Adresa se totiž ukládá do logů a token v ní unikne. Stejně tak nikdy neposílejte citlivá data metodou GET, protože se objeví v historii prohlížeče i na serveru.
Nejčastější chyby se opakují: zapomenutá hlavička, tělo bez Content-Type, token v adrese, ignorovaný stavový kód a parsování odpovědi, která vůbec nepřišla. Když si osvojíte pořadí – metoda, cesta, hlavičky, tělo – a budete číst odpověď jako celek, první REST API v praxi přestane být záhadou. Zůstane jen text, který letí tam a zpět, a vy přesně víte, co obsahuje.
- ID: 414598
Be the first to review “REST API a webová stránka: kde končí data a začíná odpověď”
Reviews
There are no reviews yet.