JSON: formát, kterým si systémy předávají data

Jak JSON vypadá

Data se zapisují jako dvojice „název: hodnota“. Složené závorky ohraničují jeden objekt, hranaté seznam. Takhle by mohla vypadat zjednodušená objednávka:

{
  "cislo": "2026-0142",
  "zaplaceno": true,
  "poznamka": null,
  "zakaznik": {
    "jmeno": "Jana Nováková",
    "email": "jana@example.cz"
  },
  "polozky": [
    { "kod": "HRN-01", "nazev": "Hrnek", "kusy": 2, "cena": 249.5 },
    { "kod": "PODT-03", "nazev": "Podtácek", "kusy": 4, "cena": 59 }
  ]
}

Jak se v JSON vyznat

Když dostanete delší výpis, nečtěte ho od začátku do konce. Hledejte názvy údajů – ty bývají anglicky nebo zkratkou, ale většinou srozumitelné (email, price, status). Pro přesné určení, o který údaj jde, se používá „cesta“ přes jednotlivé úrovně, kterou vám může napsat i dodavatel:

• zakaznik.email – e-mail uvnitř objektu zákazníka,
• polozky[0].nazev – název první položky; programy počítají pořadí od nuly, ne od jedničky,
• chybějící údaj a údaj s hodnotou null nemusí znamenat totéž – jak s nimi zacházet, ověřte v dokumentaci dané služby.

Odsazení na začátku řádků je jen pro lidi. Stejná data můžou přijít na jednom dlouhém řádku a pořád jsou platná.

Kde se s JSON potkáte

• Propojení systémů. Odpovědi API i zprávy, které systém pošle sám přes webhook, mají skoro vždy podobu JSON. Když propojení selže, v záznamu chyb uvidíte právě je.
• Export dat. Hlavně cloudové služby nabízejí vedle CSV i export do JSON. Na to, jestli z nějaké služby data opravdu dostanete, se vyplatí ptát ještě před tím, než se pro SaaS rozhodnete.
• Kód stránky. Blok pro vyhledávače, který popisuje firmu nebo produkt, se zapisuje ve variantě JSON-LD – víc v hesle Strukturovaná data.
• Nastavení. Konfigurace aplikací, doplňků nebo manifest instalovatelné PWA bývají také soubory JSON.

JSON, CSV a XML vedle sebe

Pro srovnávače zboží se dodnes používá hlavně XML, jak popisuje heslo XML feed.

Chyby, na kterých se zápis nejčastěji rozbije

JSON je přísný. Jedna čárka navíc a program soubor odmítne celý. Typické prohřešky:

{
  'nazev': "Hrnek",          ← jednoduché uvozovky nejsou povolené
  "nazev": „Hrnek“,          ← typografické uvozovky z Wordu taky ne
  "cena": 249,50,            ← desetinná čárka rozdělí číslo
  "kusy": 2,                 ← čárka za poslední položkou
}

• Textové editory a Word rády nahradí rovné uvozovky českými „…“. Do JSON proto nekopírujte přes Word ani e-mail.
• Komentáře standardní JSON nezná; šipky v ukázce jsou jen vysvětlení pro vás.
• Uvozovka nebo zpětné lomítko v textu se musí zapsat se zpětným lomítkem před sebou, jinak text předčasně skončí.

Jak chybu najít

1. Vložte text do validátoru nebo editoru, který JSON kontroluje. Ukáže řádek a pozici chyby.
2. Podívejte se i na řádek nad tím – chybějící čárka nebo uvozovka se často projeví až na dalším údaji.
3. Nechte si zápis naformátovat s odsazením. Neuzavřená závorka je pak hned vidět.

Pozor na citlivá data: soubor s údaji zákazníků nebo s přístupovými klíči nevkládejte do neznámých online nástrojů. Použijte editor ve vlastním počítači.

Propojení, kde si systémy předávají data v JSON, u nás vždy začíná odhadem: sepíšeme rozsah, naceníme ho předem a teprve potom začneme. Práce se počítá hodinovou sazbou 1 000 Kč.

Časté otázky

Mohlo by vás zajímat