JSON ਕੀ ਹੈ? ਉਦਾਹਰਣਾਂ ਨਾਲ ਸਰਲ ਭਾਸ਼ਾ ਵਿੱਚ ਗਾਈਡ

JSON (JavaScript Object Notation) ਢਾਂਚਾਗਤ ਡਾਟਾ ਲਿਖਣ ਦਾ ਇੱਕ ਸਾਦਾ ਟੈਕਸਟ ਫਾਰਮੈਟ ਹੈ, ਜਿਵੇਂ ਕਿਸੇ ਗਾਹਕ, ਆਰਡਰ ਜਾਂ ਉਤਪਾਦਾਂ ਦੀ ਸੂਚੀ, ਜਿਸ ਵਿੱਚ ਨਾਂ ਅਤੇ ਮੁੱਲ ਜੋੜੇ ਵਿੱਚ ਲਿਖੇ ਹੁੰਦੇ ਹਨ। ਲੋਕਾਂ ਲਈ ਇਸਨੂੰ ਪੜ੍ਹਨਾ ਆਸਾਨ ਹੈ ਅਤੇ ਪ੍ਰੋਗਰਾਮਾਂ ਲਈ ਬਣਾਉਣਾ ਅਤੇ ਪੜ੍ਹਨਾ ਵੀ ਆਸਾਨ। ਜਦੋਂ ਐਪਾਂ ਅਤੇ ਸੇਵਾਵਾਂ ਵੈੱਬ ਰਾਹੀਂ ਡਾਟਾ ਵਟਾਂਦਰਾ ਕਰਦੀਆਂ ਹਨ, ਤਾਂ JSON ਹੁਣ ਤੱਕ ਸਭ ਤੋਂ ਆਮ ਫਾਰਮੈਟ ਹੈ।

ਜਦੋਂ ਤੁਸੀਂ AI ਨਾਲ ਬਣਾਉਂਦੇ ਹੋ ਤਾਂ JSON ਕਿਉਂ ਮਹੱਤਵਪੂਰਨ ਹੈ

ਤੁਹਾਨੂੰ JSON ਲਗਾਤਾਰ ਮਿਲੇਗਾ, ਭਾਵੇਂ ਤੁਸੀਂ ਕਦੇ ਕੋਡ ਨਾ ਲਿਖੋ:

• APIs। ਜਦੋਂ ਤੁਹਾਡੀ ਐਪ ਦੀਆਂ ਸਕ੍ਰੀਨਾਂ ਆਪਣੇ ਬੈਕਐਂਡ ਤੋਂ ਡਾਟਾ ਲੈਂਦੀਆਂ ਹਨ, ਜਾਂ ਤੁਹਾਡਾ ਬੈਕਐਂਡ ਕਿਸੇ ਪੇਮੈਂਟ, ਈਮੇਲ ਜਾਂ AI ਸੇਵਾ ਨੂੰ ਕਾਲ ਕਰਦਾ ਹੈ, ਤਾਂ ਡਾਟਾ ਆਮ ਤੌਰ 'ਤੇ JSON ਵਿੱਚ ਆਉਂਦਾ-ਜਾਂਦਾ ਹੈ। ਵੇਖੋ API ਕੀ ਹੁੰਦਾ ਹੈ।
• ਸੈਟਿੰਗ ਫਾਈਲਾਂ। ਕਈ ਪ੍ਰੋਜੈਕਟ ਸੰਰਚਨਾ ਫਾਈਲਾਂ JSON ਹੁੰਦੀਆਂ ਹਨ, ਜਿਵੇਂ package.json, ਜਿਸ ਵਿੱਚ JavaScript ਪ੍ਰੋਜੈਕਟ ਦੀਆਂ ਡਿਪੈਂਡੈਂਸੀਆਂ ਦੀ ਸੂਚੀ ਹੁੰਦੀ ਹੈ।
• ਡਾਟਾਬੇਸ। Postgres ਕਿਸੇ ਕਾਲਮ ਵਿੱਚ JSON ਸੰਭਾਲ ਸਕਦਾ ਹੈ (jsonb ਕਿਸਮ), ਉਸ ਡਾਟੇ ਲਈ ਜੋ ਸਾਫ਼ ਕਤਾਰਾਂ ਅਤੇ ਕਾਲਮਾਂ ਵਿੱਚ ਫਿੱਟ ਨਹੀਂ ਹੁੰਦਾ। ਵੇਖੋ Postgres ਕੀ ਹੈ।
• AI ਦਾ ਆਉਟਪੁੱਟ। ਜਦੋਂ ਤੁਸੀਂ ਚਾਹੁੰਦੇ ਹੋ ਕਿ AI ਮਾਡਲ ਕੋਈ ਅਜਿਹੀ ਚੀਜ਼ ਵਾਪਸ ਕਰੇ ਜੋ ਪ੍ਰੋਗਰਾਮ ਵਰਤ ਸਕੇ, ਜਿਵੇਂ ਟੈਗਾਂ ਦੀ ਸੂਚੀ ਜਾਂ ਇਨਵੌਇਸ ਦੇ ਖੇਤਰ, ਤਾਂ ਆਮ ਤੌਰ 'ਤੇ ਤੁਸੀਂ JSON ਮੰਗਦੇ ਹੋ।
• ਗਲਤੀ ਸੁਨੇਹੇ ਅਤੇ ਲੌਗ। ਬਹੁਤ ਸਾਰੀਆਂ ਗਲਤੀਆਂ JSON ਵਿੱਚ ਆਉਂਦੀਆਂ ਹਨ, ਅਤੇ ਉਹਨਾਂ ਨੂੰ ਪੜ੍ਹਨਾ ਅਕਸਰ ਇਹ ਪਤਾ ਲਗਾਉਣ ਦਾ ਸਭ ਤੋਂ ਤੇਜ਼ ਤਰੀਕਾ ਹੁੰਦਾ ਹੈ ਕਿ ਕੀ ਗਲਤ ਹੋਇਆ।

