JSON Schema doğrulayıcı
Tamamen tarayıcınızda çalışır. Dosyalarınız ve verileriniz cihazınızdan hiç çıkmaz.
Bu araç hakkında
Bir tarafa JSON Schema’yı, diğer tarafa da JSON belgenizi yapıştırın; araç verinizi şemaya göre kontrol eder. Her hata, belge içindeki tam yolu ve hangi kuralın ihlal edildiğini gösterir: eksik bir zorunlu alan, yanlış bir tip veya e-posta adresi gibi geçersiz bir format olabilir.
Tam olarak neyi kontrol ediyor, hataları nasıl gösteriyor?
Araç, ilk hatada durmak yerine belgenizi şemadaki tüm kurallara karşı aynı anda doğrular, böylece tüm sorunları tek seferde görürsünüz. Her satır, /users/0/email gibi bir JSON Pointer ile belge içindeki yolu, hangi kuralın (required, type, format vb.) ihlal edildiğini ve Ajv’nin hatayı açıklayan mesajını gösterir. Mümkün olduğunda, yapıştırdığınız JSON’daki satır numarasına da işaret eder, böylece köşeli parantezleri saymak yerine doğrudan sorunlu değere gidebilirsiniz. E-posta adresi, tarih veya URL gibi bir dizginin geçerli bir formatta olup olmadığı ajv-formats paketiyle kontrol edilir.
Doğrulamadan önce hem şema hem belge JSON olarak ayrıştırılır; bir söz dizimi hatası varsa genel bir hata yerine satır numarasıyla birlikte gösterilir. Şemanın kendisi Ajv’nin derleyemeyeceği kadar bozuksa, örneğin desteklenmeyen bir anahtar kelimeye referans veriyorsa, bu da ayrı bir derleme hatası olarak görünür.
Hangi JSON Schema taslağını destekliyor?
Araç, şemanın $schema alanını okuyup doğrulayıcıyı ona göre seçer: Draft 2020-12 bildiren şemalar Ajv’nin 2020 sürümüyle derlenir, daha eski Draft-07 tarzı dahil diğer her şey standart Ajv’ye düşer. Yani hangi taslağı kullandığınızı elle seçmeden her iki tarzı da yapıştırabilirsiniz. Taslaklar arasındaki farklar ve tam spesifikasyon için json-schema.org adresine bakabilirsiniz.
Şemam veya verilerim bir yere gönderiliyor mu?
Hayır. Doğrulama tamamen tarayıcınızda, yaygın olarak kullanılan bir JSON Schema doğrulayıcısı olan Ajv ile çalışır; ne yapıştırdığınız şema ne de belge herhangi bir yere iletilir. Gerçek kullanıcı verisi, kimlik bilgileri veya sunucuya göndermek istemeyeceğiniz başka alanlar içeren yapılandırma dosyalarını, API yüklerini veya test verilerini kontrol ederken bu önemli.
Bir API sözleşmesi için şema yazarken, CI’da bir yükün neden doğrulamayı geçemediğini araştırırken veya bir yapılandırma dosyasını yayına almadan önce son kez kontrol ederken bu araç işinize yarar.