مدقّق مخطط JSON
تحقّق من JSON بمقارنته بمخطط JSON، واعرض كل خطأ مع مسار القيمة المخالفة والقاعدة التي خالفتها، بما في ذلك التنسيقات مثل البريد الإلكتروني والتاريخ والوقت. تعمل في متصفحك.
الإدخال
الإخراج
ملف القراءة
ما مخطط JSON؟
يصف مخطط JSON الشكل الذي ينبغي أن يكون عليه مستند JSON: الخصائص التي يحتوي عليها الكائن، والخصائص المطلوبة منها، ونوع كل قيمة، والنطاقات والأطوال المسموح بها، والأنماط والتنسيقات مثل عناوين البريد الإلكتروني أو التواريخ. تستخدم واجهات API وملفات الإعدادات وأدوات إنشاء النماذج المخططات للتحقق من البيانات قبل الوثوق بها، كما تصف OpenAPI أجسام الطلبات والاستجابات باستخدامها.
كيفية استخدام أداة التحقق
- الصق مخطط JSON أو اكتبه في المربع الأول.
- الصق بيانات JSON المراد التحقق منها أو اكتبها في المربع الثاني.
- تظهر النتيجة أثناء الكتابة: إما أن يكون JSON صالحًا، أو تُعرض جميع الأخطاء مع مسار القيمة التي لم تجتز التحقق، والكلمة المفتاحية في المخطط التي خالفتها، وتوضيح موجز.
- تُعلَّم كل قيمة لم تجتز التحقق في البيانات. انقر على خطأ للانتقال إلى موضعه في البيانات، أو انقر على علامة لمعرفة الخطأ المرتبط بها في القائمة.
يعرض حقل إصدار المخطط المسودة التي جرى التحقق من البيانات وفقًا لها.
المسودات المدعومة
تحدد الكلمة المفتاحية $schema في المخطط المسودة:
- المسودة 2020-12:
https://json-schema.org/draft/2020-12/schema - المسودة 2019-09:
https://json-schema.org/draft/2019-09/schema - المسودة 7:
http://json-schema.org/draft-07/schema# - المسودة 6:
http://json-schema.org/draft-06/schema#
يُتحقق من المخطط الذي لا يتضمن $schema وفقًا للمسودة 7. لا تُدعم المسودة 4 وما قبلها. يُتحقق أولًا من المخطط نفسه وفقًا للمخطط الفوقي الخاص بمسودته، لذا يُبلَّغ عن خطأ مطبعي مثل "type": "strin" على أنه مخطط غير صالح، بدلًا من تجاهله. لا مشكلة في التعليقات التوضيحية مثل title وdescription وexamples، وكذلك الكلمات المفتاحية التي لا تعرفها المسودة، مثل التعليقات التوضيحية الخاصة بك التي تبدأ بـ x-؛ إذ يتم تجاهلها.
قراءة الأخطاء
- تُكتب المسارات بصيغة JSONPath، بدءًا من
$الذي يمثل المستند بأكمله:$.ingredients[1].unitهوunitالخاص بالمكوّن الثاني. - يُبلَّغ عن الخاصية المطلوبة المفقودة في الكائن الذي ينبغي أن يحتوي عليها، مع ذكر اسم الخاصية في الرسالة.
- يشير الخطأ الخاص بالخاصية الإضافية التي لا يسمح بها المخطط إلى اسم تلك الخاصية.
- في حالتي
enumوconst، تعرض الرسالة القيم المسموح بها. - مع
anyOfوoneOf، يضيف كل فرع لم يجتز التحقق أخطاءه، يتبعها خطأ للكلمة المفتاحية نفسها؛ لذلك قد تنتج عن قيمة واحدة غير صحيحة عدة أخطاء.
تأتي رسائل الأخطاء من مكتبة Ajv، وهي باللغة الإنجليزية.
التنسيقات
تُفحَص أيضًا القيم التي لها format، مثل: email وuri وuri-reference وdate وtime وdate-time وduration وuuid وipv4 وipv6 وhostname وregex وjson-pointer وغيرها. يُتجاهل أي تنسيق لا تتعرف عليه أداة التحقق، كما تسمح مواصفات JSON Schema.
المراجع
تعمل $ref مع التعريفات الموجودة داخل المخطط نفسه، مثل #/$defs/address أو #/definitions/address. لا يتم جلب المراجع إلى ملفات أو عناوين URL أخرى؛ ويُبلَّغ عن المخطط الذي يحتاج إلى أحدها على أنه غير صالح، مع ذكر المرجع الذي تعذّر حله.
آلية العمل
تتحقق الأداة من صحة البيانات باستخدام Ajv، وهي مكتبة واسعة الاستخدام للتحقق من مخططات JSON، كما تتحقق من التنسيقات باستخدام ajv-formats. يجري كل شيء في متصفحك: لا يتم تحميل المخطط أو البيانات.
الميزات
- دعم مسودات JSON Schema 6 و7 و2019-09 و2020-12، وفقًا للقيمة المحددة في
$schema - عرض كل خطأ مع مساره وكلمته المفتاحية ورسالته
- تعليم القيم التي لم تجتز التحقق في البيانات، مع إمكانية النقر للانتقال إليها
- التحقق من تنسيقات البريد الإلكتروني وعناوين URI والتواريخ ومعرّفات UUID وعناوين IP وغيرها
- التحقق من المخطط وفقًا لمخططه الفوقي
- عرض السطر والعمود لأخطاء صياغة JSON
- تعمل في متصفحك