5 pravidel pro věšáky a botníky, díky nimž úzká chodba neuvízne
Začněte metodou GET na jednoduchý zdroj. Otevřete terminál a pošlete požadavek ručně, abyste viděli hlavičky i tělo odpovědi v surové podobě. Nástroje s grafickým rozhraním jsou pohodlné, ale skrývají detaily, které při ladění rozhodují. V odpovědi sledujte stavový kód, typ obsahu a případné dodatečné hlavičky. Pokud server vrací data v jiném formátu, než jste čekali, je to první signál, že chybí správná hlavička Accept.
Zrcadlo je nejsilnější nástroj, ale musí být umístěné správně. Velké zrcadlo na stěně proti oknu zdvojnásobí výhled a přinese do místnosti další světlo. Naopak malá zrcátka rozházená po stěnách působí jako dekorace a prostor nezvětší. Pokud nemáte místo na velké zrcadlo, použijte zrcadlové dveře skříně nebo lesklou plochu na nábytku. Pozor ale na příliš mnoho odrazů; dva velké odrazy stačí, víc už ruší.
Začněte u nábytku. Postel je největší objekt, takže ji umístěte tak, aby neležela uprostřed místnosti a neblokovala okno. Ideálně jednou delší stranou ke zdi, se dvěma přístupovými stranami, pokud to jde. Noční stolky nahraďte úzkými policemi na zdi nebo malými závěsnými úložnými prvky. Skříně volně stojící u stěny vypadají těžce; vestavěné nebo alespoň nízké a světlé skříně nechají nad sebou volný pruh stěny, což opticky zvedá strop. Typická chyba: cpát do ložnice velkou komodu jen proto, že se vejde. Pokud ji nevyužijete denně, patří jinam.
U požadavků, které mění data, dávejte pozor na hlavičku Content-Type. Pokud posíláte JSON, musí tam být uvedeno application/json, jinak server tělo ignoruje nebo vrátí chybu. Častý začátečnický omyl je vložit data do adresy místo těla požadavku. Adresa slouží k identifikaci zdroje, tělo k jeho obsahu. Záměna vede k nečitelným adresám a problémům s délkou požadavku.
Při ladění si vždy uložte celý požadavek i odpověď. Když se něco pokazí, potřebujete vidět přesné znění hlaviček, těla a časové razítko. Bez toho budete hádat, zda chyba vznikla na vaší straně, nebo na straně serveru. Pomáhá i jednoduchý záznam do souboru, který porovnáte s dalším pokusem. Opakovaný test se stejnými vstupy je jediný způsob, jak ověřit, že oprava skutečně něco změnila.
Odstraňte krytinu, plovoucí podlahu, koberec i dřevěné palubky. U panelových bytů se často narazí na vrstvu lepidla nebo asfaltové izolace, která se musí mechanicky sejmout. Pozor na azbest – v některých starších bytech může být součástí lepidel nebo izolačních desek, a s tím se nesmí pracovat bez ochranných pomůcek a odborné likvidace. Před pokládkou nových rozvodů je nutné odstranit i staré potrubí, pokud už neslouží. Zbytky původních trubek, které zůstanou v podlaze, se později projeví jako tepelné mosty nebo zdroj hluku.
Doma jde odstranit pouze plak, ne kámen. Kartáčujte psovi zuby denně, případně obden, měkkým kartáčkem a pastou určenou pro psy. Pokud pes kartáček nesnese, začněte prstem namočeným v pastě a postupně přejděte na kartáček. Nikdy nezkoušejte kámen odlupovat nehtem, škrabkou ani kovovým předmětem. Poškrábete sklovinu a vytvoříte zářez, ve kterém se plak usadí ještě rychleji. Stejně chybné je spoléhat na žvýkací pamlsky nebo krmivo, které údajně čistí zuby. Ty sníží množství plaku jen částečně a existující kámen neodstraní.
Úzká chodba se rozhoduje o prvním dojmu z bytu během několika vteřin, kdy si host odloží kabát a vyzuje boty. Ve chvíli, kdy nemá kam odložit, hromadí se vše na podlaze a vstup působí jako skladiště. Přitom stačí držet se několika zásad, které vycházejí z reálného prostoru, ne z katalogových vizualizací. Než začnete cokoli kupovat, změřte si šířku chodby ve výši pasu a ve výši ramen – mnohdy se liší o desítky centimetrů a určuje, co se tam vůbec vejde.
Stavové kódy nejsou dekorace Stavový kód je zkratka celého výsledku. Dvojka znamená úspěch, čtyřka chybu na straně klienta, pětka selhání serveru. Záměna 200 a 201 při vytváření zdroje vypadá neškodně, ale rozbije klienty, kteří se podle kódu rozhodují. Stejně tak 401 a 403 nejsou totéž: první říká, že chybí přihlášení, druhé že přihlášení máte, ale na danou operaci nemáte právo. Záměna těchto dvou kódů vede k nesmyslným pokusům o opětovné přihlášení.
Poslední pravidlo: neočekávejte, že odpověď dorazí vždy celá a ve stejném tvaru. Ošetřete prázdné tělo, neočekávaný formát i chybový kód, který nedává smysl. Právě tam vzniká většina produkčních výpadků. Když budete rozumět tomu, co se děje mezi požadavkem a odpovědí, přestanete opravovat následky a začnete předcházet příčinám.
Každé REST API stojí na jednoduché smyčce: klient pošle požadavek, server vrátí odpověď. První funkční volání ale obvykle odhalí, že chyby nevznikají v logice byznysu, nýbrž v drobnostech kolem přenosu. Než začnete psát složitější integraci, ověřte si, že umíte přesně popsat, co jste poslali a co jste dostali zpět. Bez toho budete ladit poslepu.