https://wiki.rettungsdienstblog.eu/api.php?action=feedcontributions&feedformat=atom&user=AdolfoCaird1334 2026-09-11T22:32:24Z Benutzerbeiträge MediaWiki 1.37.1 https://wiki.rettungsdienstblog.eu/index.php?title=5_z%C3%A1sad,_d%C3%ADky_nim%C5%BE_commit_zpr%C3%A1vy_skute%C4%8Dn%C4%9B_slou%C5%BE%C3%AD_zp%C4%9Btn%C3%A9_dohledatelnosti&diff=206220 2026-08-29T06:02:49Z

<p>AdolfoCaird1334: Die Seite wurde neu angelegt: „Jak se vyhnout častým pastím při návrhu API Častou pastí je nezohlednit, že klient může posílat neplatná data. Validace je nezbytná nejen pro bezpečnost, ale i pro konzistenci dat v databázi. Použijte jednoduchou validační vrstvu, která zkontroluje typy polí a povinné atributy. Nikdy nespoléhejte na to, že data přijdou v očekávaném formátu. Nezapomeňte také na ošetření chyb z databáze — duplicitní záznamy, porušení…“</p> <hr /> <div>Jak se vyhnout častým pastím při návrhu API Častou pastí je nezohlednit, že klient může posílat neplatná data. Validace je nezbytná nejen pro bezpečnost, ale i pro konzistenci dat v databázi. Použijte jednoduchou validační vrstvu, která zkontroluje typy polí a povinné atributy. Nikdy nespoléhejte na to, že data přijdou v očekávaném formátu. Nezapomeňte také na ošetření chyb z databáze — duplicitní záznamy, porušení cizích klíčů nebo nedostupnost databáze by měly vrátit příslušný HTTP status, ne jen univerzální 500.&lt;br&gt;&lt;br&gt;Základní princip je jednoduchý: definujete rozhraní pomocí interface nebo type. Tím určíte, jak má vypadat objekt, funkce nebo proměnná. Když pak někdo předá špatný tvar dat, editor to okamžitě podtrhne. Ale pozor na častý začátečnický omyl – používání any všude, kde si nejste jistí. Tím obcházíte celý smysl TypeScriptu a vracíte se k dynamickým problémům. Pokud nevíte typ, zkuste nejdřív union typy nebo generika, ne any.&lt;br&gt;&lt;br&gt;Největší sílu TypeScriptu oceníte při práci s API. Místo abyste ručně psali typy pro každou odpověď, vygenerujte je z OpenAPI specifikace. Existuje na to řada nástrojů, ale jde to i ručně – definujte si interface pro každý endpoint. Tím získáte jistotu, že data z backendu mají přesně ty vlastnosti, které očekáváte. Typická chyba je ale přehnaná důvěra v aserce typu. Použití operátoru as by mělo být výjimka, ne pravidlo. Radši ověřte data runtime, než je prohlásíte za určitý typ.&lt;br&gt;&lt;br&gt;Jak strukturovat zprávu, aby byla čitelná i za rok Dobrá zpráva má dva oddíly: předmět a tělo. Předmět je věta, která shrnuje podstatu. Tělo pak rozvádí důvody, případně souvislosti – co bylo předtím, co teď a proč. Typickou chybou je psát jen předmět a tělo vynechat. Pokud je změna netriviální, tělo je nezbytné. Použijte třeba odrážky pro výčet důsledků, ale držte se věcného tónu. Vyhněte se emocím a obecným frázím – místo „zlepšeno&quot; napište konkrétně „snížena spotřeba paměti o 15 % díky cachování výsledků dotazu&quot;.&lt;br&gt;&lt;br&gt;Při práci s třídami a dědičností můžete narazit na problém s modifikátory přístupu. TypeScript podporuje public, private a protected. Mnoho vývojářů ale zapomíná, že private je čistě záležitost kompilace – v běhovém prostředí se stejně chová jako veřejná vlastnost. Pro skutečné zapouzdření použijte JavaScriptové #, které je nativně podporované. Kombinace obojího je ale zbytečná, vyberte si jeden přístup a držte se ho.&lt;br&gt;&lt;br&gt;Když přijdete z čistého JavaScriptu, může TypeScript působit jako zbytečná byrokracie. Ale první týden vývoje vám ukáže pravý opak. TypeScript není nový jazyk, ale nadstavba, která přidává typy do existujícího kódu. Díky tomu odhalíte chyby už při psaní, ne až při běhu v prohlížeči. Například místo abyste hledali, proč funkce vrací undefined, vám kompilátor řekne, že parametr nemá povolenou hodnotu null.&lt;br&gt;&lt;br&gt;Nezanedbávejte ani bezpečnost. HTTPS je dnes samozřejmostí, ale stejně důležité je omezení počtu požadavků (rate limiting). To ochrání API před přetížením a hrubou silou. Dále si pohlídejte, aby citlivá data nebyla v odpovědích, které nepotřebujete — typicky hesla nebo interní identifikátory. Vždy si položte otázku, co přesně má klient obdržet, a podle toho navrhněte odpověď.&lt;br&gt;&lt;br&gt;Na závěr se zamyslete nad logováním a monitoringem. Dobré logy vám pomohou najít příčinu problému, když něco selže. Zaznamenávejte nejen chyby, ale i úspěšné požadavky s časovými údaji. To vám umožní odhalit pomalé endpointy a optimalizovat je. S těmito návyky se vaše REST API stane robustní základnou, na které můžete stavět další aplikace.&lt;br&gt;&lt;br&gt;Důležité je také správně zacházet s asynchronním kódem. Express 5 podporuje async/await nativně, ale v Express 4 musíte chyby z asynchronních funkcí předávat pomocí next(err). Pokud tak neučiníte, aplikace může spadnout nebo zůstat viset bez odpovědi. Vždy obalujte asynchronní routy do pomocné funkce, která zachytí odmítnuté promise a předá je do middleware pro zpracování chyb. Tím zajistíte, že i neočekávaná chyba vrátí uživateli srozumitelnou odpověď.&lt;br&gt;&lt;br&gt;Poslední rada: pište zprávy v jazyce, kterému rozumí celý tým. Většinou je to angličtina, ale pokud jsou členové týmu Češi, klidně pište česky. Důležité je, aby to bylo jednotné a srozumitelné. A když si nejste jistí, jestli je zpráva dobrá, zkuste si představit, že podle ní máte za rok vysvětlit změnu novému kolegovi. Pokud to nejde, zprávu přepište. Smysluplné commit zprávy nejsou luxus, ale základní hygieny projektu – ušetří vám i ostatním spoustu času a nervů.&lt;br&gt;&lt;br&gt;Při návrhu REST API s Node.js a Express často narazíte na rozdíl mezi tím, jak se API tváří ve vývojovém prostředí a jak se chová v produkci. Nejde jen o to, aby endpointy vracely správná data, ale také o to, aby byly stabilní, bezpečné a snadno udržovatelné. Klíčové je myslet na strukturu hned od začátku — ne až ve chvíli, kdy se projekt rozroste o stovky tras.</div>

AdolfoCaird1334 https://wiki.rettungsdienstblog.eu/index.php?title=Benutzer:AdolfoCaird1334&diff=206215 2026-08-29T06:02:46Z

<p>AdolfoCaird1334: Die Seite wurde neu angelegt: „Váš průvodce světem interiérů se zabývá denně. Sdílím zde, jak zvládnout domácnost bez stresu. Nejraději hledat cesty, jak si usnadnit život.“</p> <hr /> <div>Váš průvodce světem interiérů se zabývá denně. Sdílím zde, jak zvládnout domácnost bez stresu. Nejraději hledat cesty, jak si usnadnit život.</div>

AdolfoCaird1334