JSON Schema Doğrulayıcı

Ne işe yarar

JSON Schema, JSON verisinin biçimini tanımlayan bir sözlüktür: bir nesnenin hangi özelliklere sahip olması gerektiği, her değerin türü, izin verilen aralıklar ve kalıplar, dizi uzunlukları ve çok daha fazlası. API’ler OpenAPI belirtimlerinde, editörler yapılandırma dosyalarında otomatik tamamlama için, arka uçlar da hatalı istekleri reddetmek için kullanır.

Bu doğrulayıcı bir JSON belgesini şemaya göre denetler ve bulduğu her sorunu listeler. Her hata, verideki yerini (/tags/1 gibi bir JSON Pointer), okunabilir bir mesajı ve başarısız olan şema anahtar kelimesini gösterir; böylece veriyi ya da şemayı hızla düzeltebilirsiniz. Draft 2020-12, 2019-09, draft-07 ve draft-04 desteklenir; $ref, $defs, allOf/anyOf/oneOf, if/then/else, unevaluatedProperties ve biçim denetimleri dahildir.

Nasıl kullanılır

1. Veriyi JSON verisi alanına, şemayı JSON Schema alanına yapıştırın ya da her iki tarafa birer dosya yükleyin. Örnek, kasıtlı birkaç hata içeren bir kullanıcı kaydı yükler.
2. Sonuç siz yazdıkça güncellenir: veri geçerliyse yeşil bir rozet, değilse hata sayısı ve listesi görünür.
3. $schema’yı izlemek için Sürüm’ü Otomatik bırakın veya bir sürümü zorlayın. İlk hatada durmak için Tüm hataları göster’i kapatın.
4. Hataları kopyala, listeyi hata raporu veya kod incelemesi için düz metin olarak kopyalar.

Taraflardan biri geçerli JSON değilse, mesaj sorunun veride mi şemada mı olduğunu satır ve sütunla birlikte söyler.

Örnek

Bu şemayla:

{
  "type": "object",
  "required": ["id"],
  "properties": {
    "id": { "type": "integer" },
    "age": { "type": "integer", "minimum": 0 }
  }
}

{"age": -1} belgesi iki hata üretir: (kök) düzeyinde zorunlu id özelliği eksik; /age değeri en küçük değer olan 0’ın altında.

İpuçları

Yanlış yazılmış özellik adlarını yakalamak için "additionalProperties": false ekleyin; aksi hâlde sessizce geçerler. Sabit değerler için enum ya da const, ürün kodu gibi dizeler için pattern kullanın. Şema büyüdüğünde tekrarlanan kısımları $defs içine taşıyıp $ref ile başvurun.