Çfarë është JSON? Udhëzues i thjeshtë me shembuj

JSON (JavaScript Object Notation) është një format tekst i thjeshtë për të shkruar të dhëna të strukturuara — gjëra si një klient, një porosi ose një listë produktesh — si emra të çiftuar me vlera. Është i lehtë për t’u lexuar nga njerëzit dhe i lehtë për programet për ta prodhuar dhe analizuar. Kur aplikacionet dhe shërbimet shkëmbejnë të dhëna përmes webit, JSON është me shumë formati më i zakonshëm.

Pse ka rëndësi JSON kur ndërton me AI

Do ta hasësh JSON vazhdimisht, edhe nëse nuk shkruan kurrë kod:

• API-të. Kur ekranet e aplikacionit tënd ngarkojnë të dhëna nga backend-i, ose backend-i yt thërret një shërbim pagese, email ose AI, të dhënat zakonisht udhëtojnë si JSON. Shiko çfarë është një API.
• Skedarët e cilësimeve. Shumë skedarë konfigurimi të projektit janë JSON — për shembull package.json, që liston varësitë e një projekti JavaScript.
• Bazat e të dhënave. Postgres mund ta ruajë JSON-in në një kolonë (tipi jsonb) për të dhëna që nuk përshtaten në rreshta dhe kolona të rregullta. Shiko çfarë është Postgres.
• Dalja e AI. Kur do që një model AI të kthejë diçka që një program mund ta përdorë — një listë etiketash, fusha të nxjerra nga një faturë — zakonisht kërkon JSON.
• Mesazhet e gabimeve dhe regjistrat. Shumë gabime vijnë si JSON, dhe leximi i tyre shpesh është mënyra më e shpejtë për të gjetur çfarë shkoi keq.

Aftësia për ta lexuar JSON të lejon të kontrollosh çfarë mori në të vërtetë aplikacioni yt, të vësh re një fushë që mungon dhe të përshkruash saktë problemet te ndërtuesi yt me AI.

Një analogji e përditshme

Mendo për një formular në letër: Emri: ____, Telefoni: ____, Buletini: ☐ po ☐ jo. Çdo hyrje është një etiketë me një vlerë pranë. JSON është ai formular i shkruar si tekst, në një strukturë të rreptë që një kompjuter mund ta lexojë pa supozuar. Dhe si formularët, JSON mund të ketë seksione brenda seksioneve (një bllok adrese me rrugën, qytetin dhe kodin postar) dhe lista (disa numra telefoni).

Si duket JSON

Këtu është një rezervim i vetëm në 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"
  }
}

Si lexohet:

• Kllapat e lakuara { } mbështjellin një objekt — një grup çiftesh emër/vlerë.
• Çdo çift është "name": value, i ndarë me presje.
• Kllapat katrore [ ] mbështjellin një array — një listë e renditur.
• Objektet dhe array-et mund të ulen brenda njëri-tjetrit, si bëjnë contact dhe extras.

Gjashtë llojet e vlerave

JSON ka vetëm gjashtë lloje vlerash. Kjo listë e vogël është një pjesë e madhe e arsyes pse funksionon kudo.

Nuk ka lloj data. Datat shkruhen si varg, zakonisht në formatin ISO 8601 të treguar më sipër (2026-10-03T14:00:00Z, ku Z do të thotë UTC). Marrëveshja mbi këtë format shmang një kategori të tërë gabimesh të zonës kohore.

Rregullat e rrepta (ku vijnë gabimet)

JSON është më pak tolerant nga sa duket. Të gjitha këto janë të pavlefshme:

{ name: "Lena" }            ← çelës pa thonjëza të dyfishta
{ 'name': 'Lena' }          ← thonjëza të vetme
{ "a": 1, "b": 2, }         ← presje në fund
{ "a": 1 "b": 2 }           ← presje që mungon
{ "a": 1 // koment }       ← komentet nuk lejohen

Shumica e gabimeve „Unexpected token” që do të shohësh janë një nga këto. Një validues ose formatues JSON do të të tregojë rreshtin e saktë.

Një shembull praktik: JSON përmes një aplikacioni

Një klient rezervon një prerje flokësh në një aplikacion salloni. Ja ku shfaqet JSON:

1. Formulari i rezervimit dërgon këtë te backend-i i aplikacionit:

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

1. Backend-i e ruan rezervimin në bazën e të dhënave dhe përgjigjet me statusin 201 Created dhe:

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

1. Nëse ora ishte zënë më parë, mund të përgjigjet me statusin 409 Conflict dhe:

{ "error": "slot_taken", "message": "Ajo orë sapo u rezervua. Ju lutemi zgjidhni një tjetër." }

Faqja lexon status ose error dhe shfaq mesazhin e duhur. Nëse faqja do të shfaqte në vend të kësaj një ekran bosh, hapja e veglave të zhvilluesit të shfletuesit (skeda Network) do të të tregonte këtë JSON — shpesh indicia më e shpejtë për atë që shkoi keq.

Termat kryesorë

Keqkuptimet e zakonshme

• „JSON është JavaScript.” Ka lindur nga sintaksa e JavaScript, por është i pavarur nga gjuha; Python, Java, C#, Go dhe të tjerat e lexojnë të gjithë.
• „Numrat në thonjëza janë në rregull.” "35" është varg, jo numër. Përzierja e tyre shkakton gabime si "35" + "5" që bëhet "355". Paratë shpesh ruhen më mirë si centë të plotë (3550) për të shmangur problemet e rrumbullakimit.
• „JSON është i sigurt sepse është thjesht të dhëna.” JSON mund të mbartë çfarëdo, përfshirë sekrete. Mos vendos çelësa API në JSON që dërgohet te shfletuesi.
• „Vendos gjithçka në një kolonë JSON.” E dobishme për shtesa fleksibël, por të dhënat sipas të cilave kërkon, filtron ose bashkon zakonisht duhet të jenë në kolona të duhura.
• „AI kthen gjithmonë JSON të vlefshëm.” Modelet mund të shtojnë tekst shtesë ose ta prishin formatin. Shumë ofrues ofrojnë një mënyrë dalje të strukturuar; kodi yt duhet prapë ta kontrollojë atë që kthehet.

Çfarë t’i kërkosh ndërtuesit tënd me AI

• „Më trego një shembull të JSON që kthen ky endpoint.”
• „Kthe gabimet si JSON me një kod error dhe një message të lexueshëm nga njeriu.”
• „Ruaj datat si varg ISO 8601 në UTC dhe konverto në kohën lokale vetëm në ekran.”
• „Ruaj çmimet si centë të plotë.”
• „Valido JSON-in hyrës në server dhe refuzo kërkesat me fusha që mungojnë ose kanë lloj të gabuar.”
• „Kur thërret modelin e AI, kërko JSON në këtë formë të saktë dhe kontrolloje përpara se ta përdorësh.”

JSON në Mythex

Nuk ke nevojë ta shkruash JSON me dorë në Mythex — përshkruan atë që do dhe agjenti shkruan kodin që e dërgon dhe e lexon. Megjithatë, ndihmon ta njohësh: kur diçka prishet, ngjitja e gabimit JSON në bisedë i jep agjentit një indicie të saktë. Recetë backend REST API e dokumentacionit kërkon „gabime JSON të qarta” që në fillim, dhe receta integro çdo API mbulon thirrjen e shërbimeve të jashtme. Për pamjen më të gjerë, shiko REST vs GraphQL dhe si të korrigjosh një aplikacion të ndërtuar me AI.

Pyetje