JSON

JSON (z anglického JavaScript Object Notation) je lehký, textový a člověkem čitelný formát pro výměnu a ukládání strukturovaných dat. Původně vznikl jako podmnožina jazyka JavaScript, dnes je však nezávislý na jakémkoli programovacím jazyce a podporován téměř všemi moderními technologiemi.

JSON se často používá pro:

• komunikaci mezi klientem a serverem (např. v REST API),
• konfigurační soubory,
• ukládání nestrukturovaných nebo polostrukturovaných dat (např. v NoSQL databázích jako MongoDB).

JSON podporuje následující základní datové typy:

• String – text uzavřený v dvojitých uvozovkách: `„Ahoj“`
• Number – celá nebo desetinná čísla (bez uvozovek): `42`, `-3.14`, `1.23e5`
• Boolean – logické hodnoty: `true`, `false`
• Null – prázdná hodnota: `null`
• Object – neuspořádaná množina dvojic klíč–hodnota (tzv. „mapa“ nebo „slovník“), uzavřená do složených závorek `{}`.
• Array – uspořádaný seznam hodnot, uzavřený do hranatých závorek `[]`.

❗ Důležité: V JSON musí být vždy použity dvojité uvozovky (`„`). Jednoduché uvozovky (`'`) nejsou platné.

{
  "jmeno": "Jan",
  "prijmeni": "Novák",
  "vek": 32,
  "student": false,
  "email": null,
  "konicky": ["čtení", "běhání", "programování"],
  "adresa": {
    "ulice": "Náměstí Míru 123",
    "mesto": "Praha",
    "psc": "110 00",
    "zeme": "Česká republika"
  }
}

• Klíče (názvy vlastností) musí být řetězce v dvojitých uvozovkách.
• Hodnoty mohou být libovolného platného JSON typu.
• Čárky oddělují jednotlivé prvky (v poli) nebo dvojice klíč–hodnota (v objektu).
• Na konci posledního prvku v objektu nebo poli nesmí být čárka (tzv. „trailing comma“ – není v základním JSON povolena, i když některé knihovny ji tolerují).
• Komentáře nejsou v oficiálním JSON standardu podporovány.

Nesprávný JSON (běžné chyby):

{
  'jmeno': 'Jan',       // ❌ Jednoduché uvozovky
  vek: 32,              // ❌ Klíč bez uvozovek
  konicky: ["a", "b",], // ❌ Čárka na konci pole
  // komentář          // ❌ Komentáře nejsou povoleny
}

• Webová API: Většina REST API vrací data ve formátu JSON (např. `Content-Type: application/json`).
• Konfigurační soubory: Např. `package.json` v Node.js, `tsconfig.json` v TypeScriptu.
• NoSQL databáze: MongoDB, CouchDB a Firebase ukládají data jako JSON dokumenty.
• Ukládání dat v aplikacích: Mnoho desktopových i mobilních aplikací používá JSON pro lokální ukládání nastavení nebo dat.

Příklad v JavaScriptu:

const data = JSON.parse('{"jmeno":"Jan","vek":32}');
console.log(data.jmeno); // "Jan"
 
const jsonStr = JSON.stringify(data);
// Vrátí: '{"jmeno":"Jan","vek":32}'

Příklad v Pythonu:

import json
 
data = {"jmeno": "Jan", "vek": 32}
json_str = json.dumps(data, ensure_ascii=False)
# Výstup: {"jmeno": "Jan", "vek": 32}
 
obj = json.loads('{"jmeno": "Eva"}')
print(obj["jmeno"])  # "Eva"

• RFC 8259 – oficiální specifikace JSON (nahrazuje původní RFC 7159).
• MIME typ: `application/json`
• Přípona souboru: `.json`
• Kódování: JSON musí být v kódování UTF-8, UTF-16 nebo UTF-32, přičemž UTF-8 je doporučeno.

• JSON5 – rozšíření JSON s podporou komentářů, jednoduchých uvozovek, trailing čárek atd. (není kompatibilní s čistým JSON).
• JSON Schema – jazyk pro popis a validaci struktury JSON dat.
• jq – příkazový nástroj pro filtrování a transformaci JSON v terminálu.
• YAML – alternativní formát, který je člověkem ještě lépe čitelný, ale složitější.

• JSON injection – pokud se data z JSON nevalidují, mohou být použita k útokům (např. XSS).
• Prototype pollution – v JavaScriptu může škodlivý JSON manipulovat s vlastnostmi objektů (zejména při použití `JSON.parse()` s nebezpečnými knihovnami).
• Únik dat – konfigurační soubory `.json` často obsahují citlivé údaje (API klíče, hesla) – nikdy je neukládej do veřejných repozitářů!

• XML
• CSV
• REST API
• JSON Schema
• NoSQL
• MIME typy

• Oficiální web: https://www.json.org/json-cs.html
• RFC 8259: https://datatracker.ietf.org/doc/html/rfc8259
• JSON Schema: https://json-schema.org
• JSON Validator: https://jsonlint.com

• API
• Datové formáty
• Kódování znaků
• Konfigurační soubory