Praní, nebo jen větrání? Jak prodloužit život základních kousků

Kam s věcmi, které používají všichni každý d<br> <br> <br> <br> Základní kousky – bílé tričko, džíny, kožené boty, vlněný svetr – ničí nejčastěji dvě věci: časté praní a špatné sušení. Tričko z čisté bavlny vydrží při nošení dvakrát až třikrát, než potřebuje vyprat. Mezi nošeními ho pověste na ramínko do průvanu, nejlépe přes noc. Vůně zmizí a vlákna se stažením ve vodě neopotřebují. U džínů je interval delší, klidně deset až patnáct nošení. Pokud je chcete osvěžit, dejte je na hodinu do mrazničky v uzavíratelném sáčku. Není to dezinfekce, ale zpomalí množení bakterií, které působí zápach.<br> <br> <br> <br> Začněte návrhem zdrojů, ne kódu. Zdroj je podstatné jméno v množném čísle: /uzivatele, /objednavky. Vyhněte se slovesům v cestě (/getUzivatel) i hlubokému vnořování. Vztah mezi zdroji řešte cestou, ne parametry: /uzivatele/42/objednavky. Filtr, řazení a stránkování patří do query parametrů. Tento krok zabere hodinu a ušetří týdny přepisování, až se API rozroste.<br> <br> <br> <br> Cena plus doprava a dostupnost rozhodu<br> <br> <br> <br> Stavové kódy a chybové odpovědi Stavový kód není formalita. 200 znamená úspěch, 201 vytvoření, 204 smazání bez těla. 400 je chyba na straně klienta, 401 chybějící autentizace, 403 nedostatečné oprávnění, 404 neexistující zdroj, 409 konflikt, 422 neplatná data. 500 je chyba serveru a nemá unikat do odpovědi s detailem. Do těla chyby dejte strojově čitelný kód a krátkou zprávu. Nikdy nevracejte 200 s polem error — klient to přehlédne a vy budete ladit hodiny.<br> <br> <br> <br> Před první jízdou sundejte pedály. Nejsou potřeba. Dítě se odráží nohama, učí se balancovat a řídit. Teprve když samo zvedne nohy a jede rovně několik metrů, našroubujte pedály zpět. Tento krok většina lidí přeskočí a pak se diví, že dítě padá. Odrážedlo není ostuda, je to nejrychlejší cesta k rovnováze. Jezděte na rovném, prázdném a tvrdém povrchu – asfalt, nikoliv tráva. Tráva zpomaluje a dítěti bere jistotu. Vyberte místo bez provozu, bez psů a bez kopce.<br> <br> <br> <br> Na závěr dokumentujte kontrakt, ne implementaci. Popište vstup, výstup, kódy a limity. Když se kontrakt nezmění, klient může nasadit novou verzi serveru bez zásahu. To je celý smysl REST API: oddělit požadavek od odpovědi tak, aby mezi nimi nebylo nic skrytého.<br> <br> <br> <br> Testujte požadavek ještě před psaním klientského kódu. Nástroj příkazové řádky vám ukáže přesné hlavičky i tělo. Ověřte, co se stane při chybějícím tokenu, při neplatném JSON a při neexistujícím ID. Právě tyto tři případy tvoří většinu produkčních incidentů. Výsledek si uložte jako sadu příkladů, které poběží při každé změně.<br> <br> <br> <br> Typické chyby: posílání citlivých dat v query parametrech, protože se ukládají do logů. Chybějící verze v cestě (/v1/) u veřejného API. Ignorování hlavičky Content-Type, kvůli čemuž server nerozpozná JSON. A návrat celé databázové entity včetně interních ID a hesel. Odpověď má obsahovat jen to, co klient potřebuje. Pokud potřebujete víc, vytvořte samostatný endpoint, ne přidávejte pole do stávajícího.<br> <br> <br> <br> Pomocí srovnávačů získáte rychlý přehled, ale berte je jako start, ne jako konečný verdikt. Některé obchody v nich nejsou, jiné mají cenu aktualizovanou se zpožděním. Vždy si otevřete samotný e-shop a ověřte cenu v košíku. Pozor na automatické doplňky, pojištění nebo prodlouženou záruku, které se přidají během objednávky. Ty mohou rozdíl smazat.<br> <br> <br> <br> <img src="https://burst.shopifycdn.com/photos/sewing-machine-knobs.jpg?width=746&format=pjpg&exif=0&iptc=0" style="max-width:420px;float:right;padding:10px 0px 10px 10px;border:0px;">První REST API vzniká nejčastěji tak, že někdo pošle požadavek a čeká odpověď. Mezi tím jsou ale desítky rozhodnutí, která určí, jestli to bude fungovat i za měsíc. Požadavek má vždy metodu (GET, POST, PUT, DELETE), adresu zdroje a hlavičky. Tělo požadavku nese data jen u metod, které mění stav. Server odpovídá stavovým kódem, hlavičkami a tělem. Pokud tyto tři vrstvy pomícháte, vznikne chaos, který se těžko opravuje.