Šta je JSON? Jednostavan vodič sa primerima

JSON (JavaScript Object Notation) je jednostavan tekstualni format za zapisivanje strukturisanih podataka, kao što su klijent, porudžbina ili lista proizvoda, u obliku naziva uparenih sa vrednostima. Lak je za čitanje ljudima i lak za programe da ga naprave i obrade. Kada aplikacije i servisi razmenjuju podatke preko weba, JSON je daleko najčešći format.

Zašto je JSON važan kada pravite aplikacije uz AI

JSON ćete sretati stalno, čak i ako nikada ne pišete kod:

• API-ji. Kada ekrani vaše aplikacije učitavaju podatke iz backend-a, ili kada vaš backend poziva servis za plaćanje, slanje mejlova ili AI servis, podaci najčešće putuju kao JSON. Pogledajte šta je API.
• Fajlovi sa podešavanjima. Mnogi konfiguracioni fajlovi projekta su JSON, na primer package.json, koji navodi zavisnosti JavaScript projekta.
• Baze podataka. Postgres može da čuva JSON u koloni (tip jsonb) za podatke koji se ne uklapaju u uredne redove i kolone. Pogledajte šta je Postgres.
• Izlaz AI-ja. Kada želite da AI model vrati nešto što program može da koristi, na primer listu oznaka ili izvučena polja iz računa, obično tražite JSON.
• Poruke o greškama i logovi. Mnoge greške stižu kao JSON, a čitanje njih je često najbrži način da saznate šta nije u redu.

Čitanje JSON-a vam omogućava da proverite šta je aplikacija zaista primila, primetite nedostajuće polje i precizno opišete problem svom AI alatu.

Svakodnevna analogija

Zamislite papirni obrazac: Ime: ____, Telefon: ____, Newsletter: ☐ da ☐ ne. Svaki unos je naziv sa vrednošću pored sebe. JSON je taj obrazac zapisan kao tekst, u strogom rasporedu koji računar može da pročita bez pogađanja. Kao i obrasci, JSON može imati odeljke unutar odeljaka (blok adrese sa ulicom, gradom i poštanskim brojem) i liste (više brojeva telefona).

Kako izgleda JSON

Evo jedne rezervacije u JSON-u:

{
  "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"
  }
}

Čitanje:

• Vitičaste zagrade { } obuhvataju objekat, skup parova naziv/vrednost.
• Svaki par je "naziv": vrednost, odvojen zarezima.
• Uglaste zagrade [ ] obuhvataju niz, uređenu listu.
• Objekti i nizovi mogu biti jedan u drugom, kao što su contact i extras.

Šest vrsta vrednosti

JSON ima samo šest tipova vrednosti. Ta mala lista je veliki deo razloga zašto radi svuda.

Ne postoji tip za datum. Datumi se pišu kao stringovi, obično u ISO 8601 formatu prikazanom gore (2026-10-03T14:00:00Z, gde Z znači UTC). Dogovor o tom formatu sprečava čitavu kategoriju grešaka sa vremenskim zonama.

Stroga pravila (odakle dolaze greške)

JSON je manje tolerantan nego što izgleda. Sve ovo je nevažeće:

{ name: "Lena" }            ← ključ bez dvostrukih navodnika
{ 'name': 'Lena' }          ← jednostruki navodnici
{ "a": 1, "b": 2, }         ← zarez na kraju
{ "a": 1 "b": 2 }           ← nedostaje zarez
{ "a": 1 // comment }       ← komentari nisu dozvoljeni

Većina poruka „Unexpected token“ potiče od jedne od ovih grešaka. JSON validator ili formater će vam pokazati tačan red.

Radni primer: JSON kroz aplikaciju

Klijent rezerviše šišanje u aplikaciji za salon. Evo gde se JSON pojavljuje:

1. Obrazac za rezervaciju šalje ovo backend-u aplikacije:

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

1. Backend čuva rezervaciju u bazi podataka i odgovara statusom 201 Created i ovim:

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

1. Ako je termin već zauzet, može umesto toga da odgovori statusom 409 Conflict i ovim:

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

Stranica čita status ili error i prikazuje odgovarajuću poruku. Ako umesto toga stranica prikaže prazan ekran, otvaranje alata za programere u pregledaču (karticu Network) pokazaće vam ovaj JSON, što je često najbrži trag do uzroka.

Ključni pojmovi

Česte zablude

• „JSON je JavaScript.“ Potiče iz sintakse JavaScript-a, ali nije vezan za jezik; Python, Java, C#, Go i ostali ga čitaju.
• „Brojevi u navodnicima su u redu.“ "35" je string, a ne broj. Mešanje dovodi do grešaka, na primer "35" + "5" postaje "355". Novac se često bolje čuva kao celi centi (3550) da se izbegnu greške pri zaokruživanju.
• „JSON je bezbedan jer su to samo podaci.“ JSON može da nosi bilo šta, uključujući tajne. Ne stavljajte API ključeve u JSON koji se šalje pregledaču.
• „Sve stavi u JSON kolonu.“ Zgodno za fleksibilne dodatke, ali podaci po kojima pretražujete, filtrirate ili spajate obično treba da budu u pravim kolonama.
• „AI uvek vraća ispravan JSON.“ Modeli mogu dodati dodatni tekst ili pokvariti format. Mnogi provajderi nude režim strukturisanog izlaza, ali vaš kod ipak treba da proveri šta je stiglo.

Šta tražiti od AI alata za aplikacije

• „Pokaži mi primer JSON-a koji ovaj endpoint vraća.“
• „Vraćaj greške kao JSON sa error kodom i čitljivom message porukom.“
• „Čuvaj datume kao ISO 8601 stringove u UTC i pretvaraj u lokalno vreme tek na ekranu.“
• „Čuvaj cene kao cele cente.“
• „Validiraj dolazni JSON na serveru i odbij zahteve sa nedostajućim poljima ili pogrešnim tipovima.“
• „Kada pozivaš AI model, traži JSON u ovom tačnom obliku i proveri ga pre upotrebe.“

JSON u Mythex-u

Ne morate da pišete JSON ručno u Mythex-u: opišete šta želite, a agent napiše kod koji ga šalje i čita. Ipak, korisno je da ga prepoznate, jer kada nešto pukne, nalepljivanje JSON greške u chat daje agentu precizan trag. Dokumentacijski recept za REST API backend od početka traži „jasne JSON greške“, a recept integriši bilo koji API pokriva pozivanje spoljnih servisa. Za širu sliku pogledajte REST vs GraphQL i kako ispraviti grešku u aplikaciji napravljenoj uz AI.

Pitanja