تحويل JSON إلى JSON Schema — Numio

متى تستخدمها

• إنشاء أول مخطط تحقق لاستجابة API أو حمولة webhook من أمثلة ملتقطة.
• إنتاج مخطط لتمريره إلى Ajv أو OpenAPI أو إلى خطوة تحويل JSON Schema إلى TypeScript/Zod.

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

1. الصق عينة JSON في المحرر الأيسر، أو استخدم زر تحميل الملف لفتح ملف بترميز UTF-8. تعطي مصفوفة من عدة سجلات قوائم required أدق.
2. اقرأ المخطط: في الكائن المفرد كل مفتاح إلزامي (required)، والمفاتيح الغائبة أو التي قيمتها null في بعض عناصر المصفوفة اختيارية.
3. انسخ المخطط وأضف القيود التي لا تُظهرها العينة، مثل الصيغ وenum وinteger وminimum.

[
  { "id": 1, "name": "Ada", "email": null },
  { "id": 2, "name": "Lin", "email": "lin@example.com" }
]

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "Generated schema for Root",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": {
        "type": "number"
      },
      "name": {
        "type": "string"
      },
      "email": {
        "type": "string"
      }
    },
    "required": [
      "id",
      "name"
    ]
  }
}

التفاصيل والقيود

الأعداد دائمًا "type": "number"؛ ولا تُستنتج integer ولا الصيغ (email وdate-time) ولا enum ولا pattern. العنوان دائمًا "Generated schema for Root".

الحقل الذي قيمته null في كل مكان يحصل على مخطط فارغ {}. وتُعامَل null الموجودة إلى جانب قيم أخرى كدلالة على أن الحقل اختياري، لا كنوع null.

المصفوفات مختلطة الأنواع مثل [1, "x"] تصبح tuple (قائمة items مع additionalItems: false)؛ والمصفوفة الفارغة تعطي items: {}.

يُنشأ في متصفحك بواسطة json_typegen المُترجَم إلى WebAssembly. يُظهر JSON غير الصالح (بما فيه الفواصل الزائدة في النهاية) خطأ تحليل JSON، وتُرفض القيمة المفردة مثل 42 لأنها بلا بنية.

FAQ

أدوات ذات صلة

المواصفات والمراجع

• JSON Schema draft-07