JSON क्या है?

JSON सिंटैक्स: छह वैल्यू टाइप

एक JSON डॉक्यूमेंट एक अकेली वैल्यू होता है। वह वैल्यू आमतौर पर ऑब्जेक्ट या ऐरे होती है, लेकिन स्टैंडर्ड (RFC 8259) टॉप लेवल पर छह में से कोई भी टाइप अनुमति देता है।

• Object — ब्रेसेस के अंदर key/value जोड़ों का सेट: {"id": 7, "name": "Layla"}। Key डबल कोट्स में स्ट्रिंग होनी चाहिए।
• Array — ब्रैकेट के अंदर वैल्यू की क्रमबद्ध लिस्ट: ["admin", "editor"]।
• String — डबल कोट्स में टेक्स्ट, कोट्स, बैकस्लैश और कंट्रोल कैरेक्टर के लिए बैकस्लैश एस्केप के साथ: "line one\nline two"।
• Number — पूर्णांक या दशमलव, वैकल्पिक एक्सपोनेंट के साथ: 42, -3.5, 1.2e10। आगे शून्य नहीं, hex नहीं, NaN या Infinity नहीं।
• Boolean — true और false (छोटे अक्षरों में)।
• null — लिटरल null, यानी "कोई वैल्यू नहीं"।

{
  "user": { "id": 7, "name": "Layla", "active": true },
  "roles": ["admin", "editor"],
  "lastLogin": null,
  "balance": 1250.75
}

वे नियम जो ज़्यादातर JSON एरर की वजह हैं

JSON JavaScript जैसा दिखता है लेकिन कहीं ज़्यादा सख़्त है। लगभग हर "Unexpected token" या "Unexpected end of JSON input" एरर इनमें से किसी नियम से आता है।

• Key और स्ट्रिंग में सिर्फ़ डबल कोट्स। 'सिंगल कोट्स' अमान्य हैं।
• ट्रेलिंग कॉमा नहीं: [1, 2, 3,] और {"a": 1,} एरर हैं।
• कमेंट नहीं। डॉक्यूमेंट में कहीं भी // या /* */ की अनुमति नहीं।
• Key कोट्स में होनी चाहिए: {name: "Layla"} JavaScript है, JSON नहीं।
• नंबर आगे शून्य (007) से शुरू नहीं हो सकते या दशमलव बिंदु (5.) पर ख़त्म नहीं हो सकते।
• डॉक्यूमेंट में ठीक एक टॉप-लेवल वैल्यू होनी चाहिए — दो ऑब्जेक्ट अगल-बगल वैध JSON नहीं हैं (वह JSON Lines है)।
• एन्कोडिंग UTF-8 है। फ़ाइल की शुरुआत में byte-order mark कई पार्सर तोड़ देता है।

आज़माएँ: JSON वैलिडेटर

JSON को फ़ॉर्मेट (प्रिटी-प्रिंट) कैसे करें

API आमतौर पर JSON मिनिफ़ाइड भेजते हैं — हर स्पेस और लाइन ब्रेक हटाकर — क्योंकि वह छोटा होता है। फ़ॉर्मेटिंग इंडेंटेशन वापस जोड़ती है ताकि स्ट्रक्चर दिखे। टेक्स्ट को फ़ॉर्मेटर में पेस्ट करें, 2-स्पेस, 4-स्पेस या टैब इंडेंटेशन चुनें, और नतीजा कॉपी करें; एक अच्छा फ़ॉर्मेटर किसी भी सिंटैक्स एरर की सटीक लाइन और कॉलम भी बताता है और ऑब्जेक्ट की key सॉर्ट कर सकता है ताकि दो डॉक्यूमेंट की तुलना हो सके।

कोड में, JavaScript में JSON.stringify(value, null, 2), Python में json.dumps(value, indent=2) और कमांड लाइन पर jq . file.json यही काम करते हैं।

आज़माएँ: JSON फ़ॉर्मेटर आज़माएँ: JSON मिनिफ़ायर

JSON को वैलिडेट कैसे करें

