تنسيق JSON: دليل المبتدئين للمطوّرين

إذا كنت تعمل مع واجهات API أو ملفات الإعداد أو قواعد البيانات، فستصادف JSON باستمرار. إنها الطريقة الأكثر شيوعًا لنقل البيانات المهيكلة بين البرامج — ومعرفة قراءتها وتنظيفها مهارة أساسية للمطوّر.

ما هي JSON؟

JSON (ترميز كائنات جافاسكريبت) صيغة نصية خفيفة لتخزين البيانات كأزواج مفتاح–قيمة وقوائم. إنها مقروءة للبشر، ومستقلّة عن اللغة، وتستخدمها كل واجهة API حديثة تقريبًا لإرسال الاستجابات.

لماذا يهمّ التنسيق

JSON المختصر — كله في سطر واحد بلا مسافات — فعّال للحواسيب لكنه مؤلم للبشر. التنسيق (أو «التجميل») يضيف مسافات بادئة وفواصل أسطر لترى البنية فعلًا، وتجد الحقل الذي تريده، وتكتشف الأخطاء.

أخطاء JSON الشائعة

• فاصلة زائدة بعد آخر عنصر (غير مسموحة في JSON).
• استخدام علامات اقتباس مفردة بدل المزدوجة.
• أقواس ناقصة.
• التعليقات — JSON لا تدعمها.

نسّق وتحقّق فورًا

يقوم منسّق JSON بالمهمّتين معًا: يجمّل JSON بمسافات بادئة نظيفة ويتحقّق من صحّته، مشيرًا إلى الخطأ بالضبط إن وُجد. ويمكنك أيضًا اختصاره إلى أصغر حجم للإنتاج — كل ذلك محليًا في متصفحك، فتبقى بياناتك خاصة.

نصيحة سير عمل سريعة

عندما تبدو استجابة API معطوبة، الصقها في المنسّق أولًا. إذا فشل التحليل، فرسالة الخطأ عادة تشير مباشرة إلى المشكلة. وبمجرد أن يُنسَّق بنظافة، تعرف أن JSON نفسها صالحة وأن المشكلة في مكان آخر.