Co všechno potřebujete znát, než začnete s API?

Na závěr vždy testujte na reálném zařízení. Emulátor v prohlížeči neukáže, jak stránka funguje na malém displeji s prstem. Nenutila bych vás do drahých nástrojů – stačí otevřít stránku v telefonu a projít hlavní scénáře. Všímejte si, kde mají prsty tendenci ujíždět, jestli se text nepřekrývá, a jestli se vám tlačítka mačkají pohodlně. Tento pětiminutový test odhalí víc než hodina teorie.

Text a hierarchie: kde začíná většina problémů Když už máte rozvržení, zaměřte se na typografii. Nejdůležitější není zvolit hezký font, ale nastavit správnou hierarchii. Nadpis má být vizuálně odlišen od běžného textu – ne tím, že ho uděláte tučně, ale tím, že mu dáte jasně větší velikost a vzduch kolem. Podobně odkazy by měly být odlišeny nejen barvou, ale i podtržením, protože barva sama o sobě nestačí pro barvoslepé uživatele. Základní pravidlo: řádkování 1,5 a délka řádku 60–80 znaků. Pokud text sahá přes celou šířku monitoru, je nečitelný – omezte šířku kontejneru.

Na co si dát pozor při zpracování odpovědi Nejčastější problém začátečníků je, že předpokládají, že odpověď přijde ve formátu, který se jim líbí. Realita je taková, že většina API vrací JSON a vy si musíte data sama zpracovat. Začněte tím, že si odpověď nejdřív vypíšete do konzole a prohlédnete si její strukturu. Teprve potom pište kód, který z ní vytáhne konkrétní hodnoty. Pozor na to, že JSON může obsahovat vnořené objekty a pole – přístup k nim se liší podle programovacího jazyka, ale princip je vždy stejný: jdete po klíčích.

Další častý problém je ignorování velikosti dotykových cílů. Na desktopu klidně umístíte tlačítko o velikosti 20 pixelů, ale na mobilu je to pod hranicí pohodlného ovládání. Uživatelé pak omylem klikají vedle a stránka se jim zdá rozbitá. Řešení je jednoduché: nastavte minimální velikost 44×44 pixelů pro všechny klikací prvky a mezi nimi ponechte alespoň 8 pixelů mezeru. Pokud pracujete s frameworkem, využijte jeho výchozí komponenty – mívají tyto hodnoty už přednastavené. Jen pozor na to, že některé frameworky u tlačítek nastavují menší klikací plochu, než je viditelný prvek – to je past, kterou snadno přehlédnete.

Až budete mít větev hotovou, zamyslete se nad tím, jak ji začleníte. Pokud pracujete sami, můžete použít fast-forward merge, který je čistý a jednoduchý. Pokud ale pracujete v týmu, je lepší použít merge commit se zprávou, která odkazuje na úkol. Tím zůstane historie přehledná a budete vědět, která změna souvisí s kterým úkolem. Nezapomeňte po začlenění smazat větev, a to i na vzdáleném úložišti. Udržování starých větví jenom zvyšuje šum a riziko, že někdo omylem začne stavět na zastaralé verzi. Správné verzování není o tom, znát spoustu příkazů, ale o tom, dodržovat pravidla, která udělají práci přehlednou.

První volání a čtení odpovědi Když máš otestováno, přejdi k psaní kódu. Vyber si jazyk, který tě baví – nejjednodušší je Python s knihovnou requests. Stačí napsat pět řádků: import knihovny, definování endpointu, odeslání požadavku, kontrola stavu odpovědi a vytištění dat. Stavový kód 200 znamená úspěch, 404 znamená že zdroj neexistuje, 401 že nemáš oprávnění. Nikdy nepředpokládej, že požadavek prošel – vždy kontroluj stav. Dalším častým problémem je špatné parsování JSON. Někdy API vrací data, která nejsou ve formátu, který očekáváš, takže používej strukturu z odpovědi jako vodítko.

Jakmile máš základní představu, přejdi k praktickému testování. Místo abys hned psal celý program, použij nástroj na testování API. Takový nástroj ti umožní zadat endpoint, metodu a případně hlavičky (headers) a pak vidíš kompletní odpověď. Tímto způsobem snadno zjistíš, jestli API funguje, jaká data vrací a jaké chyby se objevují. Typická chyba začátečníka je, že přeskočí tuto fázi a rovnou píše kód. If you liked this post and you would like to receive far more facts relating to Ingeekswetrust.De kindly visit our web page. Pak tráví hodiny hledáním chyby, která je jen v tom, že špatně zadal hlavičku nebo zapomněl na parametr. Testováním ušetříš spoustu času.

Čemu se vyhnout, když začínáte s DevOps Typická chyba je začít nákupem nástrojů a teprve potom hledat problém. Nástroj, který nikdo nechce používat, je jen další položka v rozpočtu. Místo toho si nejdřív napište, co konkrétně vás brzdí. Třeba: „Nasazení trvá dva dny, protože se čeká na ruční schválení." Pak se rozhodnete, jestli potřebujete automatizaci testů, nebo změnu procesu schvalování. Někdy stačí zrušit zbytečný rekonstrukce koupelny krok za krokem a nasazení se zrychlí bez jediného nového nástroje.

Důležité je také respektovat omezení API. Mnoho služeb má limity na počet volání rekonstrukce koupelny krok za krokem minutu nebo den. Pokud je ignorujete, dostanete se do stavu, kdy vás API dočasně zablokuje. Praktické pravidlo: mezi jednotlivé požadavky vkládejte krátkou prodlevu a používejte techniku takzvaného backoffu – když dostanete chybu 429, počkejte o něco déle a zkuste to znovu.