مولد مخطط JSON
توليد مخطط JSON تلقائيًا من بيانات JSON
إدخال JSON
المخطط المولَّد
ما هو مولد مخطط JSON؟
مخطط JSON يصف بنية بيانات JSON: الحقول المطلوبة والأنواع والقيم المسموحة والتنسيقات. يستنتج مولد المخطط مخططًا من JSON نموذجي. تلصق البيانات النموذجية، وتولد الأداة مخططًا يصف تلك البنية. يمكنك بعد ذلك استخدام المخطط للتحقق من JSON آخر أو توثيق واجهات برمجة التطبيقات.
تعمل هذه الأداة في المتصفح. الصق JSON وسيُولَّد مسودة مخطط JSON. لا يتم إرسال أي بيانات إلى خادم.
كيفية استخدام هذه الأداة
الصق JSON النموذجي
الصق JSON الذي يمثل البنية التي تريد وصفها. استخدم تحميل مثال أو رفع الملف إذا لزم الأمر. يستنتج المولد الأنواع من القيم (string, number, boolean, array, object).
راجع المخطط
تُظهر اللوحة اليمنى المخطط المولَّد. قد يحتوي على type وproperties وrequired ومخططات متداخلة للكائنات. يمكنك تعديله يدويًا إذا لزم الأمر.
انسخ أو نزّل
استخدم <strong>نسخ</strong> أو <strong>تنزيل</strong> للحصول على المخطط. للتحقق من JSON مقابل المخطط استخدم مدقق JSON أو مكتبة مثل <a href="https://ajv.js.org/" target="_blank" rel="noopener">Ajv</a>.
أمثلة مخطط JSON
ولّد مخططًا من JSON نموذجي. مثال من مجال الاتصالات:
إدخال JSON
المخطط المولَّد
متى تستخدم المخطط المولَّد
المخططات المولَّدة هي نقطة بداية. تسجّل بنية البيانات النموذجية، لكنها قد تكون صارمة أكثر من اللازم أو أقل صرامة. قد تحتاج لإضافة مصفوفات required أو تعديل الأنواع أو إضافة enum للقيم المسموحة. وثائق JSON Schema تشرح المفردات الكاملة. لتوثيق واجهات برمجة التطبيقات، أدوات مثل OpenAPI يمكنها الإشارة إلى مخطط JSON.
الأسئلة الشائعة
هل يمكنني التحقق من JSON باستخدام هذا المخطط؟
هذه الأداة تولّد المخططات فقط. للتحقق استخدم مدقق JSON أو مكتبة مثل Ajv في الكود الخاص بك.
ماذا لو كان JSON الخاص بي بأشكال مختلفة؟
يستنتج المولد من النموذج المُقدَّم. إذا كان JSON يمكن أن يكون بأشكال متعددة (مثل حقول اختيارية)، قد يحتاج المخطط لتعديلات يدوية. استخدم oneOf أو anyOf للتغييرات.
هل يتم إرسال البيانات إلى أي مكان؟
لا. يتم التوليد في المتصفح.
أي إصدار من مسودة JSON Schema يُستخدم؟
قد تستخدم الأداة draft-07 أو draft-2020-12. تحقق من $schema في المخطط المولَّد لرؤية الإصدار. مواصفات JSON Schema تحتوي على التفاصيل.
هل يمكنني استخدام هذا لردود واجهات برمجة التطبيقات؟
نعم. الصق ردًا نموذجيًا من واجهة برمجة التطبيقات. المخطط المولَّد سيصف تلك البنية. يمكنك استخدامه بعد ذلك في OpenAPI/Swagger أو للتوثيق.
أدوات ذات صلة
مزيد من المعلومات على json-schema.org وJSON Schema Learn. للتحقق في الكود راجع Ajv. لـ JSON: json.org، MDN، RFC 8259. لتوثيق واجهات برمجة التطبيقات: OpenAPI.