Ano ang JSON? Gabay sa Simpleng Salita na May Halimbawa

Ang JSON (JavaScript Object Notation) ay simpleng text na format para isulat ang structured na datos — mga bagay gaya ng customer, order, o listahan ng produkto — bilang mga pangalan na ipinares sa value. Madaling basahin ng tao at madaling gawin at i-parse ng mga program. Kapag nagpapalitan ng datos ang mga app at serbisyo sa web, JSON ang pinakakaraniwang format.

Bakit mahalaga ang JSON kapag gumagawa ka ng app gamit ang AI

Makakatagpo ka ng JSON nang madalas, kahit hindi ka nagsusulat ng code:

• API. Kapag kumukuha ng datos ang mga screen ng app mo mula sa backend nito, o kapag tumatawag ang backend mo sa serbisyo ng bayad, email, o AI, kadalasang JSON ang bumibiyahe na datos. Tingnan ang ano ang API.
• Settings file. Maraming configuration file ng proyekto ang JSON — halimbawa ang package.json, na naglilista ng dependency ng isang JavaScript project.
• Database. Kayang mag-imbak ng JSON ng Postgres sa isang column (ang jsonb na uri) para sa datos na hindi bagay sa maayos na mga row at column. Tingnan ang ano ang Postgres.
• Output ng AI. Kapag gusto mong ibalik ng AI model ang isang bagay na magagamit ng program — listahan ng tag, o mga field na kinuha mula sa invoice — kadalasang JSON ang hinihingi mo.
• Error message at log. Maraming error ang dumarating bilang JSON, at kadalasang ito ang pinakamabilis na paraan para malaman kung ano ang mali.

Kapag kaya mong basahin ang JSON, makikita mo kung ano talaga ang natanggap ng app mo, mahahanap ang nawawalang field, at matutukoy nang tumpak ang problema sa AI builder mo.

Halimbawang madaling maintindihan

Isipin ang papel na form: Pangalan: ____, Telepono: ____, Newsletter: ☐ oo ☐ hindi. Ang bawat entry ay label na may katabing value. Ang JSON ay ang form na isinulat bilang teksto, sa mahigpit na ayos na kayang basahin ng computer nang hindi humuhula. At tulad ng mga form, may mga seksyon sa loob ng seksyon ang JSON (isang address block na may kalye, lungsod, at postcode) at may mga listahan (ilang numero ng telepono).

Ganito ang hitsura ng JSON

Narito ang isang booking sa 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"
  }
}

Pagbasa rito:

• Ang mga curly brace na { } ang nagbabalot sa isang object — isang set ng pangalan/value na pares.
• Bawat pares ay "name": value, pinaghihiwalay ng comma.
• Ang mga square bracket na [ ] ang nagbabalot sa isang array — isang may-ayos na listahan.
• Puwedeng nasa loob ng isa't isa ang mga object at array, gaya ng contact at extras.

Ang anim na uri ng value

Anim lang ang uri ng value sa JSON. Malaking bahagi ng dahilan kung bakit ito gumagana kahit saan ang maliit na listahang ito.

Wala tayong uri para sa petsa. Isinusulat ang mga petsa bilang string, kadalasan sa ISO 8601 na format na nakita sa itaas (2026-10-03T14:00:00Z, kung saan ang Z ay UTC). Ang pagkakasundo sa format na iyon ay umiiwas sa buong kategorya ng time-zone bug.

Ang mahigpit na mga patakaran (dito galing ang mga error)

Mas mahigpit ang JSON kaysa sa itsura nito. Lahat ng ito ay invalid:

{ name: "Lena" }            ← key na walang double quotes
{ 'name': 'Lena' }          ← single quotes
{ "a": 1, "b": 2, }         ← trailing comma
{ "a": 1 "b": 2 }           ← kulang na comma
{ "a": 1 // comment }       ← hindi pinapayagan ang comment

Karamihan ng “Unexpected token” na error na makikita mo ay isa sa mga ito. Ipapakita sa iyo ng JSON validator o formatter ang eksaktong linya.

Halimbawang sitwasyon: JSON sa pamamagitan ng app

Nagbu-book ang isang customer ng haircut sa salon app. Narito kung saan lumalabas ang JSON:

1. Ipinapadala ng booking form ang ganito sa backend ng app:

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

1. Sine-save ng backend ang booking sa database at sumasagot ng status na 201 Created at ito:

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

1. Kung nakuha na ang oras, maaaring sumagot ito ng status na 409 Conflict at ito naman:

{ "error": "slot_taken", "message": "Nakuha na ang oras na iyon. Pumili po sana ng iba." }

Binabasa ng page ang status o error at ipinapakita ang tamang mensahe. Kung blangkong screen ang nakita ng page, makikita mo ang JSON na ito kapag binuksan mo ang developer tools ng browser (Network tab) — kadalasan ito ang pinakamabilis na palatandaan kung ano ang mali.

Mga pangunahing termino

Mga karaniwang maling akala

• “Ang JSON ay JavaScript.” Galing ito sa syntax ng JavaScript, pero hindi ito nakadepende sa wika; nababasa ito ng Python, Java, C#, Go, at iba pa.
• “Okay lang ang numero sa loob ng quotes.” Ang "35" ay string, hindi number. Kapag pinaghalo ang mga ito, nagkakaroon ng bug gaya ng "35" + "5" na nagiging "355". Kadalasang mas mabuting itago ang pera bilang buong sentimo (3550) para maiwasan ang problema sa pag-round.
• “Ligtas ang JSON dahil datos lang ito.” Kayang dalhin ng JSON ang kahit ano, kasama ang mga secret. Huwag maglagay ng API key sa JSON na ipinapadala sa browser.
• “Ilagay ang lahat sa JSON column.” Maginhawa para sa mga dagdag na flexible na datos, pero ang datos na hinahanap, sinasala, o pinagdurugtong ay kadalasang nararapat sa tamang column.
• “Palaging tama ang JSON na ibinabalik ng AI.” Puwedeng magdagdag ng dagdag na teksto o masira ng mga model ang format. Maraming provider ang may structured-output mode; dapat pa ring suriin ng code mo kung ano ang dumating.

Ano ang itanong sa AI builder mo

• “Ipakita mo sa akin ang halimbawa ng JSON na ibinabalik ng endpoint na ito.”
• “Ibalik ang mga error bilang JSON na may error code at mensaheng nababasa ng tao na message.”
• “Iimbak ang mga petsa bilang ISO 8601 na string sa UTC at i-convert sa lokal na oras lang sa screen.”
• “Iimbak ang mga presyo bilang integer na sentimo.”
• “I-validate ang papasok na JSON sa server at tanggihan ang request na may kulang o maling uri ng field.”
• “Kapag tatawag sa AI model, humingi ng JSON sa eksaktong hugis na ito at suriin ito bago gamitin.”

JSON sa Mythex

Hindi mo kailangang isulat nang mano-mano ang JSON sa Mythex — inilalarawan mo ang gusto mo at isinusulat ng agent ang code na nagpapadala at nagbabasa nito. Nakakatulong pa rin na makilala ito: kapag may nasira, ang pag-paste ng JSON error sa chat ay nagbibigay sa agent ng tumpak na palatandaan. Sa simula pa lang ay humihingi na ng “malinaw na JSON error” ang REST API backend recipe ng docs, at sakop ng integrate any API recipe ang pagtawag sa mga panlabas na serbisyo. Para sa mas malaking larawan, tingnan ang REST vs GraphQL at paano mag-debug ng app na gawa sa AI.

Mga tanong