محتويات المقال
إذا تعاملت يوماً مع إعدادات متجر إلكتروني أو ربطت خدمة بأخرى أو صدّرت بيانات من منصة، فغالباً رأيت نصاً مليئاً بالأقواس المعقوفة وعلامات الاقتباس. هذه هي صيغة JSON، وهي اليوم اللغة المشتركة لتبادل البيانات بين التطبيقات.
ما هو JSON؟
JSON اختصار لـ JavaScript Object Notation، وهي صيغة نصية خفيفة لتمثيل البيانات بطريقة يسهل على البشر قراءتها وعلى الحواسيب تحليلها. رغم أن اسمها مرتبط بلغة JavaScript، فإن كل لغات البرمجة تقريباً تدعمها.
مكونات JSON الأساسية
- الكائن: مجموعة من أزواج "مفتاح: قيمة" بين قوسين معقوفين.
- المصفوفة: قائمة مرتبة من القيم بين قوسين مربعين.
- النص: بين علامتي اقتباس مزدوجتين.
- الأرقام والقيم المنطقية true وfalse، والقيمة الفارغة null.
مثال لمنتج في متجر:
{
"name": "Animal Coloring Book",
"price": 6.5,
"digital": true,
"sizes": ["US Letter", "A4"],
"pages": 40
}أين يُستخدم JSON؟
- واجهات البرمجة API: عند ربط متجرك بخدمة شحن أو بوابة دفع، تتبادل الأنظمة البيانات غالباً بصيغة JSON.
- ملفات الإعدادات: كثير من التطبيقات والقوالب تحفظ إعداداتها في ملفات JSON.
- البيانات المنظمة لمحركات البحث: صيغة JSON-LD تُستخدم لإخبار جوجل بتفاصيل المنتج والسعر والتقييمات والأسئلة الشائعة.
- التصدير والاستيراد: نقل المنتجات أو الطلبات بين المنصات.
أشهر أخطاء JSON
1. الفاصلة الزائدة
وضع فاصلة بعد آخر عنصر في الكائن أو المصفوفة خطأ في JSON، رغم أنه مقبول في بعض لغات البرمجة.
2. علامات الاقتباس المفردة
JSON يقبل علامات الاقتباس المزدوجة فقط حول النصوص والمفاتيح.
3. المفاتيح بدون اقتباس
كل مفتاح يجب أن يكون بين علامتي اقتباس مزدوجتين.
4. التعليقات
صيغة JSON القياسية لا تدعم التعليقات، ووجودها يجعل الملف غير صالح.
كيف تقرأ JSON وتصلحه بسهولة؟
البيانات القادمة من الأنظمة تكون غالباً مضغوطة في سطر واحد طويل يصعب قراءته. الصق النص في منسّق ومدقق JSON ليعرضه بشكل منظم بمسافات بادئة، ويحدد لك موضع الخطأ إن وجد. تتم المعالجة داخل متصفحك، فيمكنك فحص ملفات تحتوي على بيانات حساسة بأمان.
نصيحة لأصحاب المتاجر
قبل تعديل أي ملف إعدادات بصيغة JSON، احتفظ بنسخة من الأصل، ثم تحقق من صلاحية الملف بعد التعديل. خطأ واحد مثل فاصلة زائدة قد يعطل إعدادات متجرك أو قالبك بالكامل.
الخلاصة
JSON صيغة بسيطة بقواعد صارمة: علامات اقتباس مزدوجة، ولا فواصل زائدة، ولا تعليقات. فهم أساسياتها يساعدك على التعامل مع الإعدادات والربط بين الخدمات وتشخيص المشكلات دون الاعتماد الكامل على مطور.
