Když tvoříš první REST API, začni správně

Když se objeví chyba, nepropadaj. Nejprve zkontroluj, jestli je URL správně sestavená – chybějící lomítko na konci nebo naopak přebývající může změnit směrování. Podívej se na hlavičky: některé servery vyžadují autorizaci, jiné očekávají určitý User-Agent. Pokud posíláš data a dostaneš 400, čti chybové hlášení v těle odpovědi – mnoho frameworků ti přesně řekne, které pole chybí nebo má špatný typ. A pokud používáš nástroj pro testování API, začni v něm, ne v prohlížeči, protože prohlížeč automaticky posílá některé hlavičky a metody, které tvůj požadavek mění.

Na závěr si ověřte jednu praktickou věc: jak se textilie chová při praní. Zkontrolujte, zda záclona a závěs sráží podobně, jinak po prvním vyprání zjistíte, že jedna vrstva je o pár centimetrů kratší. A pokud si nejste jistí, jak kombinaci sladit, začněte od podlahy a stěn – neutrální béžová nebo šedá základna vám odpustí víc experimentů než výrazná barevná stěna. Teprve pak dodávejte textilie, které prostor zklidní a udělají z něj místo, kde se budete chtít zastavit.

Druhým klíčovým nástrojem je git merge --squash nebo nastavení pull.rebase a merge.ff ve vaší konfiguraci. Squash merge slouží ke sloučení celé větve do jediného commitu. To je vhodné, když pracujete na drobné funkci s mnoha drobnými commity, které samy o sobě nedávají smysl. Pomocí příkazu git merge --squash feature/login připravíte změny do staging area a poté je commitnete s jasnou zprávou. Tím se vyhnete změti drobných commitů a historie zůstane přehledná.

Nastavte si pozici na raftu dřív, než vyrazíte na vodu Než vůbec odrazíte od břehu, zkontrolujte si, jak sedíte. Nohy by měly být mírně pokrčené a pevně opřené o dno lodi nebo o speciální opěrky. Kolena by neměla být výš než kyčle – v opačném případě se pánev překlopí dozadu a bederní páteř se prohne do nepřirozené lordózy. Sedněte si na hránu sedáku nebo na nafukovací sedátko tak, aby byla pánev v neutrální poloze. To znamená, že si pod sebe nenacpete ručník ani nepodložíte jen jednu stranu. Cílem je, aby byla váha rozložená rovnoměrně mezi obě sedací kosti.

Než se připojíte k jakékoli bezdrátové síti, kterou jste si sami nenastavili, věnujte pozornost jejímu názvu a chování. Nezabezpečená Wi-Fi obvykle nemá žádné šifrování, což poznáte tak, že se k ní připojíte bez zadání hesla. V nastavení telefonu nebo počítače se u takové sítě často zobrazí ikona zámku, která je otevřená nebo vůbec není vidět. Pokud se připojujete na veřejném místě, jako je kavárna, nádraží nebo hotel, mějte na paměti, že provoz v takové síti může kdokoli sledovat.

Když odešleš požadavek, server ti vrátí stavový kód. Trojice čísel není formalita: 200 znamená úspěch, 201 úspěšné vytvoření, 404 nenalezeno, 400 špatný požadavek. Typická začátečnická chyba je považovat každou odpověď bez textu za úspěch, nebo naopak panikařit u kódu 500, který sice značí chybu serveru, ale často odhalí skutečnou příčinu až při logování. Vždy kontroluj stavový kód, nejen obsah těla odpovědi. Většina knihoven ti umožní snadno přečíst status a podle něj se rozhodnout, co dál.

Po návratu domů nebo do práce si projděte, k jakým sítím se vaše zařízení automaticky připojilo, a případně je odstraňte ze seznamu zapamatovaných. Pravidelně také aktualizujte operační systém i aplikace, protože bezpečnostní záplaty opravují známé chyby, které by útočník mohl zneužít. Pokud používáte veřejnou Wi-Fi často, investujte do kvalitní platební metody, jako je virtuální karta pro jednorázové platby, a raději nepoužívejte pro nákupy běžnou kartu. Tím minimalizujete škody, kdyby vaše data unikla.

Během jízdy se vyvarujte dvou extrémů: propadání do „hamaky" s kulatými zády a naopak přehnaného prohýbání s vystrčeným hrudníkem. Obě polohy blokují přirozené tlumení páteře. Pokud cítíte, že začínáte ztrácet oporu, zatněte břišní svaly tak, jako byste se chystali dostat lehký úder do břicha. Tento jednoduchý trik – aktivace břicha před každým náročnějším manévrem – vám pomůže udržet trup zpevněný i v peřejích.

Základní pravidlo zní: nikdy nemergejte větev do hlavní pomocí klasického git merge bez dalších úprav. Místo toho použijte git rebase před samotným začleněním. Po dokončení práce na feature větvi přepněte na hlavní větev, aktualizujte ji a poté rebasujte svou větev na její špičku. Tím se vaše commity přenesou na konec hlavní historie a vy pak můžete provést fast-forward merge, který nevytvoří žádný merge commit.

První REST API bývá často překvapením: zdánlivě jednoduchý požadavek skončí chybou, kterou neumíš přečíst, a odpověď, kterou dostaneš, neobsahuje to, co jsi čekal. Nejde o kouzla, ale o to, že HTTP má jasná pravidla a REST je jen způsob, jak je využít pro práci s daty. Než napíšeš první řádek kódu, ujasni si, co chceš API dělat: jestli má vracet seznam položek, jednu položku nebo třeba jen potvrdit, že operace proběhla. Podle toho zvolíš HTTP metodu a cestu – a to je základ, na kterém stavíš všechno ostatní.