JSON ਪੜ੍ਹਨਾ ਆਉਣ ਨਾਲ ਤੁਸੀਂ ਜਾਂਚ ਸਕਦੇ ਹੋ ਕਿ ਤੁਹਾਡੀ ਐਪ ਨੂੰ ਅਸਲ ਵਿੱਚ ਕੀ ਮਿਲਿਆ, ਕੋਈ ਗੁੰਮ ਖੇਤਰ ਲੱਭ ਸਕਦੇ ਹੋ ਅਤੇ ਸਮੱਸਿਆਵਾਂ ਨੂੰ ਆਪਣੇ AI ਬਿਲਡਰ ਨੂੰ ਸਹੀ ਢੰਗ ਨਾਲ ਦੱਸ ਸਕਦੇ ਹੋ।

ਰੋਜ਼ ਦੀ ਇੱਕ ਮਿਸਾਲ

ਇੱਕ ਕਾਗਜ਼ੀ ਫਾਰਮ ਬਾਰੇ ਸੋਚੋ: ਨਾਮ: ____, ਫ਼ੋਨ: ____, ਨਿਊਜ਼ਲੈਟਰ: ☐ ਹਾਂ ☐ ਨਹੀਂ। ਹਰ ਭਰਾਈ ਇੱਕ ਲੇਬਲ ਅਤੇ ਉਸਦੇ ਨਾਲ ਦਾ ਮੁੱਲ ਹੈ। JSON ਉਹੀ ਫਾਰਮ ਹੈ ਜੋ ਟੈਕਸਟ ਵਿੱਚ ਲਿਖਿਆ ਗਿਆ ਹੈ, ਇੱਕ ਸਖ਼ਤ ਲੇਆਉਟ ਵਿੱਚ ਜੋ ਕੰਪਿਊਟਰ ਬਿਨਾਂ ਅੰਦਾਜ਼ੇ ਦੇ ਪੜ੍ਹ ਸਕਦਾ ਹੈ। ਫਾਰਮਾਂ ਵਾਂਗ, JSON ਵਿੱਚ ਵੀ ਭਾਗਾਂ ਦੇ ਅੰਦਰ ਭਾਗ ਹੋ ਸਕਦੇ ਹਨ (ਜਿਵੇਂ ਪਤਾ ਬਲਾਕ ਜਿਸ ਵਿੱਚ ਗਲੀ, ਸ਼ਹਿਰ ਅਤੇ ਪਿੰਨ ਕੋਡ ਹੋਣ) ਅਤੇ ਸੂਚੀਆਂ (ਕਈ ਫ਼ੋਨ ਨੰਬਰ)।

