JSON Schema Doğrulayıcı

Bu araç, Ajv kitaplığı aracılığıyla JSON Schema Draft-07, Draft 2019-09 ve Draft 2020-12 sürümlerini destekler. En yaygın şema özellikleri desteklenir.

Evet! JSON Schema, derinlemesine iç içe nesne ve dizileri destekler. Yuvalanmanın herhangi bir seviyesinde properties ve items tanımlayabilir, her alan için ayrı doğrulama kuralları koyabilirsiniz.

Araç önce şemanızın kendisinin geçerli bir JSON Schema olup olmadığını doğrular. Şemada hatalar varsa, veriyi doğrulamaya çalışmadan önce bunlar raporlanır.

type (string, number, object, array, boolean, null), iç içe şemalar içeren properties, zorunlu anahtarları listeleyen required, sabit değer kümeleri için enum, regex kısıtlı dizeler için pattern ve aralık kontrolleri minimum/maximum ile minLength/maxLength. additionalProperties: false nesneleri fazla anahtarlara karşı sıkılaştırır. Hepsi birlikte API doğrulama kurallarının büyük kısmını kapsar.

Modern JSON Schema'da format varsayılan olarak bir ek açıklamadır, otomatik bir doğrulama değil - doğrulayıcılar yalnızca yapılandırıldığında uygular; 2020-12 belirtimi bunu ayrı bir format-assertion sözlüğüyle açık hale getirdi. Uygulamanın garanti edilmesi gerektiğinde pattern veya özel bir anahtar kelime kullanın; aksi halde format'ı birlikte çalışabilirlik meta verisi olarak görün.

#/$defs/address işaret eden $ref, $defs altındaki bir şema parçasına referans verir ve kullanıldığı her yerde ona göre doğrular - yinelenenleri ayıklama mekanizması budur. Draft 2020-12, eski definitions adını $defs olarak değiştirdi ve yorum ağaçları gibi özyinelemeli yapılar için $dynamicRef'ü resmileştirdi. Referanslar harici belgelere de işaret edebilir, ancak yerel olarak paketlemek daha yaygındır.

allOf her alt şemanın doğrulanmasını gerektirir - bir kesişim; temel şemayı ek kısıtlamalarla birleştirmek için kullanılır. anyOf en az birini gerektirir - bir birleşim; çok biçimli yükler için kullanılır. oneOf tam olarak birini gerektirir; iki ya da sıfır alt şemanın doğrulanması başarısız olur; bu, insanların beklediğinden daha katıdır ve örtüşen şemalarda şaşırtıcı hataların olağan sebebidir.

2020-12, belirtimi ayrı ayrı müzakere edilebilen sözlüklere böldü (validation, annotation, format-assertion), definitions adını $defs yaptı, exclusiveMinimum'u düz bir sayıya sadeleştirdi ve eski items anahtar kelimesini prefixItems artı items ile değiştirdi. Araçların çoğu ikisini de destekler; draft-07 hâlâ en yaygın dağıtılan olandır ama 2020-12 güncel yayımlanmış standarttır.