كيفية تنسيق JSON والتحقّق من صحته عبر الإنترنت

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

ما يفعله منسّق JSON

JSON خام من استجابة واجهة برمجة تطبيقات أو ملف مصغَّر يبدو هكذا:

{"users":[{"name":"Alice","age":30,"roles":["admin","editor"]},{"name":"Bob","age":25,"roles":["viewer"]}]}

يحوّله المنسّق إلى شيء قابل للقراءة:

{
  "users": [
    {
      "name": "Alice",
      "age": 30,
      "roles": ["admin", "editor"]
    },
    {
      "name": "Bob",
      "age": 25,
      "roles": ["viewer"]
    }
  ]
}

نفس البيانات، لكن يمكنك أخيرًا قراءتها واكتشاف الأخطاء وفهم البنية.

كيفية تنسيق JSON عبر الإنترنت

1. الصق JSON الخاص بك في حقل الإدخال. يكتشف المنسّق أخطاء الصياغة فورًا ويتحقّق من البنية.
2. اختر المسافة البادئة — حدّد 2 أو 4 مسافات، أو انقر على تصغير لضغط JSON على سطر واحد.
3. انسخ النتيجة — يتضمّن الإخراج المنسَّق تلوين صياغة. انسخه لكودك أو ملف تكوين أو وثائقك.

أخطاء JSON الشائعة وكيفية اكتشافها

تتلخّص معظم أخطاء JSON في عدة أشكال شائعة:

• فواصل مفقودة أو زائدة — الفاصلة بعد العنصر الأخير في مصفوفة أو كائن غير صحيحة في JSON (على عكس JavaScript)
• مفاتيح بدون علامات اقتباس — يتطلّب JSON علامات اقتباس مزدوجة حول جميع المفاتيح: "name"، وليس name
• علامات اقتباس مفردة — يقبل JSON علامات الاقتباس المزدوجة فقط: "value"، وليس 'value'
• فواصل في النهاية — {"a": 1,} غير صحيح؛ أزل الفاصلة بعد الإدخال الأخير

يبرز المنسّق الجيد بدقة مكان الخطأ، حتى تتمكّن من إصلاحه دون تخمين.

متى تنسّق، متى تصغّر

تنسيق (جعله قابلًا للقراءة) عندما تحتاج إلى:

• قراءة وفهم البيانات
• تصحيح استجابات واجهة برمجة التطبيقات
• تحرير ملفات التكوين
• مشاركة JSON مع الزملاء

تصغير عندما تحتاج إلى:

• إرسال البيانات عبر الشبكة (حمولة أخفّ = نقل أسرع)
• تخزين JSON في قاعدة بيانات أو سجل حيث لا تهم القابلية للقراءة
• دمج JSON في معلمة URL أو حقل نموذج

نصائح للعمل مع JSON

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