JSON

Příklady z praxe

1. 01

   Odpověď objednávkového API

   E-shop po úspěšné platbě vrátí frontendu JSON s číslem objednávky, stavem a položkami košíku. Frontend z odpovědi vykreslí potvrzení nákupu a zákazník vidí stejná data, která backend uloží do objednávkového systému.

   {
     "orderId": "A-1024",
     "status": "paid",
     "total": 1290,
     "currency": "CZK",
     "items": [
       { "sku": "TSHIRT-BLK-M", "quantity": 2 }
     ]
   }

2. 02

   Konfigurace funkcí aplikace

   Aplikace při startu načte JSON konfiguraci a podle ní zapne nový checkout jen v produkčním prostředí. Špatně zapsaná koncová čárka by soubor zneplatnila a nasazení by mohlo skončit chybou už při inicializaci.

   {
     "env": "production",
     "features": {
       "newCheckout": true,
       "debugToolbar": false
     },
     "timeoutMs": 5000
   }

Časté omyly

MýtusJSON je prostě objekt v JavaScriptu.

Ve skutečnostiJSON je textový zápis dat, zatímco objekt v JavaScriptu je hodnota v paměti programu. Podobnost syntaxe svádí k záměně, ale JSON má přísnější pravidla a musí se parsovat.

MýtusDo JSON můžu dát komentář, parser si ho nějak poradí.

Ve skutečnostiStandardní JSON komentáře nepovoluje. Některé nástroje přijímají rozšířený zápis, ale takový soubor nemusí projít v jiném prostředí nebo v běžném API klientovi.

MýtusJSON automaticky zaručí správné typy dat.

Ve skutečnostiJSON zaručuje jen základní syntaktické typy, například řetězec, číslo, objekt nebo pole. Povinná pole, přesné rozsahy a význam hodnot musí ověřit aplikace, databáze nebo validační schéma.

Časté dotazy

Kdy je JSON vhodný formát pro data?

JSON se vyplatí použít tam, kde si aplikace předávají běžná strukturovaná data: objekty, seznamy, texty, čísla a logické hodnoty. JSON je dobrou volbou pro webová API, konfigurační soubory generované nástroji nebo jednoduché datové exporty. JSON není ideální pro velké binární soubory, proudová data s extrémním objemem nebo situace, kde je nutná přesná typová informace přímo ve formátu.

Proč může JSON způsobit problém s velkými čísly?

JSON dovoluje zapsat číslo, ale neříká, jestli má jít o celé číslo, desetinné číslo s pevnou přesností nebo hodnotu s libovolnou přesností. Cílový jazyk nebo knihovna může velká čísla zaokrouhlit, pokud je ukládá do typu s omezenou přesností. JSON dokumenty s penězi, identifikátory nebo velmi velkými čísly proto často ukládají citlivé hodnoty jako řetězce nebo je validují samostatně.

Může JSON obsahovat komentáře?

JSON jako formát komentáře nepodporuje, takže zápis s // nebo /* */ není platný JSON. Konfigurační soubory, které komentáře dovolují, obvykle používají rozšíření formátu nebo jiný parser, například JSONC v některých vývojářských nástrojích. Přenosová API by se měla držet čistého JSON, protože klienti nemusí rozšířený zápis umět zpracovat.

K čemu se u JSON používá JSON Schema?

JSON Schema není součástí samotného JSON dokumentu, ale samostatný popis pravidel pro jeho validaci. JSON Schema může určit povinná pole, typy hodnot, povolené rozsahy, formát řetězců nebo strukturu vnořených objektů. JSON bez schématu říká pouze syntaxi dat, zatímco schéma pomáhá ověřit, jestli data odpovídají očekávanému kontraktu mezi systémy.

Zdroje

1. RFC 8259: The JavaScript Object Notation (JSON) Data Interchange Format(otevře se v novém okně)RFC Editor, 2017
2. ECMA-404 - The JSON data interchange syntax(otevře se v novém okně)Ecma International, 2017
3. JSON(otevře se v novém okně)MDN Web Docs

Související pojmy

• REST APIREST API je způsob návrhu webového rozhraní, kde klient pracuje se zdroji přes jednotné HTTP operace a server vrací jejich reprezentace, typicky ve formátu JSON. Důraz klade na jednoznačné adresy, bezstavovou komunikaci, cachování a oddělení klienta od serveru, ne na konkrétní knihovnu ani protokol navíc.
• GraphQLGraphQL je dotazovací jazyk a běhové prostředí pro API, ve kterém klient přesně popíše, jaká data chce dostat, a server odpoví ve stejném tvaru. Nejčastěji se používá nad HTTP, ale není databází ani transportním protokolem; hlavní hodnotou je typované schéma, flexibilní dotazy a evoluce API bez mnoha verzí.
• 3D model3D model je digitální reprezentace objektu nebo prostoru ve třech rozměrech, složená z geometrie, materiálů a často i textur, animací či fyzikálních vlastností. Používá se v hrách, filmech, průmyslovém návrhu, architektuře, e-commerce i simulacích, kde software z modelu počítá zobrazení nebo další data.
• ACIDACID je sada čtyř vlastností databázové transakce: atomicity, consistency, isolation a durability. Zaručuje, že skupina zápisů proběhne jako jeden celek, neporuší definovaná pravidla databáze, nebude se nebezpečně míchat s jinými transakcemi a po potvrzení přežije pád systému, například při převodu peněz.
• Adaptive IconAdaptivní ikona je formát ikony aplikace na Androidu, který se místo jedné hotové bitmapy skládá z oddělených vrstev: pozadí a popředí. Systém výsledný tvar sám ořízne podle masky výrobce zařízení a může vrstvy animovat nebo přebarvit. Vývojář tak dodá jeden zdroj a launcher z něj vytvoří kruh, čtverec i squircle.
• Adresa v pamětiAdresa v paměti je číslo, kterým procesor jednoznačně označuje konkrétní buňku operační paměti, obvykle jeden bajt. Program pomocí adresy říká, odkud má data načíst nebo kam je zapsat. Adresy tvoří souvislý číselný rozsah, jehož velikost určuje šířka adresní sběrnice a architektura, typicky 32 nebo 64 bitů.
• AI agentAI agent je softwarový systém, který pomocí modelu umělé inteligence vnímá zadaný kontext, plánuje další kroky a samostatně volá nástroje nebo služby k dosažení cíle. Na rozdíl od jednorázového promptu udržuje stav úlohy, vyhodnocuje výsledky akcí a může opakovat postup, dokud nesplní zadání nebo nenarazí na limit.
• Alfa kanálAlfa kanál je složka obrazových dat, která u pixelu určuje míru neprůhlednosti nebo průhlednosti. Doplňuje barevné kanály, typicky RGB, a umožňuje plynulé okraje, stíny, překryvy, masky i skládání vrstev. Hodnota alfa sama neurčuje barvu, ale říká, jak se barva pixelu promíchá s pozadím.