Když se sluchátka nehlásí k telefonu, zpravidla stačí tři kroky

Z Mazovia

Než začneš psát jakýkoli klientský kód, potřebuješ si ujasnit, co se děje na drátě. REST API není magie, je to jen výměna textu přes HTTP. Klient pošle požadavek, server vrátí odpověď. Tvůj úkol je složit správný požadavek a přečíst odpověď. První praktický krok proto není psaní kódu, ale otevření konzole a ruční vyzkoušení jednoho volání. Uvidíš hlavičky, stavový kód i tělo odpovědi a přestaneš se bát neznámého.

Naplňujte je až po úplném vychladnutí. Krém musí být hustý a studený, jinak těsto nasákne. Pokud děláte šlehačkový krém, zpevněte ho želatinou nebo smetanovým ztužovačem. Při plnění postupujte zespodu nebo z boku, aby se věneček neroztrhl. Hotové věnečky skladujte v chladu a podávejte co nejdřív – i správně upečené těsto začne vlhnout, když v něm krém zůstane příliš dlouho.

Posledním krokem je domácí kontrola. Před vařením houby znovu prohlédněte, očistěte a zbavte všech částí, které nepatří do pokrmu. U některých jedlých druhů je nutná tepelná úprava delší než dvacet minut, u jiných stačí jen krátké podušení. Nikdy nemíchejte neznámé houby s jistými, abyste v případě potíží věděli, co bylo příčinou. Vést si jednoduchý zápis o tom, co a kde rostlo, se vyplatí, protože paměť po letech slábne.

Největší chyba je uklízet celý byt najednou a pak být tři dny vyřízený. Mnohem lepší je rozdělit prostor na zóny a každý den zvládnout jednu. Pondělí kuchyně, úterý koupelna, středa podlahy, čtvrtek ložnice, pátek chodba a obývací pokoj. Za týden máte hotovo, aniž byste si všimli, že jste něco dělali. A když jeden den vynecháte, nic se nestane – plán se posune, ne zhroutí.

Začněte tím, že si před úklidem připravíte pomůcky na jedno místo. Hadr, vysavač, sáček na odpad a prostředek na povrchy. Když budete pro každou věc běhat do jiné místnosti, ztratíte polovinu času a motivace. Typická chyba je začít uklízet bez toho, abyste nejdřív uvolnili plochu. Na stole leží papíry, na židli oblečení – a vy nemáte kam utírat prach. Nejdřív odklidit, potom čistit.

Formát těla bývá JSON, ale není to pravidlo. Vždy zkontroluj hlavičku s typem obsahu, než začneš parsovat. U JSONu dávej pozor na tři věci: klíče musí být v uvozovkách, nesmíš zapomenout čárky mezi položkami a nesmíš je nechat navíc na konci. Odesílat data jako řetězec místo skutečného objektu je další klasika – server pak hlásí chybu 400 a ty hledáš problém ve validačních pravidlech, i když jde jen o špatně sestavené tělo. Před odesláním si tělo vypiš nebo zvaliduj.

Poslední rada se týká ověřování. Mnoho API chce token v hlavičce, ne v URL. Token v adrese se snadno dostane do logů a histories prohlížeče. Pokud volání vrací 401 i s tokenem, zkontroluj, zda ho posíláš ve správném formátu a zda nevypršel. Až budeš mít jedno volání funkční ručně, teprve pak ho přepiš do kódu. Ušetříš si hledání chyby, která vůbec není v programovacím jazyce.

Požadavek má čtyři části, které musíš správně nastavit: metodu, URL, hlavičky a tělo. Metoda určuje, co chceš udělat – GET čte, POST vytváří, PUT nebo PATCH upravuje, DELETE maže. URL ukazuje na konkrétní zdroj, obvykle v množném čísle, například položky nebo uživatelé. V hlavičkách posíláš metadata: typ obsahu, který posíláš, a typ obsahu, který očekáváš zpět. Tělo nese data jen u metod, které něco mění. Pokud pleteš tělo do GET, server ho většinou ignoruje a ty hledáš chybu na špatném místě.

U odpovědi si vždy přečti i hlavičky. Najdeš tam typ obsahu, informace o stránkování nebo limitech. Když server vrací seznam, bývá zanořený do obalu s polem položek a celkovým počtem. Nezačínej rovnou indexovat první prvek, nejdřív zjisti, jak přesně je odpověď strukturovaná. Totéž platí pro chybové odpovědi: pole s kódem a zprávou se liší server od serveru, takže se nevyplácí spoléhat na pevný text.

Začněte tím, že sluchátka vrátíte do režimu párování. Pouhé vytažení z pouzdra nestačí – mnoho modelů se po vyjmutí automaticky snaží připojit k naposledy používanému zařízení, a pokud je to jiný telefon nebo tablet v dosahu, zůstanou k němu připoutaná. Podržte tlačítko pro párování tak dlouho, dokud nezačne blikat indikátor v jiném rytmu než obvykle, případně dokud neuslyšíte zvukový signál. Teprve potom otevřete v telefonu nastavení Bluetooth a nechte ho zařízení vyhledat.

Telefon sluchátka vůbec nezobrazí v seznamu dostupných zařízení nebo se připojí jen na okamžik a zase vypadnou. Než začnete hledat závadu v hardwaru, projděte si pořadí, ve kterém se problémy s párováním řeší. Většina případů končí u jednoho ze tří míst: sluchátka nejsou v režimu párování, telefon si pamatuje starší spojení, nebo se obě zařízení „hádají" o poslední připojený přístroj.