مدقق مخطط JSON — فحص عقود البيانات وهيكلة Draft-07 بالذكاء الاصطناعي

يدعم المدقق مواصفة JSON Schema Draft-07 العالمية، وهي المواصفة الأكثر استقراراً واعتماداً في بيئات تطوير البرمجيات المؤسسية، وأدوات OpenAPI 3.0، ومكتبات واجهات البرمجة الخلفية (مثل Pydantic في بايثون، وJackson في جافا). ويدعم المحرك كافة الكلمات المفتاحية الجوهرية بما في ذلك فحص الأنواع (type)، والحقول المطلوبة (required)، وحظر الحقول الإضافية (additionalProperties)، والقيود النصية (minLength/maxLength، pattern، format)، والقيود الرقمية (minimum/maximum، multipleOf)، ومحددات المصفوفات (items، minItems، maxItems، uniqueItems)، والثوابت (const، enum).

يقوم محرك الفحص بتتبع الهياكل المتداخلة تكرارياً ويولد مسارات دقيقة وواضحة باستخدام التدوين النقطي والمصفوفي لكل خطأ يتم رصده. فعلى سبيل المثال، إذا وُجد خطأ داخل كائن داخل مصفوفة، يُعرض المسار بشكل صريح مثل 'company.employees[3].contact.email'. أما الأخطاء التي تقع في المستوى الأعلى فيُشار إليها بـ '(الجذر)'، مما يتيح للمطورين تحديد موقع القيمة المعيبة وتصحيحها فوراً حتى في الحمولات الضخمة.

يقتصر التحقق من صياغة JSON (Syntax Validation) على التأكد من أن النص يلتزم بالقواعد النحوية الأساسية للمعيار RFC 8259—مثل توازن الأقواس، وإحاطة النصوص بعلامات اقتباس مزدوجة، وصحة الأرقام. بينما يبدأ التحقق من مخطط JSON (Schema Validation) بعد التأكد من صحة الصياغة، ليفحص القواعد الهيكلية والتجارية—مثل التأكد من وجود خصائص معينة، ومطابقة أنواع البيانات للعقد، ووقوع الأرقام ضمن النطاقات المسموحة، ومطابقة النصوص لأنماط وتنسيقات محددة.

في مواصفة Draft-07، يفحص قيد 'additionalProperties: false' فقط الخصائص المعرفة مباشرة تحت الكلمة المفتاحية 'properties' في نفس المستوى الهرمي للكائن. فإذا كانت الخصائص معرفة داخل مخططات فرعية منفصلة أو إذا حدث خطأ إملائي طفيف في اسم الخاصية، سيصنفها المدقق كحقول إضافية غير مسموح بها. احرص دائماً على إدراج كافة المفاتيح المسموح بها صراحة داخل قائمة 'properties' الخاصة بذلك الكائن.

كلا على الإطلاق. تعمل الأداة بعمارة محلية بدون خادم (Serverless Client-Side) بنسبة 100%. حيث تتم جميع عمليات التحليل اللغوي، والمطابقة النمطية، وفحص المخطط بالكامل داخل الذاكرة العشوائية لمتصفحك الشخصي عبر الجافاسكريبت. ولا يتم إرسال أي بايت من بياناتك عبر الشبكة، مما يجعل الأداة آمنة تماماً للبيانات الإنتاجية الحساسة، والمفاتيح السرية، وسجلات العملاء الخاضعة للوائح GDPR و HIPAA.

نعم، يدعم المدقق مصفوفات الأنواع المشتركة وفقاً لمعايير Draft-07 بدقة تامة. فعلى سبيل المثال، يتيح تعريف '"type": ["string", "null"]' للخاصية أن تقبل نصاً صالحاً أو قيمة فارغة صريحة (null). كما يدعم دمج الأنواع المختلفة مثل '"type": ["number", "string"]' مع الحفاظ على دقة التحقق الهيكلي لكافة الحالات.

يقوم المحرك بترجمة القيمة الواردة في خاصية 'pattern' إلى كائن تعبير نمطي أصيل في جافاسكريبت (RegExp) ويختبر النص المستهدف عبر دالة RegExp.test(). وإذا كان التعبير النمطي يحوي رموز تهريب خاصة (مثل '\\\d' أو '\\\w')، يجب تهريبها بشرطة مائلة مزدوجة داخل نص JSON حتى لا يحذفها محلل النصوص قبل الترجمة. ويتم التعامل مع التعبيرات غير السليمة بأمان دون التسبب في توقف الأداة.

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