JSON Şema Oluşturucu

Çıkarımın iyi yaptığı şeyler

• Türler: string, number, integer, boolean, null, array, object.
• Null olabilirlik: bir örnekte null, başka bir örnekte dize olan bir alan ["string", "null"] olur.
• Dizi öğeleri: homojen diziler tek bir items şeması üretir; heterojen diziler prefixItems üretir.
• Enum: gözlemlenen tüm değerler küçük bir kümeden geliyorsa (yapılandırılabilir, varsayılan 10 farklı değer), bir enum üretilir.
• Zorunlu: birden fazla örnekte anahtarların kesişimi required olur; tek bir örnekte, vazgeçmediğiniz sürece tüm anahtarlar zorunludur.
• Formatlar: ISO-8601 tarihleri, e-postalar veya URI’lerle eşleşen dizeler çıkarılmış bir format alır.

Çıkarımın bilemeyeceği şeyler

• Amaç ve örnek karşılaştırması: age: 25 örneği type: integer çıkarır, ancak null değerini de kabul ettiğinizi bilemez. Uç durumları kapsayan birden fazla örnek verin.
• Kısıtlamalar: minLength, maximum, pattern, bunları elle eklemeniz gerekir. Çıkarım, örneklerden sınırları tahmin etmez.
• İş mantığı: “bu üç alandan tam olarak biri ayarlanmalıdır” koşulu oneOf gerektirir, çıkarılamaz.
• Referanslar: oluşturucu düz bir şema üretir. Tekrar eden yapıları $defs içine ayırmak isterseniz, bunu oluşturmadan sonra yapın.

Örnek çıktı

Tek bir örnekten:

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

Çıkarılan şema (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"]
}

Yaygın hatalar

• Tek bir örnekten çıkarım yapmak. Şema aşırı uyum sağlar, her alan zorunlu hale gelir ve null’a tolerans kalmaz. Her zaman en az 5–10 çeşitli örnek verin.
• number demek isterken integer kullanmak. Herhangi bir örnekte ondalık varsa çıkarılan tür number olur; hepsi tam sayıysa integer olur. Her ikisi de olabilecek alanlar için ondalıklı bir örnek ekleyin.
• İsteğe bağlı alanları unutmak. 5 örnekten 4’ünde bulunan ancak 1’inde eksik olan bir alan isteğe bağlı olur, bu kasıtlıdır. Beş örneğin hepsi bu alanı içeriyorsa, API’nizde aslında isteğe bağlı olsa bile şema onu zorunlu olarak işaretler.