JSON Schema Doğrulayıcı

JSON Verisi

1
2
3
4
5
6
7
8
9
10

JSON Schema

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

Doğrulama Sonuçları

JSON Verisini Doğrula

Veri yapısını ve kısıtları doğrulamak için JSON verisi ve şemayı girin

Veri türlerini ve yapıyı doğrular

Gerekli property'leri kontrol eder

Kısıtları ve formatları doğrular

JSON'u JSON Schema'ya göre doğrulama — adım adım kılavuz

Bir şema sözleşmesine göre JSON verisini kontrol ederek API yanıtlarını, yapılandırma dosyalarını ve payload örneklerini doğrulayın. Bu; hata ayıklama, dokümantasyon ve sözleşme testi için faydalıdır.

  1. Adım 1 – JSON verinizi yapıştırın

    • İçeriği JSON Verisi editörüne yapıştırın.
    • JSON'unuz bir dosyada, URL'de veya panodaysa İçe Aktar düğmesini kullanın.
  2. Adım 2 – JSON Schema'nızı yapıştırın

    • Şemayı JSON Schema editörüne yapıştırın.
    • Temel yapıya odaklanın: type, properties, required, items.
  3. Adım 3 – Doğrulama sonucunu okuyun

    • Sağ panelde valid bayrağı ve errors listesi görünür.
    • Uyumsuz alanı bulmak için hata yollarını (error paths) kullanın.
  4. Adım 4 – Veriyi veya şemayı düzeltin

    • Veri yanlışsa payload'u düzeltin (eksik alanlar, yanlış türler).
    • Sözleşme değiştiyse şemayı güncelleyin ve doğrulamayı tekrar çalıştırın.
  5. Adım 5 – CI'da katı bir doğrulayıcı kullanın

    • Üretim seviyesinde doğrulama için (draft desteği, $ref, bileşim) CI'da tam bir JSON Schema doğrulayıcı çalıştırın.
    • Şemanızı versiyonlayın ve gerçek payload fixture'larıyla test edin.

JSON Schema özellikleri hakkında önemli not

  • Bu doğrulayıcı bilerek hafiftir ve temel anahtar kelimelere odaklanır ( type, properties, required, items).
  • Şu anahtar kelimelere dayanan şemalar $ref, anyOf, oneOf, veya allOf tam bir doğrulayıcı gerektirebilir.
Örnek: JSON verisini şemaya göre doğrulama
// JSON data
{ "id": 1, "name": "Maeve Winters" }

// JSON Schema
{
  "type": "object",
  "properties": {
    "id": { "type": "integer" },
    "name": { "type": "string" },
    "email": { "type": "string" }
  },
  "required": ["id", "name", "email"]
}

// Result
{
  "valid": false,
  "errors": ["root: Missing required property 'email'"]
}

İlgili JSON Schema araçları

Şema üretmek, mock payload oluşturmak ve doğrulamadan önce JSON'u temizlemek için bu araçları kullanın.

Sık Sorulan Sorular

JSON Schema doğrulaması nedir?

JSON Schema doğrulaması, bir JSON dokümanının belirli bir şemaya uyup uymadığını kontrol etme işlemidir. Şemada tanımlı veri türlerini, gerekli property'leri, kısıtları ve yapı kurallarını doğrular.

JSON'u bir şemaya göre nasıl doğrularım?

JSON verinizi giriş editörüne ve şemanızı ayarlar paneline girin. Doğrulama, yazdıkça otomatik olarak gerçekleşir.

Hangi doğrulama hatalarıyla karşılaşabilirim?

Yaygın hatalar; tür uyuşmazlığı, gerekli property eksikliği, şemada izin verilmeyen ek property'ler, string uzunluğu ihlalleri ve sayı aralığı ihlalleridir.

Özel JSON şemaları kullanabilir miyim?

Evet. Standart JSON Schema JSON'u yapıştırabilirsiniz; ancak bu doğrulayıcı type/properties/required/items gibi temel anahtar kelimelere odaklanır ve $ref çözümlemez veya gelişmiş bileşim anahtar kelimelerini tam değerlendirmez.

JSON Schema Doğrulayıcı | JSONSwiss