أساسيات JSON: التنسيق والتحقق والتحويل

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

كيف تبدو JSON؟

تخزّن JSON البيانات كأزواج مفتاح–قيمة. المفاتيح نصوص بين علامتي تنصيص مزدوجتين، والقيم قد تكون نصاً أو رقماً أو قيمة منطقية أو مصفوفة بين أقواس مربعة أو كائناً متداخلاً. مثال: {"name": "سارة", "age": 29}. هذه البساطة هي سبب تفوقها على XML كصيغة الويب الافتراضية.

لماذا تنكسر JSON عندك (وكيف تصلحها)

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

والـ JSON المضغوط القادم من API يستحيل قراءته كسطر واحد طويل. مرّره على JSON Formatter لتنسيقه بمسافات بادئة، أو تصفّحه تفاعلياً بأداة JSON Viewer التي تطوي المستويات المتداخلة وتفتحها كشجرة ملفات.

التحويل إلى صيغ أخرى

مستخدمو الجداول يحتاجون غالباً CSV: محول JSON إلى CSV يحول مصفوفات الكائنات إلى صفوف تفتحها في Excel. وللأنظمة القديمة التي تتوقع XML استخدم JSON إلى XML أو العكس عبر XML إلى JSON، إضافة إلى CSV إلى JSON.

اضغط قبل النشر

التنسيق الجميل مفيد للبشر لكنه هدر للآلات. قبل وضع JSON في بيئة إنتاج، صغّره بأداة JSON Minify — التوفير قد يصل إلى 20–30% من الحجم.

نصائح توفر ساعات

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

كل هذه الأدوات مجانية وتعمل في متصفحك مباشرة دون تخزين بياناتك — تجدها كاملة في قسم أدوات المطورين.

Tamer Baghdadi

CEO / Co-Founder