Jak si osahat první REST API a nespálit se
Samotná výroba spočívá v rozpuštění šamponového základu ve vodní lázni. Do rozpuštěné hmoty vlijte bylinkovo-olejovou směs a důkladně míchejte, dokud není konzistence jednotná. Přidejte pár kapek esenciálního oleje (levandule, tea tree) pro vůni a konzervaci, ale nepřehánějte to – citrusové oleje mohou na světle oxidovat. Hmotu nalijte do silikonové formy nebo do krabičky vyložené pečicím papírem. Nechte ztuhnout v lednici alespoň 2 hodiny, pak vyklopte a nechte ještě 24 hodin vyschnout. Tuhý šampon by měl být na dotek pevný, ale ne křehký.
Další věc, na kterou je třeba myslet, je pH. Tuhé šampony mívají pH kolem 9–10, což je zásadité a může dráždit pokožku. Pokud máte citlivou hlavu, přidejte do směsi trochu kyseliny mléčné (nebo citronové šťávy) – ale jen velmi opatrně, přidání většího množství může narušit pěnění. Ideální je pH 5,5–7, takže po výrobě doporučuji otestovat šampon na vnitřní straně zápěstí. Pokud vás pálí, přidejte do směsi při příští dávce více změkčovadel, třeba lžičku medu nebo glycerinu, který také pomáhá udržet vlhkost.
Praktický postup: nejdřív si API vyzkoušejte na testovacím prostředí, pokud existuje. Pošlete jednoduchý GET na seznam zdrojů, poté zkuste vytvořit nový záznam přes POST. Ujistěte se, že posíláte data ve správném formátu — JSON vyžaduje dvojité uvozovky, ne jednoduché. Pokud server vrací chybu 422, znamená to, že data neprošla validací. Zkontrolujte názvy polí, často je tam překlep nebo chybí povinný atribut.
Mezi časté chyby patří použití příliš velkého množství vody, tření skvrny textilií, což vede k rozmazání, a čištění celé plochy bez předchozího testu na skrytém místě. Také se vyhněte agresivním rozpouštědlům, která mohou poškodit povrchovou úpravu. Pokud je čalounění z vlny, hedvábí nebo s ozdobnými prošitími, raději se poraďte s odborníkem, než sáhnete po jakémkoli přípravku.
Na závěr: testujte svůj kód proti reálnému API, ne jen proti dokumentaci. Dokumentace často zaostává za realitou. Začněte s jednoduchým GET požadavkem a postupně přidávejte složitější volání. Když se něco pokazí, vraťte se k základům – zkontrolujte metodu, URL, hlavičky a tělo. Většinou je chyba na vaší straně, a to je vlastně dobrá zpráva – znamená to, že ji můžete opravit. S trochou trpělivosti a systematičnosti první API zvládnete bez větších ztrát.
Mezi typické chyby patří použití pórobetonu na vnitřní akumulační stěny, kde neplní svou funkci, nebo zcela chybějící izolace u těžkého zdiva. Další častou chybou je umístění akumulační hmoty za nábytek nebo pod obklad – teplo se pak nemá jak dostat do místnosti. Nechte vnitřní povrch stěn pokud možno bez velkých předmětů, alespoň v místech, kde dopadá slunce nebo kde stojí topidlo. Vždy také dbejte na správné provedení tepelných mostů – v místě napojení stropů a podlah dochází k únikům tepla, které snižují efekt akumulace.
Další past: autentizace. Mnoho API používá API klíč v hlavičce nebo Bearer token. Klíč nikdy neposílejte v URL, protože se může zalogovat do historie. Místo toho ho vložte do hlavičky Authorization. Pokud používáte OAuth, postupujte podle toku: nejdřív získejte přístupový token, pak ho použijte pro další požadavky. Dejte pozor na expiraci tokenu — pravidelně se obnovuje, takže si nastavte mechanismus, který to zvládne automaticky.
První setkání s REST API vypadá často jako čtení cizího jazyka: endpointy, hlavičky, status kódy. Ale stačí si osvojit pár základních pravidel a celý princip se vyjasní. REST není protokol, ale architektonický styl, který staví na standardním HTTP. Místo toho, abyste se učili složité knihovny, začněte s obyčejným curl nebo nástrojem jako Postman. Cíl je jednoduchý: poslat požadavek, přečíst odpověď a pochopit, co se děje mezi tím.
Typický problém, který potká každého: dostanete odpověď, ale neumíte ji zpracovat. Místo abyste se snažili parsovat JSON ručně, použijte vestavěný parser. Jenže pozor – odpověď může být v kódování UTF-8, a pokud ji přečtete jako prostý string, skončíte s podivnými znaky. Vždy si nastavte kódování hned na začátku, ideálně hned u připojení. A ještě jedna věc: nespolehněte se na to, že API vrátí přesně to, co očekáváte. Může se stát, že místo pole polí přijde objekt – a váš kód se zhroutí. Proto si vždy ověřte strukturu dat předtím, než s nimi začnete pracovat.
Jak vypadá správný požadavek a co dělat s odpovědí Než začnete psát kód, zjistěte si dokumentaci API. Hledejte, jaké metody jsou podporované — GET pro čtení, POST pro vytvoření, PUT nebo PATCH pro úpravu a DELETE pro mazání. Každý požadavek má URL, hlavičky a případně tělo. Hlavičky jsou klíčové: bez správného Content-Type nebo Authorization tokenu vám server rovnou odpoví chybou. Typická chyba začátečníka je zapomenout na hlavičku Accept, která říká, v jakém formátu chcete odpověď — většinou JSON.
