مدقّق مخطط JSON
تحقق من بيانات JSON وفق مخطط JSON (الإصدار 2020-12 أو 2019-09 أو 07) بـ Ajv وفحوص format. يعرض كل خطأ مسار العنصر. يعمل داخل متصفحك.
يعمل بالكامل في متصفحك. لا يتم رفع بياناتك أبدًا.
أدوات ذات صلة
عرض الكلما هو مدقّق مخطط JSON؟
يفحص مدقّق مخطط JSON بيانات JSON وفق مخطط JSON ويسرد كل المخالفات – الخصائص المطلوبة الناقصة والأنواع الخاطئة والأعداد خارج النطاق والصيغ غير الصالحة والخصائص الزائدة – كلٌّ مع JSON Pointer للقيمة المخالفة. تُدعم الإصدارات 2020-12 و2019-09 و07.
كيفية استخدام مدقّق مخطط JSON
- الصق البيانات في بيانات JSON والمخطط في مخطط JSON (Schema) (أو اضغط تحميل مثال في كل منهما).
- اترك إصدار المخطط على الاكتشاف التلقائي، أو اختر إصدارًا.
- اقرأ النتيجة: رسالة نجاح، أو قائمة الأخطاء مع مسارات العناصر.
- أصلح البيانات (أو المخطط) وتتحدّث النتيجة تلقائيًا.
مثال
Data: {"age":-1,"email":"x"}
Schema: {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","required":["name"],"properties":{"age":{"type":"integer","minimum":0},"email":{"type":"string","format":"email"}}} Validation errors: 3 (draft 2020-12) (root) Missing required property "name" /age Must be ≥ 0 /email Must be a valid "email"
متى تستخدم مدقّق مخطط JSON
استخدمه لاختبار حمولات API وملفات الإعداد أو المخططات التي تكتبها. المخططات من Draft-04 وما قبله غير مدعومة (أسقطها Ajv 8). ولا تُنزَّل روابط $ref البعيدة؛ يجب أن تكون المخططات مكتفية بذاتها (يعمل $ref المحلي إلى #/$defs/...).
كيف يعمل مدقّق مخطط JSON
يستخدم التحقق Ajv 8، وهو تنفيذ واسع الاستخدام لمخطط JSON، مع تفعيل allErrors ليُبلَّغ عن كل مخالفة، وajv-formats لكلمات format مثل email وdate-time وuri وuuid. يُكتشف الإصدار من رابط $schema في المخطط (2020-12 أو 2019-09 وإلا draft-07) أو يُختار يدويًا. الوضع الصارم معطّل، فتُتجاهل الكلمات المجهولة مثل example بدل رفضها. وتُعرض أنواع الأخطاء الشائعة برسائل مترجمة؛ وتستخدم الأنواع الأخرى رسالة Ajv.
حالات الاستخدام الشائعة
- فحص جسم طلب API وفق مخطط مشتق من OpenAPI
- معرفة سبب رفض ملف إعداد
- تطوير مخطط JSON جديد واختباره
- التحقق من بيانات الاختبار
ملاحظة أمنية
كل شيء يعمل محليًا داخل متصفحك؛ الكود الذي تلصقه لا يُرفع إلى أي خادم.
الأسئلة الشائعة
ما الإصدارات المدعومة؟
2020-12 و2019-09 وdraft-07 (تعمل مخططات draft-06 عادةً كـ draft-07). Draft-04 غير مدعوم.
هل تُفحص صيغ مثل email؟
نعم، عبر ajv-formats.
هل يمكنه تحميل مخططات $ref بعيدة؟
لا، المراجع داخل المخطط نفسه فقط.
لماذا يعرض عدة أخطاء دفعة واحدة؟
تُجمَّع كل الأخطاء لتتمكن من إصلاح كل شيء في مرة واحدة.