वैलिडेशन के दो स्तर हैं। सिंटैक्स वैलिडेशन जाँचता है कि टेक्स्ट सही-बना JSON है — हर ब्रैकेट बंद है और ऊपर का हर नियम माना गया है। स्कीमा वैलिडेशन आगे जाकर स्ट्रक्चर को JSON Schema से जाँचता है: कौन-सी key ज़रूरी हैं, हर वैल्यू का टाइप क्या होना चाहिए, अनुमत रेंज और पैटर्न।

ऐसे पेलोड को डिबग करते समय सिंटैक्स वैलिडेशन इस्तेमाल करें जो पार्स नहीं होता, और स्कीमा वैलिडेशन तब जब आपके पास API कॉन्ट्रैक्ट हो और आप उससे भटकने वाले रिस्पॉन्स पकड़ना चाहें।

आज़माएँ: JSON वैलिडेटर आज़माएँ: JSON Schema वैलिडेटर आज़माएँ: JSON Schema जनरेटर

JSON vs XML vs YAML

JSON ने डिफ़ॉल्ट वेब फ़ॉर्मेट के रूप में XML की जगह ली क्योंकि यह छोटा है, ज़्यादातर लैंग्वेज के डेटा स्ट्रक्चर पर सीधे मैप होता है और उपयोगी होने के लिए किसी स्कीमा की ज़रूरत नहीं। XML एंटरप्राइज़ और SOAP सिस्टम में अब भी आम है और एट्रिब्यूट, नेमस्पेस और कमेंट सपोर्ट करता है जो JSON में नहीं हैं।

YAML JSON का सुपरसेट है जो इंसानों के लिखने के लिए बना है — कॉन्फ़िग फ़ाइल, CI पाइपलाइन, Kubernetes मैनिफ़ेस्ट। इसमें कमेंट चलते हैं और ज़्यादातर पंक्चुएशन नहीं होता, लेकिन व्हाइटस्पेस-संवेदनशीलता इसे मशीन-टू-मशीन एक्सचेंज के लिए ख़राब विकल्प बनाती है। सीधा नियम: API और स्टोरेज के लिए JSON, कॉन्फ़िगरेशन के लिए YAML, और XML तब जब सिस्टम माँगे।

आज़माएँ: JSON से YAML आज़माएँ: JSON से XML आज़माएँ: XML से JSON आज़माएँ: YAML फ़ॉर्मेटर आज़माएँ: XML फ़ॉर्मेटर आज़माएँ: XML वैलिडेटर

JSON को CSV, SQL और दूसरे फ़ॉर्मेट में बदलना

ऑब्जेक्ट की फ़्लैट JSON ऐरे साफ़-साफ़ CSV में बदलती है: हर ऑब्जेक्ट एक रो और हर key एक कॉलम बन जाती है। नेस्टेड ऑब्जेक्ट को पहले फ़्लैटन करना पड़ता है (user.address.city नाम का कॉलम बनता है)। यही शेप SQL INSERT स्टेटमेंट पर भी मैप होती है, जो API डेटा को एनालिसिस के लिए डेटाबेस में लोड करने का सबसे तेज़ तरीका है।

आज़माएँ: JSON से CSV आज़माएँ: CSV से JSON आज़माएँ: JSON से SQL आज़माएँ: JSON फ़्लैटन / अनफ़्लैटन

बड़े JSON डॉक्यूमेंट के साथ काम करना

हज़ारों लाइन वाले डॉक्यूमेंट को पढ़ने का व्यावहारिक तरीका ट्री व्यूअर है: जो नहीं चाहिए उसे कोलैप्स करें, एक बार में एक ब्रांच खोलें और किसी भी वैल्यू का JSONPath कॉपी करें। प्रोग्रामैटिक रूप से खास वैल्यू खोजने या निकालने के लिए $.users[?(@.active)].email जैसे JSONPath एक्सप्रेशन ठीक वही नोड चुनते हैं जो आप चाहते हैं।

आज़माएँ: JSON ट्री व्यूअर आज़माएँ: JSON Path टेस्टर आज़माएँ: JSON डिफ़

अक्सर पूछे जाने वाले सवाल