فحص JSON مقابل Schema
أداة فحص JSON Schema تتحقق من مطابقة بيانات JSON لمخطط (Schema) تكتبه أو تلصقه، وتعرض كل خطأ مخالفة على حدة مع مساره الدقيق داخل البيانات (مثل $.user.age) ورسالة واضحة تشرح سبب المخالفة — وليس مجرد "غير صالح" مبهمة. تدعم الأداة أهم قواعد JSON Schema Draft-07 المستخدمة فعليًا: التحقق من النوع، الحقول المطلوبة، القيم المسموح بها (enum)، حدود الأرقام والنصوص والمصفوفات، الأنماط النصية (pattern)، وقواعد الدمج (allOf وanyOf وoneOf وnot). كل الفحص يتم داخل متصفحك عبر محلل مكتوب خصيصًا لهذا الموقع دون رفع بياناتك أو مخططك لأي خادم.
تتم معالجة البيانات والمخطط بالكامل داخل جهازك ولا يُرسلان إلى أي خادم.
ستظهر النتيجة هنا بعد الضغط على "فحص"
ما الذي تفعله هذه الأداة
تتحقق أن بيانات JSON تطابق مخطط JSON Schema الذي تكتبه، وتبيّن كل مخالفة بمسارها داخل البيانات.
متى تستخدمها
- تتأكد أن استجابة واجهة برمجية تطابق العقد المتفق عليه.
- تتحقق من ملف إعدادات قبل نشره.
- تراجع بيانات ولّدها نموذج لغوي وتريد تأكيد مطابقتها للشكل المطلوب.
- تختبر مخططًا كتبته على أمثلة حقيقية.
طريقة الاستخدام
- الصق «بيانات JSON» في حقلها.
- الصق «مخطط JSON Schema» في حقله.
- اضغط «تحقّق» واقرأ النتيجة: إما مطابقة تامة، أو قائمة بالمخالفات ومسار كل منها.
مثال عملي
المُدخَل
مخطط يشترط حقل email نصيًا ومطلوبًا، مع بيانات ينقصها هذا الحقل.
الناتج
رسالة تبيّن أن الحقل المطلوب email مفقود، مع مساره داخل البيانات.
حدود الأداة
- المدعوم هو المجموعة العملية الشائعة من Draft-07: النوع، والقيم المحصورة والثابتة، وخصائص الكائنات والحقول المطلوبة، وقيود المصفوفات والنصوص والأرقام، والمركّبات allOf وanyOf وoneOf وnot.
- الإشارات المرجعية $ref غير مدعومة، ولا يُجلب أي مخطط من الإنترنت — وهذا مقصود: الأداة لا تتصل بالشبكة إطلاقًا.
- كلمة format مدعومة في عدد محدود من الحالات الشائعة فقط.
- المخطط نفسه يجب أن يكون JSON صالحًا، ويُنبَّه على ذلك منفصلًا عن أخطاء البيانات.
الخصوصية والمعالجة
البيانات والمخطط كلاهما يُعالَج داخل جهازك ولا يُرسل أي منهما إلى أي خادم.
ملاحظات تقنية
- المتحقّق مكتوب داخل المشروع لا مستوردًا من مكتبة، لأن الحالة العملية المستهدفة — «هل تطابق بياناتي الشكل الذي وصفته» — تغطيها مجموعة محدودة من الكلمات المفتاحية دون حمل مواصفة كاملة.
الأسئلة الشائعة
تدعم الأداة أهم القواعد المستخدمة فعليًا في Draft-07 (النوع، الحقول المطلوبة، الحدود، الأنماط، enum/const، ودمج المخططات عبر allOf/anyOf/oneOf/not)، لكنها لا تدعم حاليًا $ref أو جلب مخططات خارجية عبر الشبكة.