كيف تتحقق من JSON قبل استخدامه

فاصلة في غير مكانها أو قوس إغلاق مفقود أو مفتاح غير مقتبس قد يتسبب في فشل طلب API كامل أو نشر إعدادات أو استيراد بيانات بصمت أو بخطأ غامض. يتحقق المطورون ومهندسو DevOps ووكلاء الدعم وفرق التكامل من صلاحية حمولات JSON كخطوة أولى لتصحيح الأخطاء لأن أخطاء الصيغة هي الأكثر شيوعاً والأسهل في الإصلاح.

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

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

تعكس الطريقة سلوك محللات JSON القياسية: يجب أن تكون الصيغة صالحة قبل أن تفسر البرامج البيانات بأمان.

النص {"name":"Ada"} صالح لأن المفتاح مقتبس والقيمة النصية مقتبسة. أما {"name":"Ada",} فهو غير صالح لأن JSON لا يسمح بفاصلة زائدة بعد الخاصية الأخيرة.

مجموعة القواعد: JSON صالح = يقبل المحلل المدخل كله. JSON غير صالح = يرمي المحلل خطأ قبل الوصول إلى قيمة JSON مكتملة.

قد يحتوي مستند JSON صالح على بيانات عمل خاطئة. يفحص التحقق الصيغة لا المخطط ولا الحقول المطلوبة ولا القيم المسموحة ولا عقود API الخاصة. استخدم تحقق المخطط عندما تهم قواعد الحقول.

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

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

المدخلات: نص JSON حتى ١٬٠٠٠٬٠٠٠ حرف و٢٥٦ مستوى تداخل. المخرجات: حالة الصيغة والمشكلات بمواضعها وتحذيرات المفاتيح المكررة والإصلاحات الآمنة المتاحة منفردة أو جماعية وJSON صالح منسّق. لا تظهر معاينة إصلاح كامل إلا عندما يجتاز نصها التحقق. قد يترك تطبيق جزء آمن من التعديلات أخطاء أخرى دون حل. لا يتصل المدقّق بالـ API الذي سيستهلك الحمولة لاحقاً.

يعمل التحقق داخل المتصفح دون رفع الحمولة. يتم تحليل النص كـ JSON لاكتشاف الفواصل أو علامات الاقتباس أو الأقواس أو القيم غير الصحيحة.