JSON prakticky: zápis, chyby a jejich opravy

JSON je dnes výchozí formát pro API a konfigurace. Návod vysvětluje pravidla zápisu, ukazuje chyby, na které Češi narážejí nejčastěji, a jak je rychle opravit.

Otevřít nástroj: JSON formátovač

Datové typy v JSON

JSON zná jen šest typů: objekt {}, pole [], řetězec v dvojitých uvozovkách, číslo, true nebo false a null. Datum žádný vlastní typ nemá, obvykle se zapisuje jako řetězec ve formátu ISO 8601, například "2026-11-18T09:30:00+01:00".

Klíče musí být vždy řetězce ve dvojitých uvozovkách. Hodnoty mohou být libovolně vnořené.

Jak číst chybovou hlášku

Prohlížeč a většina knihoven hlásí chyby jako Unexpected token } in JSON at position 214. Formátovač stejné místo převede na řádek a sloupec a řekne, co tam chybí, třeba čárka nebo uzavírací závorka.

Chyba bývá často o řádek výš, než hláška ukazuje. Když chybí čárka na konci řádku 12, parser si toho všimne až na začátku řádku 13.

Cesty k hodnotám

Ve stromovém zobrazení můžete klepnout na libovolnou hodnotu a zkopírovat její cestu, například $.objednavky[2].polozky[0].cena. Takovou cestu pak použijete v JavaScriptu, v jq nebo v nástrojích pro testování API, jako je Postman.

Velká čísla a ID

JavaScript umí přesně uložit jen celá čísla do 9 007 199 254 740 991. Delší ID, například z databáze nebo bankovního systému, JSON.parse potichu zaokrouhlí. Tento formátovač je zachová přesně a upozorní na ně. V API je bezpečnější posílat dlouhá ID jako řetězce.