مولد JSON Schema

توليد مواصفات JSON Schema تلقائياً من بيانات JSON النموذجية للتحقق من واجهات API.

حول مولد JSON Schema — الدليل التفصيلي

الفئة: DevOps والمعايير معالجة محلية 100% في المتصفح

يقوم مولد JSON Schema باستنتاج مواصفات JSON Schema القياسية مباشرة من عينات حمولات بيانات JSON. يدعم معايير Draft-07 و Draft 2019-09 و Draft 2020-12.

يحلل المحرك هياكل البيانات لاكتشاف الأنواع الأولية (string و integer و number و boolean و array و object و null) ويتعرف على الصيغ الدلالية مثل date-time و email و uri. يمكنك تخصيص مربعات الاختيار للخاصية `required` ونسخ كود المخطط النظيف بنقرة واحدة.

#json #schema #generate #validation #typescript

الميزات والقدرات الرئيسية

  • استنتاج تعريفات JSON Schema متوافقة مع المعايير من كائنات ومصفوفات JSON عشوائية
  • التمييز بدقة بين الأعداد الصحيحة والأرقام العشرية ذات الفاصلة العائمة والأنواع الأولية الأخرى
  • اكتشاف استكشافي للصيغ الدلالية بما في ذلك ISO date-time و email و uri
  • مربعات اختيار مرئية لتبديل قيود `required` على الخصائص مع ميزة النسخ الفوري

طريقة الاستخدام

  1. 1

    الصق عينة حمولة JSON النموذجية في لوحة الإدخال اليسرى.

  2. 2

    انقر على توليد (Generate) لتحليل أنواع الخصائص والعمق الهيكلي تلقائياً.

  3. 3

    قم بتبديل علامات الحقول المطلوبة `required` حسب الحاجة، ثم انسخ كود JSON Schema الناتج.

حالات الاستخدام الشائعة

  • ← توليد مخططات العقود من عينات استجابة واجهات برمجة التطبيقات الفعلية أثناء اختبارات التكامل
  • ← إعداد مخططات المصدر لأدوات مثل `json-schema-to-typescript`
  • ← فرض قيود هيكلية على حمولات أحداث ناقل الرسائل غير المتزامن (Message Bus)

أدوات ذات صلة

الأسئلة الشائعة والخصوصية

كيف يتعامل المولد مع مصفوفة تحتوي على كائنات ذات خصائص متباينة؟

يقوم المحرك بدمج الخصائص عبر جميع الكائنات داخل المصفوفة لبناء مخطط كائن موحد يتحقق من صحة كل عنصر في العينة.

كيف يمكنني التحقق من صحة الحمولات باستخدام المخطط الناتج؟

يمكنك استخدام مكتبات مثل `ajv` في بيئات Node.js أو المتصفح: ترجم المخطط باستخدام `const validate = ajv.compile(schema)` ثم نفذ `validate(data)`.