JSON ਕਿਹੋ ਜਿਹਾ ਦਿਸਦਾ ਹੈ

ਇੱਥੇ ਇੱਕ ਬੁਕਿੰਗ 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"
  }
}

ਇਸਨੂੰ ਇਸ ਤਰ੍ਹਾਂ ਪੜ੍ਹੋ:

• ਕਰਲੀ ਬਰੈਕਟ { } ਇੱਕ ਆਬਜੈਕਟ ਨੂੰ ਘੇਰਦੇ ਹਨ, ਯਾਨੀ ਨਾਂ ਅਤੇ ਮੁੱਲ ਜੋੜਿਆਂ ਦਾ ਸਮੂਹ।
• ਹਰ ਜੋੜਾ "name": value ਵਰਗਾ ਹੁੰਦਾ ਹੈ, ਕੌਮਿਆਂ ਨਾਲ ਵੱਖ ਕੀਤਾ ਹੋਇਆ।
• ਵਰਗ ਬਰੈਕਟ [ ] ਇੱਕ ਐਰੇ ਨੂੰ ਘੇਰਦੇ ਹਨ, ਯਾਨੀ ਕ੍ਰਮ ਵਿੱਚ ਸੂਚੀ।
• ਆਬਜੈਕਟ ਅਤੇ ਐਰੇ ਇੱਕ ਦੂਜੇ ਦੇ ਅੰਦਰ ਰੱਖੇ ਜਾ ਸਕਦੇ ਹਨ, ਜਿਵੇਂ contact ਅਤੇ extras ਰੱਖਦੇ ਹਨ।

ਛੇ ਕਿਸਮਾਂ ਦੇ ਮੁੱਲ

JSON ਵਿੱਚ ਸਿਰਫ਼ ਛੇ ਕਿਸਮਾਂ ਦੇ ਮੁੱਲ ਹਨ। ਇਹ ਛੋਟੀ ਸੂਚੀ ਹੀ ਇੱਕ ਵੱਡਾ ਕਾਰਨ ਹੈ ਕਿ ਇਹ ਹਰ ਥਾਂ ਕੰਮ ਕਰਦਾ ਹੈ।

ਇਸ ਵਿੱਚ ਕੋਈ ਤਾਰੀਖ਼ ਕਿਸਮ ਨਹੀਂ ਹੈ। ਤਾਰੀਖ਼ਾਂ ਸਟਰਿੰਗ ਵਜੋਂ ਲਿਖੀਆਂ ਜਾਂਦੀਆਂ ਹਨ, ਆਮ ਤੌਰ 'ਤੇ ਉਸ ISO 8601 ਫਾਰਮੈਟ ਵਿੱਚ ਜੋ ਉੱਪਰ ਵਿਖਾਇਆ ਗਿਆ ਹੈ (2026-10-03T14:00:00Z, ਜਿੱਥੇ Z ਦਾ ਮਤਲਬ UTC ਹੈ)। ਇੱਕ ਫਾਰਮੈਟ ਤੇ ਸਹਿਮਤ ਹੋਣ ਨਾਲ ਸਮਾਂ-ਖੇਤਰ ਦੀਆਂ ਗਲਤੀਆਂ ਦੀ ਪੂਰੀ ਸ਼੍ਰੇਣੀ ਤੋਂ ਬਚਿਆ ਜਾ ਸਕਦਾ ਹੈ।

ਸਖ਼ਤ ਨਿਯਮ (ਗਲਤੀਆਂ ਕਿੱਥੋਂ ਆਉਂਦੀਆਂ ਹਨ)

JSON ਜਿੰਨਾ ਦਿਸਦਾ ਹੈ ਉਸ ਤੋਂ ਵੱਧ ਸਖ਼ਤ ਹੈ। ਇਹ ਸਾਰੇ ਅਵੈਧ ਹਨ:

