Čo je JSON? Jednoduchý sprievodca s príkladmi

JSON (JavaScript Object Notation) je jednoduchý textový formát na zápis štruktúrovaných dát — napríklad zákazníka, objednávky alebo zoznamu produktov — ako dvojíc názvov a hodnôt. Ľuďom sa ľahko číta a programom sa ľahko vytvára a spracováva. Keď aplikácie a služby vymieňajú dáta cez web, JSON je zďaleka najbežnejší formát.

Prečo je JSON dôležitý pri tvorbe s AI

S JSON-om sa budete stretávať neustále, aj keď nikdy nebudete písať kód:

• API. Keď obrazovky vašej aplikácie načítavajú dáta z backendu alebo backend volá platobnú, e-mailovú či AI službu, dáta zvyčajne putujú ako JSON. Pozri čo je API.
• Konfiguračné súbory. Mnohé konfiguračné súbory projektu sú JSON — napríklad package.json, ktorý vypisuje závislosti JavaScript projektu.
• Databázy. Postgres dokáže ukladať JSON do stĺpca (typ jsonb) pre dáta, ktoré sa nehodia do pravidelných riadkov a stĺpcov. Pozri čo je Postgres.
• Výstup AI. Keď chcete, aby AI model vrátil niečo, s čím môže program pracovať — zoznam značiek, vytiahnuté polia z faktúry — zvyčajne si vyžiadate JSON.
• Chybové hlásenia a logy. Mnohé chyby prichádzajú ako JSON a ich čítanie je často najrýchlejší spôsob, ako zistiť, čo sa pokazilo.

Schopnosť čítať JSON vám umožní skontrolovať, čo vaša aplikácia naozaj dostala, všimnúť si chýbajúce pole a presne opísať problém nástroju na tvorbu s AI.

Každodenné prirovnanie

Predstavte si papierový formulár: Meno: ____, Telefón: ____, Odber noviniek: ☐ áno ☐ nie. Každý údaj je popisok s hodnotou vedľa neho. JSON je takýto formulár zapísaný ako text v prísnom rozložení, ktoré počítač dokáže prečítať bez hádania. A ako formuláre, aj JSON môže mať časti vnútri iných častí (adresný blok s ulicou, mestom a PSČ) a zoznamy (viacero telefónnych čísel).

Ako vyzerá JSON

Takto vyzerá jedna rezervácia v JSON:

{
  "id": 5001,
  "customer": "Lena Park",
  "service": "Haircut",
  "startsAt": "2026-10-03T14:00:00Z",
  "price": 35.5,
  "paid": false,
  "notes": null,
  "extras": ["beard trim", "hot towel"],
  "contact": {
    "email": "lena@example.com",
    "phone": "+44 20 7946 0000"
  }
}

Čítanie:

• Zložené zátvorky { } obaľujú objekt — množinu dvojíc názvov a hodnôt.
• Každá dvojica je "názov": hodnota, oddelená čiarkami.
• Hranaté zátvorky [ ] obaľujú pole — zoradený zoznam.
• Objekty a polia môžu byť vnorené jeden do druhého, ako contact a extras.

Šesť druhov hodnôt

JSON pozná iba šesť typov hodnôt. Tento malý zoznam je veľkou časťou dôvodu, prečo funguje všade.

Typ dátumu neexistuje. Dátumy sa zapisujú ako reťazce, zvyčajne vo formáte ISO 8601 zobrazenom vyššie (2026-10-03T14:00:00Z, kde Z znamená UTC). Dohoda na tomto formáte vyhne celej kategórii chýb so časovými pásmami.

Prísne pravidlá (odkiaľ sú chyby)

JSON je menej tolerantný, než sa zdá. Toto všetko je neplatné:

{ name: "Lena" }            ← kľúč bez dvojitých úvodzoviek
{ 'name': 'Lena' }          ← jednoduché úvodzovky
{ "a": 1, "b": 2, }         ← čiarka na konci
{ "a": 1 "b": 2 }           ← chýbajúca čiarka
{ "a": 1 // komentár }      ← komentáre nie sú povolené

Väčšina chýb „Unexpected token“, ktoré uvidíte, je jedna z týchto. Validátor alebo formátovač JSON ukáže presný riadok.

Ukážkový príklad: JSON cez aplikáciu

Zákazník si v aplikácii salónu rezervuje strihanie. Tu sa JSON objaví:

1. Formulár rezervácie pošle backendu aplikácie toto:

{ "service": "Haircut", "startsAt": "2026-10-03T14:00:00Z", "name": "Lena Park" }

1. Backend uloží rezerváciu do databázy a odpovie stavom 201 Created a týmto:

{ "id": 5001, "status": "confirmed" }

1. Ak je čas už obsadený, môže namiesto toho odpovedať stavom 409 Conflict a týmto:

{ "error": "slot_taken", "message": "That time was just booked. Please pick another." }

Stránka načíta status alebo error a zobrazí správnu správu. Ak by namiesto toho zobrazila prázdnu obrazovku, otvorenie vývojárskych nástrojov prehliadača (karta Network) by vám ukázalo tento JSON — často najrýchlejšiu stopu k tomu, čo sa pokazilo.

Kľúčové pojmy

Bežné omyly

• „JSON je JavaScript.“ Vznikol zo syntaxe JavaScriptu, ale nie je viazaný na jazyk; Python, Java, C#, Go a ďalšie ho všetky čítajú.
• „Čísla v úvodzovkách sú v poriadku.“ "35" je reťazec, nie číslo. Miešanie spôsobuje chyby, napríklad že "35" + "5" je "355". Peniaze sa často oplatí ukladať ako celé centy (3550), aby sa predišlo zaokrúhľovacím chybám.
• „JSON je bezpečný, lebo sú to iba dáta.“ JSON môže niesť čokoľvek, aj tajomstvá. Neukladajte API kľúče do JSON, ktorý sa posiela do prehliadača.
• „Všetko dajte do stĺpca JSON.“ Je praktický pre flexibilné doplnky, ale dáta, podľa ktorých vyhľadávate, filtrujete alebo ich spájate, patria zvyčajne do vlastných stĺpcov.
• „AI vždy vráti platný JSON.“ Modely môžu pridať extra text alebo rozbiť formát. Mnohí poskytovatelia ponúkajú režim štruktúrovaného výstupu; váš kód by aj tak mal skontrolovať, čo prišlo.

Čo požiadať od nástroja na tvorbu s AI

• „Ukáž mi príklad JSON, ktorý tento endpoint vracia.“
• „Vracaj chyby ako JSON s kódom error a čitateľnou správou message.“
• „Ukladaj dátumy ako reťazce ISO 8601 v UTC a na obrazovku prevádzaj na miestny čas až tam.“
• „Ukladaj ceny ako celé centy.“
• „Validuj prichádzajúci JSON na serveri a odmietaj požiadavky s chýbajúcimi alebo zle typovanými poľami.“
• „Keď volám AI model, vyžiadaj JSON v tomto presnom tvare a pred použitím ho skontroluj.“

JSON v Mythexe

JSON nemusíte v Mythexe písať ručne — opíšete, čo chcete, a agent napíše kód, ktorý ho posiela a číta. Pomáha však rozpoznať ho: keď sa niečo pokazí, vloženie chyby JSON do chatu dá agentovi presnú stopu. Dokumentácia receptu na REST API backend od začiatku žiada „jasné chyby v JSON“ a recept integrácia ľubovoľného API pokrýva volanie externých služieb. Pre širší kontext pozri REST vs GraphQL a ako ladiť aplikáciu vytvorenú s AI.

Otázky