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

Druhý krok je pochopit autentizaci. Většina API vyžaduje klíč, který si vygenerujete v administraci dané služby. Klíč se obvykle posílá v hlavičce požadavku, informace třeba jako autorizační token. Typická začátečnická chyba: vložíte klíč do adresy URL nebo do těla požadavku, protože to tak vidíte v nějak zařídit malou kuchyniém starém příkladu. Dnes se to nedělá. Vždy čtěte aktuální dokumentaci a klíč bezpečně ukládejte do proměnných prostředí, nikoli přímo do zdrojového kódu.

Nakonec si osvojte čtení dokumentace. Kvalitní dokumentace obsahuje příklady volání, popis parametrů a ukázky odpovědí. Pokud něčemu nerozumíte, zkuste si nejdřív najít odpověď v oficiální sekci FAQ nebo na fóru dané služby. Až když nic nenajdete, ptejte se ostatních vývojářů – ale vždy s konkrétním dotazem a s ukázkou kódu. Tímto způsobem se z vás stane schopný uživatel API, aniž byste museli projít zdlouhavým školením.

Další pastí je přehnané používání tříd. TypeScript podporuje třídy, ale v moderním vývoji se často vystačíte s objekty a funkcemi. Třídy mají smysl tam, kde potřebujete zapouzdření a dědičnost, ale pro většinu API volání a transformací dat stačí obyčejný interface. Pokud zjistíte, že vaše třída má jen metody bez stavu, změňte ji na funkci. Tím se kód zjednoduší a typy budou čitelnější.

Redux není sklad každé maličkosti Základní pravidlo, které se často porušuje: do Reduxu patří jen globální stav, který sdílí více komponent nebo který je potřeba při obnovení stránky. Data z formuláře, otevřený dropdown nebo dočasně vybraná položka v seznamu do globálního úložiště nepatří. Vše, co využije jen jedna komponenta, si spravujte lokálně pomocí useState. Když totiž začnete všechno házet do store, zbytečně tím zvyšujete počet vykreslení a snižujete čitelnost kódu. Redux je mocný nástroj, ale jeho síla spočívá v disciplíně, ne v tom, že ho využijete na všechno.

Nakonec si dejte pozor na to, abyste Redux nebrali jako všelék na každý problém s Reactem. Pokud je aplikace malá a stav lokální, Redux jen přidává zbytečnou režii. Často se vyplatí začít s čistým Reactem a Redux přidat až ve chvíli, kdy skutečně narazíte na problém se sdílením stavu. Když už ho použijete, držte se zásady, že každá akce je malá, každý selektor je jednoduchý a v komponentách nečtete celý store. To je recept na to, aby se vám aplikace nerozsypala při každém přidání nové funkce.

Při tvorbě workflowů pozor na oprávnění. GitHub Actions běží s implicitními právy, která mohou být širší, Https://Wiki.man-noir.com/ než potřebujete. Pokud pipeline jen testuje, nepotřebuje právo na zápis do repozitáře. Nastavte si proto minimální oprávnění v sekci permissions – snížíte tím riziko, že útočník přes kompromitovanou akci získá přístup k vašemu kódu. Stejně tak si dejte pozor na použití secrets. Nikdy je neukládejte přímo do YAML souboru a vždy je odkazujte přes GitHub Secrets. A pokud používáte self-hosted runnery, nikdy na nich nespouštějte workflow z nepřátelských forků bez izolace – to je častý bezpečnostní průšvih.

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.

Co se týče samotných akcí, snažte se psát je tak, aby byly idempotentní – tedy aby jejich opakované spuštění nezpůsobilo problémy. To platí zejména při nasazování, kde opakovaný běh nesmí vytvořit duplicitní release nebo přerušit běžící službu. Mějte také na paměti, že Actions je vázané na GitHub – pokud váš projekt migruje na jinou platformu, budete muset pipeline přepsat. U klasických CI serverů je portace obvykle jednodušší, protože používají univerzálnější konfiguraci.

Až získáte první zkušenosti, zkuste upravit délku sprintu. Kratší sprint (jeden týden) vám dá rychlejší zpětnou vazbu, ale vyžaduje disciplínu. Delší sprint (čtyři týdny) zase dává více času na velké úkoly, ale zvyšuje riziko změn požadavků. Rozhodujte se podle povahy projektu, ne podle módy. Pamatujte: Scrum je framework, ne hotové řešení. Přizpůsobte si ho tak, aby vám pomáhal, ne aby vám komplikoval život. A pokud tým přestane dodržovat pravidla, vraťte se k principům – otevřenosti, odvaze a úctě.

If you adored this article and you would like to receive more info relating to Miklagaard.no kindly visit the web page.