{ name: "Lena" }            ← ਡਬਲ ਕੋਟ ਤੋਂ ਬਿਨਾਂ ਕੁੰਜੀ
{ 'name': 'Lena' }          ← ਸਿੰਗਲ ਕੋਟ
{ "a": 1, "b": 2, }         ← ਅਖੀਰਲਾ ਕੌਮਾ
{ "a": 1 "b": 2 }           ← ਕੌਮੇ ਦੀ ਕਮੀ
{ "a": 1 // comment }       ← ਟਿੱਪਣੀਆਂ ਦੀ ਇਜਾਜ਼ਤ ਨਹੀਂ

ਜ਼ਿਆਦਾਤਰ "Unexpected token" ਗਲਤੀਆਂ ਇਹਨਾਂ ਵਿੱਚੋਂ ਕਿਸੇ ਇੱਕ ਕਾਰਨ ਹੁੰਦੀਆਂ ਹਨ। ਇੱਕ JSON ਵੈਲੀਡੇਟਰ ਜਾਂ ਫਾਰਮੈਟਰ ਤੁਹਾਨੂੰ ਸਹੀ ਲਾਈਨ ਦਿਖਾ ਦੇਵੇਗਾ।

ਇੱਕ ਕੰਮ ਕੀਤੀ ਉਦਾਹਰਣ: ਇੱਕ ਐਪ ਰਾਹੀਂ JSON

ਇੱਕ ਗਾਹਕ ਸੈਲੂਨ ਐਪ ਵਿੱਚ ਵਾਲ ਕਟਵਾਉਣ ਦੀ ਬੁਕਿੰਗ ਕਰਦਾ ਹੈ। ਇਸ ਤਰ੍ਹਾਂ JSON ਵਰਤਿਆ ਜਾਂਦਾ ਹੈ:

1. ਬੁਕਿੰਗ ਫਾਰਮ ਐਪ ਦੇ ਬੈਕਐਂਡ ਨੂੰ ਇਹ ਭੇਜਦਾ ਹੈ:

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

1. ਬੈਕਐਂਡ ਬੁਕਿੰਗ ਨੂੰ ਡਾਟਾਬੇਸ ਵਿੱਚ ਸੰਭਾਲਦਾ ਹੈ ਅਤੇ ਸਥਿਤੀ 201 Created ਨਾਲ ਇਹ ਜਵਾਬ ਦਿੰਦਾ ਹੈ:

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

1. ਜੇ ਉਹ ਸਮਾਂ ਪਹਿਲਾਂ ਹੀ ਬੁੱਕ ਹੋ ਚੁੱਕਾ ਹੋਵੇ, ਤਾਂ ਇਹ ਇਸਦੀ ਥਾਂ 409 Conflict ਅਤੇ ਇਹ ਜਵਾਬ ਦੇ ਸਕਦਾ ਹੈ:

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

ਪੇਜ status ਜਾਂ error ਪੜ੍ਹਦਾ ਹੈ ਅਤੇ ਸਹੀ ਸੁਨੇਹਾ ਦਿਖਾਉਂਦਾ ਹੈ। ਜੇ ਪੇਜ ਦੀ ਥਾਂ ਖਾਲੀ ਸਕਰੀਨ ਦਿਖੇ, ਤਾਂ ਬਰਾਊਜ਼ਰ ਦੇ ਡਿਵੈਲਪਰ ਟੂਲਜ਼ (Network ਟੈਬ) ਵਿੱਚ ਇਹ JSON ਦਿਖ ਜਾਵੇਗਾ, ਜੋ ਅਕਸਰ ਇਹ ਸਮਝਣ ਦਾ ਸਭ ਤੋਂ ਤੇਜ਼ ਸੁਰਾਗ ਹੁੰਦਾ ਹੈ ਕਿ ਕੀ ਗਲਤ ਹੋਇਆ।

ਮੁੱਖ ਸ਼ਬਦ

ਆਮ ਗਲਤਫਹਿਮੀਆਂ

• "JSON ਹੀ JavaScript ਹੈ।" ਇਹ JavaScript ਦੇ ਸਿੰਟੈਕਸ ਤੋਂ ਆਇਆ ਹੈ, ਪਰ ਇਹ ਕਿਸੇ ਇੱਕ ਭਾਸ਼ਾ 'ਤੇ ਨਿਰਭਰ ਨਹੀਂ; Python, Java, C#, Go ਅਤੇ ਬਾਕੀ ਸਾਰੀਆਂ ਇਸਨੂੰ ਪੜ੍ਹਦੀਆਂ ਹਨ।
• "ਕੋਟਾਂ ਵਿੱਚ ਨੰਬਰ ਠੀਕ ਹਨ।" "35" ਇੱਕ ਸਟਰਿੰਗ ਹੈ, ਨੰਬਰ ਨਹੀਂ। ਇਹਨਾਂ ਨੂੰ ਮਿਲਾਉਣ ਨਾਲ ਗੜਬੜੀ ਹੁੰਦੀ ਹੈ, ਜਿਵੇਂ "35" + "5" ਦਾ "355" ਬਣ ਜਾਣਾ। ਪੈਸੇ ਨੂੰ ਅਕਸਰ ਪੂਰੇ ਸੈਂਟਾਂ ਵਿੱਚ ਸੰਭਾਲਣਾ ਬਿਹਤਰ ਹੁੰਦਾ ਹੈ (3550), ਤਾਂ ਜੋ ਗੋਲ ਕਰਨ ਦੀਆਂ ਸਮੱਸਿਆਵਾਂ ਨਾ ਆਉਣ।
• "JSON ਸੁਰੱਖਿਅਤ ਹੈ ਕਿਉਂਕਿ ਇਹ ਸਿਰਫ਼ ਡਾਟਾ ਹੈ।" JSON ਕੁਝ ਵੀ ਲਿਜਾ ਸਕਦਾ ਹੈ, ਜਿਸ ਵਿੱਚ ਰਾਜ਼ ਵੀ ਸ਼ਾਮਲ ਹਨ। ਜੋ JSON ਬਰਾਊਜ਼ਰ ਨੂੰ ਭੇਜਿਆ ਜਾਂਦਾ ਹੈ, ਉਸ ਵਿੱਚ API ਕੁੰਜੀਆਂ ਨਾ ਪਾਓ।
• "ਸਭ ਕੁਝ JSON ਕਾਲਮ ਵਿੱਚ ਪਾ ਦਿਓ।" ਲਚਕੀਲੇ ਵਾਧੂ ਡਾਟੇ ਲਈ ਇਹ ਸੁਵਿਧਾਜਨਕ ਹੈ, ਪਰ ਜਿਸ ਡਾਟੇ 'ਤੇ ਤੁਸੀਂ ਖੋਜ, ਫਿਲਟਰ ਜਾਂ ਜੋੜ ਕਰਦੇ ਹੋ, ਉਹ ਆਮ ਤੌਰ 'ਤੇ ਸਹੀ ਕਾਲਮਾਂ ਵਿੱਚ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ।
• "AI ਹਮੇਸ਼ਾ ਠੀਕ JSON ਵਾਪਸ ਕਰਦਾ ਹੈ।" ਮਾਡਲ ਵਾਧੂ ਟੈਕਸਟ ਜੋੜ ਸਕਦੇ ਹਨ ਜਾਂ ਫਾਰਮੈਟ ਤੋੜ ਸਕਦੇ ਹਨ। ਕਈ ਪ੍ਰਦਾਤਾ ਸਟ੍ਰਕਚਰਡ ਆਉਟਪੁੱਟ ਮੋਡ ਦਿੰਦੇ ਹਨ, ਫਿਰ ਵੀ ਤੁਹਾਡੇ ਕੋਡ ਨੂੰ ਵਾਪਸ ਆਇਆ ਡਾਟਾ ਜਾਂਚਣਾ ਚਾਹੀਦਾ ਹੈ।

ਆਪਣੇ AI ਬਿਲਡਰ ਨੂੰ ਕੀ ਪੁੱਛਣਾ ਹੈ

• "ਮੈਨੂੰ ਇਸ ਐਂਡਪੌਇੰਟ ਵੱਲੋਂ ਵਾਪਸ ਆਉਣ ਵਾਲੇ JSON ਦੀ ਇੱਕ ਉਦਾਹਰਣ ਦਿਖਾਓ।"
• "ਗਲਤੀਆਂ ਨੂੰ JSON ਵਿੱਚ ਵਾਪਸ ਕਰੋ, ਜਿਸ ਵਿੱਚ error ਕੋਡ ਅਤੇ ਮਨੁੱਖਾਂ ਲਈ ਪੜ੍ਹਨਯੋਗ message ਹੋਵੇ।"
• "ਤਾਰੀਖ਼ਾਂ ਨੂੰ UTC ਵਿੱਚ ISO 8601 ਸਟਰਿੰਗ ਵਜੋਂ ਸੰਭਾਲੋ, ਅਤੇ ਸਥਾਨਕ ਸਮਾਂ ਸਿਰਫ਼ ਸਕਰੀਨ 'ਤੇ ਬਦਲੋ।"
• "ਕੀਮਤਾਂ ਨੂੰ ਪੂਰੇ ਸੈਂਟਾਂ (integer) ਵਿੱਚ ਸੰਭਾਲੋ।"
• "ਆਉਣ ਵਾਲੇ JSON ਨੂੰ ਸਰਵਰ 'ਤੇ ਜਾਂਚੋ ਅਤੇ ਗੁੰਮ ਜਾਂ ਗਲਤ ਕਿਸਮ ਦੇ ਖੇਤਰਾਂ ਵਾਲੀਆਂ ਬੇਨਤੀਆਂ ਰੱਦ ਕਰੋ।"
• "AI ਮਾਡਲ ਨੂੰ ਕਾਲ ਕਰਦੇ ਸਮੇਂ ਇਸ ਸਹੀ ਸ਼ਕਲ ਵਿੱਚ JSON ਮੰਗੋ ਅਤੇ ਵਰਤਣ ਤੋਂ ਪਹਿਲਾਂ ਜਾਂਚੋ।"

Mythex ਵਿੱਚ JSON

Mythex ਵਿੱਚ ਤੁਹਾਨੂੰ JSON ਹੱਥੀਂ ਲਿਖਣ ਦੀ ਲੋੜ ਨਹੀਂ। ਤੁਸੀਂ ਦੱਸਦੇ ਹੋ ਕਿ ਕੀ ਚਾਹੀਦਾ ਹੈ ਅਤੇ ਏਜੰਟ ਉਹ ਕੋਡ ਲਿਖਦਾ ਹੈ ਜੋ ਇਸਨੂੰ ਭੇਜਦਾ ਅਤੇ ਪੜ੍ਹਦਾ ਹੈ। ਫਿਰ ਵੀ ਇਸਨੂੰ ਪਛਾਣਨਾ ਮਦਦਗਾਰ ਹੈ: ਜਦੋਂ ਕੁਝ ਟੁੱਟਦਾ ਹੈ, ਤਾਂ JSON ਗਲਤੀ ਚੈਟ ਵਿੱਚ ਪੇਸਟ ਕਰਨ ਨਾਲ ਏਜੰਟ ਨੂੰ ਸਹੀ ਸੁਰਾਗ ਮਿਲਦਾ ਹੈ। ਡੌਕਸ ਦੀ REST API ਬੈਕਐਂਡ ਰੈਸਿਪੀ ਸ਼ੁਰੂ ਤੋਂ ਹੀ "ਸਾਫ਼ JSON ਗਲਤੀਆਂ" ਮੰਗਦੀ ਹੈ, ਅਤੇ any API ਨੂੰ ਇੰਟੀਗ੍ਰੇਟ ਕਰੋ ਰੈਸਿਪੀ ਬਾਹਰੀ ਸੇਵਾਵਾਂ ਨੂੰ ਕਾਲ ਕਰਨ ਬਾਰੇ ਦੱਸਦੀ ਹੈ। ਵੱਡੀ ਤਸਵੀਰ ਲਈ, ਵੇਖੋ REST ਬਨਾਮ GraphQL ਅਤੇ AI ਨਾਲ ਬਣੀ ਐਪ ਨੂੰ ਕਿਵੇਂ ਡੀਬੱਗ ਕਰੀਏ।

ਸਵਾਲ