Generator JSON Schema

Yang dapat dilakukan inferensi dengan baik

• Tipe: string, number, integer, boolean, null, array, object.
• Kemampuan bernilai null: bidang yang bernilai null pada satu sampel dan berupa string pada sampel lain akan menjadi ["string", "null"].
• Elemen array: array homogen menghasilkan satu skema items; array heterogen menghasilkan prefixItems.
• Enum: jika semua nilai yang teramati berasal dari himpunan kecil (dapat dikonfigurasi, default 10 nilai berbeda), sistem menghasilkan enum.
• Wajib: dengan beberapa sampel, irisan kunci menjadi required; dengan satu sampel, semua kunci wajib kecuali Anda memilih untuk tidak menyertakannya.
• Format: string yang cocok dengan tanggal ISO-8601, email, atau URI memperoleh format yang disimpulkan.

Yang tidak dapat diketahui inferensi

• Maksud vs contoh: sampel age: 25 menyimpulkan type: integer, tetapi tidak dapat mengetahui bahwa Anda juga menerima null. Berikan beberapa sampel yang mencakup kasus tepi.
• Batasan: minLength, maximum, pattern, Anda harus menambahkannya secara manual. Inferensi tidak menebak batas dari sampel.
• Logika bisnis: “tepat satu dari tiga bidang ini harus diisi” memerlukan oneOf, tidak dapat disimpulkan.
• Referensi: generator menghasilkan skema datar. Jika Anda ingin memisahkan bentuk yang berulang ke dalam $defs, lakukan itu setelah proses pembuatan.

Contoh keluaran

Dari satu sampel:

{ "name": "Alice", "age": 30, "tags": ["admin", "user"] }

Skema yang disimpulkan (draft 2020-12):

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "name": { "type": "string" },
    "age": { "type": "integer" },
    "tags": { "type": "array", "items": { "type": "string" } }
  },
  "required": ["name", "age", "tags"]
}

Kesalahan umum

• Menyimpulkan dari satu sampel saja. Skema akan overfitting, setiap bidang menjadi wajib, tanpa toleransi terhadap null. Selalu masukkan minimal 5–10 sampel yang beragam.
• Menggunakan integer padahal maksud Anda number. Jika ada sampel yang mengandung desimal, tipe yang disimpulkan menjadi number; jika semuanya bilangan bulat, menjadi integer. Untuk bidang yang bisa keduanya, sertakan sampel dengan angka desimal.
• Melupakan bidang opsional. Bidang yang muncul di 4 dari 5 sampel tetapi tidak ada di 1 sampel menjadi opsional, sesuai maksud. Jika kelima sampel kebetulan menyertakannya, skema akan menandainya wajib meskipun sebenarnya opsional di API Anda.