5 kroků, jak zvládnout první REST API bez zbytečných chyb

Co si pohlídat při psaní prvního požadavku Většina moderních API pracuje s daty ve formátu JSON. Hlavička požadavku proto musí obsahovat správný typ obsahu, nejčastěji application/json. Pokud ji vynecháte, server nemusí vaše data vůbec zpracovat. Stejně důležitá je i hlavička Accept, která říká, jaký formát odpovědi očekáváte. U REST API se v praxi setkáte s tím, že server vrací chybový stav, i když se zdánlivě nic nestalo. Proto si vždy vytiskněte celou odpověď včetně status kódu a těla – jen tak zjistíte, co se pokazilo.

Nezapomeňte ani na vzduchovou mezeru mezi izolací a střešní krytinou. Pokud je součástí skladby pojistná hydroizolace, musí být větraná – jinak se v ní bude srážet vlhkost. Zkontrolujte, zda jsou větrací otvory u okapů a hřebene volné a neucpané. Bez správného proudění vzduchu izolace neztrácí jen tepelně-izolační vlastnosti, ale také může způsobovat hnilobu dřevěných konstrukcí.

Základem je časté začleňování změn z hlavní větve do své pracovní větve. Ideálně několikrát denně, ne až před dokončením úkolu. Místo příkazu pro sloučení použijte rebase. Přepíšete tím historii pracovní větve na aktuální špičku hlavní větve. Váš nový commit se tak jeví, jako by vznikl až po všech ostatních změnách. Historie zůstává lineární a čitelná.

Práce s prvním REST API vypadá na první pohled jednoduše: pošlete požadavek a dostanete odpověď. Realita je ale o něco složitější. Nejčastější chybou začátečníků je přeskočení návrhu samotného požadavku. Než začnete psát kód, zjistěte si, jakou metodu API očekává. Pro čtení dat se obvykle používá GET, pro vytvoření zdroje POST, pro úpravu PUT nebo PATCH a pro smazání DELETE. Pokud použijete špatnou metodu, server odpoví chybovým statusem a vy budete zmateni.

Praktický postup vypadá takto: pravidelně commitujte své změny v pracovní větvi, ale s vědomím, že je později sloučíte. Než odešlete větev do sdíleného repozitáře, spusťte interaktivní rebase s parametrem pro squash. Vyberte commit, který chcete zachovat, a ostatní označte jako squash. Následně proveďte rebase na hlavní větev a push se správnými parametry. Nakonec vytvořte pull request, který se sloučí pomocí fast-forward.

Parozábrana patří na vnitřní stranu izolace – tedy směrem do místnosti. Musí být souvislá, všechny přesahy lepte speciální páskou a prostupy (kabely, trubky) důkladně utěsněte. Častou chybou je parozábrana natržená při manipulaci nebo jen volně položená bez přelepení spojů. Vlhký vzduch z interiéru pak proniká do izolace, kde kondenzuje a způsobuje plíseň. Použijte raději parozábranu s proměnnou difuzí, která v létě umožní vyschnutí konstrukce, ale v zimě zabrání pronikání vlhkosti.

Atmosféra je druhý velký rozdíl. San Siro je hlučné, chaotické, s pyro a s fanoušky, kteří stojí celý zápas. Pokud chcete zažít „italskou vášeň", buďte připraveni na to, že se na vás může dostat zpěv, ale i šála přes hlavu. Naopak Allianz Arena je čistší, více rodinná a organizovanější. Fanoušci Bayernu zpívají, ale méně agresivně. Pro děti je Allianz Arena jednoznačně pohodlnější, ale pokud hledáte syrový fotbalový zážitek, San Siro nezklame.

Začněte prohlídkou dřevěných prvků. Hledejte stopy vlhkosti, modré zabarvení, houbu nebo aktivní výskyt dřevokazného hmyzu. Pokud najdete byť jen malé poškození, ošetřete ho vhodným fungicidním a insekticidním nátěrem ještě před montáží. Stejně důležité je zkontrolovat místa, kde krokve procházejí zdí nebo kde se střecha setkává s komínem. Často tam dochází k zatékání, které není zvenčí vidět. Po silném dešti nebo při tání sněhu se vyplatí přijít do podkroví a sledovat, kde se objevují kapky nebo vlhké mapy.

Nakonec si uvědomte, že barevné ladění nemusí být dokonale sladěné do posledního detailu. Stačí, když si z obýváku vypůjčíte dva až tři odstíny a necháte ložnici dýchat. Pokud v obýváku dominuje šedá s dřevěnými akcenty, v ložnici použijte stejnou šedou na jednom doplňku a stejné dřevo na rámu postele. Tak vznikne harmonie, která není okopírovaná, ale působí přirozeně. Až budete hotovi, projděte si obě místnosti – měly by spolu vizuálně komunikovat, ale každá by si měla zachovat svou roli.

Kdy se vyhnout rebase a zvolit raději squash Rebase není vhodný pro veřejné a sdílené větve, na kterých pracuje více lidí. Přepsáním historie byste rozházeli repozitáře ostatních. Pro tyto případy použijte jiný přístup – squash. Ten sloučí všechny vaše mezičlány do jediného commitu. Než požádáte o začlenění změn do hlavní větve, proveďte squash a rebase proti aktuální hlavní větvi. Tím vznikne jeden čistý commit, který se začlení bez nutnosti merge commitu.