مدقّق مخطط JSON

تحقق من بيانات JSON وفق مخطط JSON (الإصدار 2020-12 أو 2019-09 أو 07) بـ Ajv وفحوص format. يعرض كل خطأ مسار العنصر. يعمل داخل متصفحك.

يعمل بالكامل في متصفحك. لا يتم رفع بياناتك أبدًا.

أدوات ذات صلة

عرض الكل

ما هو مدقّق مخطط JSON؟

يفحص مدقّق مخطط JSON بيانات JSON وفق مخطط JSON ويسرد كل المخالفات – الخصائص المطلوبة الناقصة والأنواع الخاطئة والأعداد خارج النطاق والصيغ غير الصالحة والخصائص الزائدة – كلٌّ مع JSON Pointer للقيمة المخالفة. تُدعم الإصدارات 2020-12 و2019-09 و07.

كيفية استخدام مدقّق مخطط JSON

  1. الصق البيانات في بيانات JSON والمخطط في مخطط JSON (Schema) (أو اضغط تحميل مثال في كل منهما).
  2. اترك إصدار المخطط على الاكتشاف التلقائي، أو اختر إصدارًا.
  3. اقرأ النتيجة: رسالة نجاح، أو قائمة الأخطاء مع مسارات العناصر.
  4. أصلح البيانات (أو المخطط) وتتحدّث النتيجة تلقائيًا.

مثال

الإدخال
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 بعيدة؟

لا، المراجع داخل المخطط نفسه فقط.

لماذا يعرض عدة أخطاء دفعة واحدة؟

تُجمَّع كل الأخطاء لتتمكن من إصلاح كل شيء في مرة واحدة.

الخطوات التالية المقترحة

مولّد JSON Schema
ولّد JSON Schema (مسودة 2020-12) من عيّنة JSON: الأنواع والمفاتيح الإلزامية واتحادات null وعناصر المصفوفات وصيغ النصوص مثل email وdate-time. مجاني.
JSON إلى TypeScript
ولّد واجهات TypeScript أو أسماء أنواع مستعارة من عيّنة JSON، مع مفاتيح اختيارية واتحادات null وأنواع متداخلة تُستنتج من المصفوفات. مجاني وخاص.
JSON إلى Go Struct
حوّل JSON إلى هياكل Go بأسماء حقول مصدَّرة ووسوم json وأنواع مؤشرات لقيم null وomitempty اختياري. يعالج الكائنات والمصفوفات المتداخلة. مجاني.
JSON إلى Python
حوّل JSON إلى فئات dataclass أو TypedDict في Python مع تلميحات الأنواع وحقول Optional وفئات متداخلة معرّفة بترتيب الاعتماد. مجاني داخل المتصفح.
أداة التهريب وإلغائه
أداة واحدة لتهريب السلاسل أو إلغاء تهريبها لـ JSON وJavaScript وHTML وXML ومكونات URL والتعابير النمطية وسلاسل SQL وCSS ووسائط الصدفة.
JSON إلى XML
حوّل JSON إلى XML سليم البنية مع عنصر جذر قابل للضبط وسمات عبر مفاتيح "@_" وعناصر مكررة للمصفوفات وتصريح XML اختياري. مجاني.

استكشف المزيد من الفئات