Jak Postavit REST API S Node.js A Express

Stavba REST API v Node.js s frameworkem Express je běžná praxe, ale i tak se v ní snadno udělá několik zásadních chyb. Začneme od základu – od inicializace projektu a instalace potřebných balíčků. Kromě samotného Expressu se vyplatí použít i balíček pro parsování těla požadavků (např. body-parser) a pro logování požadavků (např. morgan). Tyto nástroje vám ušetří spoustu ruční práce a zpřehlední ladění.

Když už máte základní routy, přichází na řadu validace dat. Nikdy nevěřte vstupům z klienta. Použijte knihovnu jako Joi nebo express-validator, abyste ověřili, že data mají správný formát, délku a typ. Bez validace riskujete neošetřené chyby, které mohou vést k pádu serveru nebo k bezpečnostním děrám. Typická chyba je zapomenout na zpracování chyb v async funkcích. Pokud v async handleru dojde k výjimce a nemáte ji odchycenou, Express ji sám nezachytí – musíte použít wrapper nebo try/catch a předat chybu do next().

Při návrhu API myslete na to, že cesty by měly být srozumitelné a odpovídat REST principům. Používejte množná čísla pro názvy zdrojů (např. /users), identifikátory v URL (např. /users/:id) a správné HTTP metody. Vyhněte se zbytečnému vnořování rout a udržujte je ploché. Velkou chybou je také nevracet vhodné HTTP status kódy – 200 pro úspěch, 201 pro vytvoření, 404 pro nenalezeno, 400 pro špatný požadavek a 500 pro neošetřenou chybu.

Async operace řešte přes createAsyncThunk, ne přes ručně psané thunky. Tento nástroj automaticky generuje akce pro pending, fulfilled a rejected stavy, což eliminuje duplicitní kód a zjednodušuje handling chyb. Nezapomeňte na to, že akce by měly být serializovatelné – do stavu neukládejte Promise, funkce ani instance tříd. To je častý zdroj chyb při kombinaci Reduxu s TypeScriptem.

Typickou chybou je nesprávné ověřování podpisu na straně serveru. Vždy ověřte podpis, expiraci, ale i to, že token byl vydán pro vaši API (audience) a že pochází od vás (issuer). Ignorování těchto nároků umožňuje útočníkovi použít token z jiné služby. Také kontrolujte, že token nebyl revokován. Pokud máte požadavek na okamžité odvolání přístupu (např. při změně hesla), musíte mít na serveru seznam zneplatněných tokenů (např. v paměti nebo v databázi). JWT je statický, takže sám o sobě neumožňuje zneplatnění před expirací.

Životní cyklus tokenu a jeho expirace JWT token by měl mít krátkou dobu platnosti, typicky minuty až hodiny, přejít na web ne dny. Dlouhá expirace zvyšuje riziko zneužití, pokud token unikne. Pro prodloužení přístupu používejte refresh tokeny, které jsou uložené na serveru, mají delší platnost a lze je odvolat. Při každém obnovení přístupového tokenu ověřte, že refresh token je stále platný a že uživatel má stále oprávnění. Nikdy neposílejte token v URL, protože se může zalogovat do historie prohlížeče nebo proxy serveru. Používejte hlavičku Authorization s formátem 'Bearer '.

If you liked this article and you also would like to receive more info concerning úložné prostory v maléM bytě please visit our own webpage. jak zařídit malou kuchyni se vyhnout nejčastějším chybám Mezi časté chyby patří ignorování životního cyklu aktivity. Každá aktivita prochází stavy jako onCreate, onStart nebo onPause. Pokud je ignorujete, může aplikace spadnout při otočení obrazovky nebo při přepnutí do pozadí. Uložte si data v metodě onSaveInstanceState a obnovte je v onCreate. Další chybou je zapomínání na oprávnění – pokud aplikace potřebuje přístup k internetu nebo k poloze, musíte je deklarovat v manifestu. Až budete testovat, vždy zkuste aplikaci spustit na emulátoru i na reálném zařízení, abyste odhalili rozdíly ve výkonu.

Dalším problémem je přehnané používání selektorů. Když každou hodnotu vybíráte přes useMemo jen proto, aby se negeneroval nový objekt, zbytečně zatěžujete paměť. Využívejte selektory z knihovny reselect, které umožňují memoizaci závislostí. Ale i zde platí – selektor by měl být malý a zaměřený na konkrétní část stavu. Pokud se stav mění často, zvažte, zda není lepší část dat uložit do lokálního státu komponenty.

Na závěr nezapomeňte na testování. Napište alespoň základní jednotkové testy pro nejdůležitější endpointy. Můžete použít vestavěný testovací modul node:test nebo knihovnu Jest. Testy vám odhalí chyby dřív, než je objeví uživatelé. Také si nastavte prostředí s automatickým restartem serveru (např. nodemon) a proměnnou prostředí pro port. Nikdy nehardcodujte port a další konfiguraci přímo do kódu – použijte soubor .env. Tím zajistíte, že se API snadno nasadí do jiného prostředí.

Jádrem každého API jsou routy. V Expressu definujete jednotlivé endpointy pomocí metod GET, POST, PUT a DELETE. Pro začátek si vytvořte jednoduchou routu, která vrací JSON data. Pozor na to, že Express sám o sobě neumí zpracovat tělo požadavku ve formátu JSON – proto je nutné použít middleware express.json(). Bez něj byste v req.body dostali undefined. Dalším častým problémem je nesprávné nastavení CORS, zejména pokud API voláte z prohlížeče. Pokud CORS nenastavíte, prohlížeč vám odpověď zablokuje.