حول مولد JSON Schema — الدليل التفصيلي
يقوم مولد 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 متوافقة مع المعايير من كائنات ومصفوفات JSON عشوائية
- التمييز بدقة بين الأعداد الصحيحة والأرقام العشرية ذات الفاصلة العائمة والأنواع الأولية الأخرى
- اكتشاف استكشافي للصيغ الدلالية بما في ذلك ISO date-time و email و uri
- مربعات اختيار مرئية لتبديل قيود `required` على الخصائص مع ميزة النسخ الفوري
طريقة الاستخدام
- 1
الصق عينة حمولة JSON النموذجية في لوحة الإدخال اليسرى.
- 2
انقر على توليد (Generate) لتحليل أنواع الخصائص والعمق الهيكلي تلقائياً.
- 3
قم بتبديل علامات الحقول المطلوبة `required` حسب الحاجة، ثم انسخ كود JSON Schema الناتج.
حالات الاستخدام الشائعة
- ← توليد مخططات العقود من عينات استجابة واجهات برمجة التطبيقات الفعلية أثناء اختبارات التكامل
- ← إعداد مخططات المصدر لأدوات مثل `json-schema-to-typescript`
- ← فرض قيود هيكلية على حمولات أحداث ناقل الرسائل غير المتزامن (Message Bus)
أدوات ذات صلة
مولد وسوم SEO و Open Graph
توليد وسوم HTML الوصفية و Open Graph و بطاقات Twitter لتحسين ظهور المواقع في محركات البحث.
مولد ملف .gitignore
إنشاء ملفات .gitignore المخصصة للغات الأطر البرمجية المختلفة (Node و Python و Rust و Go).
مولد تراخيص المصادر المفتوحة
إنشاء نصوص التراخيص مفتوحة المصدر (MIT و Apache 2.0 و GPLv3 و BSD) مع حقوق النشر.
مولد ملف README لمشاريع Git
توليد قوالب ملفات README احترافية للمشاريع مفتوحة المصدر مع الشارات والإرشادات.
منشئ رسائل Conventional Commits
صياغة رسائل التعديل لـ Git وفقاً لمعيار Conventional Commits بدقة وتنظيم.
حاسبة ترقيم الإصدارات SemVer
مقارنة وحساب نطاقات ترقيم الإصدارات الدلالية (SemVer) وحل تعارضات الحزم.
الأسئلة الشائعة والخصوصية
كيف يتعامل المولد مع مصفوفة تحتوي على كائنات ذات خصائص متباينة؟
يقوم المحرك بدمج الخصائص عبر جميع الكائنات داخل المصفوفة لبناء مخطط كائن موحد يتحقق من صحة كل عنصر في العينة.
كيف يمكنني التحقق من صحة الحمولات باستخدام المخطط الناتج؟
يمكنك استخدام مكتبات مثل `ajv` في بيئات Node.js أو المتصفح: ترجم المخطط باستخدام `const validate = ajv.compile(schema)` ثم نفذ `validate(data)`.