# منشئ مخططات JSON

أنشئ مخطط JSON من عينة JSON. يستنتج المنشئ الأنواع والخصائص المطلوبة ومخططات عناصر المصفوفات وتنسيقات السلاسل النصية الشائعة، مثل date-time وemail وuri وuuid، وينشئ مخططًا للمسودة 2020-12 أو 2019-09 أو draft-07، لاستخدامه في التحقق من صحة الطلبات أو توثيق API أو إنشاء النماذج.

## الأسئلة الشائعة

### ما مسودات مخطط JSON المدعومة؟

المسودة 2020-12، وهي الإصدار الحالي الذي يستخدمه OpenAPI 3.1، والمسودة 2019-09 والمسودة draft-07، التي لا تزال كثير من أدوات التحقق والأدوات الأقدم تتوقعها. يحدد الاختيار $schema URL؛ أما الكلمات المفتاحية التي ينشئها المنشئ فتعني الشيء نفسه في المسودات الثلاث.

### كيف تُحدَّد الخصائص المطلوبة؟

تُدرج الخاصية ضمن required إذا ظهرت في كل عينة من عينات ذلك الكائن. وفي مصفوفة من الكائنات، لا يُدرج المفتاح الغائب عن بعض العناصر ضمن required. أوقف الخيار لإنشاء مخطط بلا أي قوائم required.

### ما تنسيقات السلاسل النصية التي يجري التعرّف عليها؟

date-time وdate وtime وemail وuri وuuid وipv4. لا يُضاف التنسيق إلا إذا طابقت كل قيمة عينة للخاصية ذلك التنسيق؛ لذا فإن وجود قيمة واحدة بنص حر يُبقي الخاصية سلسلة نصية عادية. أوقف التعرّف إذا لم ترغب في كلمات التنسيق المفتاحية.

### هل يميّز المخطط بين الأعداد الصحيحة والعشرية؟

نعم. تُحدَّد الخاصية على أنها integer إذا كانت كل عيناتها أعدادًا صحيحة. وبمجرد أن تحتوي عينة واحدة على جزء كسري، يصبح النوع number، وهو يقبل الأعداد الصحيحة أيضًا.

### كيف توصف المصفوفات؟

يكون نوع المصفوفة array، ويُنشأ مخطط items استنادًا إلى جميع عناصرها مجتمعة. وتُدمج الكائنات في المصفوفة، لذا يسرد مخطط items كل مفتاح يظهر في أي عنصر، بينما يقتصر required على المفاتيح الموجودة في جميع العناصر.

### ماذا يحدث عند اختلاط الأنواع؟

عندما تحتوي الخاصية على قيم بسيطة من أنواع مختلفة، مثل سلسلة نصية في عنصر وnull في عنصر آخر، يسردها المخطط ضمن مصفوفة أنواع؛ مثل ["string", "null"]. وعندما تختلط الكائنات أو المصفوفات بأنواع أخرى، يستخدم المنشئ anyOf مع مخطط لكل نوع.

### هل يضيف additionalProperties أو قيودًا؟

لا. لا توضح العينة المفاتيح الإضافية المحظورة أو الحدين الأدنى والأقصى الفعليين، لذا لا يضيف المنشئ additionalProperties أو minLength أو maximum والكلمات المفتاحية المشابهة. أضفها يدويًا حسب احتياجات بياناتك.

### هل يمكنني التحقق من صحة البيانات باستخدام الناتج؟

نعم. الصق المخطط وبياناتك في مدقق مخططات JSON، أو استخدمه مع مكتبة مثل Ajv. تحقّق من المخطط أولًا: فهو يعكس عينتك، لذا يحتاج الحقل الذي قد يكون غائبًا أو null في البيانات الفعلية، لكنه غير ذلك في العينة، إلى تعديل بسيط.

### هل يمكنني استخدام المخطط في OpenAPI؟

يستخدم OpenAPI 3.1 صيغة JSON Schema 2020-12 مباشرةً، لذا يمكن وضع المخطط المُنشأ ضمن components/schemas بعد إزالة السطر $schema. يستخدم OpenAPI 3.0 مجموعة فرعية أقدم؛ لذا استبدل مصفوفات النوع بـ nullable.

### ما الحد الأقصى لحجم الإدخال؟

حتى 1,000,000 حرفًا من JSON، مع تداخل يصل إلى 64 مستوى. تُحلَّل العينة لهذا الطلب فقط ولا تُخزَّن.

إعلانك هنا؟

[راسلنا عبر البريد الإلكتروني](mailto:hi@dennn.is?subject=%D8%A7%D9%84%D8%A5%D8%B9%D9%84%D8%A7%D9%86%20%D8%B9%D9%84%D9%89%20OneClick%20Pro)

[إعلان 433 أداة لوكلاء الذكاء الاصطناعي عبر خادم MCP واحد.](https://multitaskai.com/ar/?ref=oneclickpro)
