JSON Schema Doğrulayıcı
JSON verilerini bir JSON Schema'ya göre doğrulayın; e-posta ve tarih-saat gibi biçimler de dâhil olmak üzere her hatayı, başarısız olan değerin yolunu ve ihlal ettiği kuralı görün. Tarayıcınızda çalışır.
Girdi
Çıktı
Readme
JSON Schema nedir?
JSON Schema, bir JSON belgesinin nasıl görünmesi gerektiğini açıklar: bir nesnenin hangi özelliklere sahip olduğunu, bunlardan hangilerinin zorunlu olduğunu, her değerin türünü, izin verilen aralıkları ve uzunlukları, e-posta adresleri veya tarihler gibi kalıpları ve biçimleri belirtir. API'ler, yapılandırma dosyaları ve form oluşturucular, verileri güvenilir kabul etmeden önce denetlemek için şemalardan yararlanır; OpenAPI de istek ve yanıt gövdelerini şemalarla tanımlar.
Doğrulayıcı nasıl kullanılır?
- JSON Schema'yı ilk kutuya yapıştırın veya yazın.
- Denetlenecek JSON verisini ikinci kutuya yapıştırın veya yazın.
- Siz yazarken sonuç görünür: JSON ya geçerlidir ya da her hata, başarısız olan değerin yolu, ihlal edilen şema anahtar sözcüğü ve kısa bir açıklamayla listelenir.
- Başarısız olan her değer veride işaretlenir. Veriyi ilgili konuma kaydırmak için bir hataya, listedeki hatasını bulmak için de bir işarete tıklayın.
Şema sürümü alanı, verinin hangi JSON Schema taslağına göre denetlendiğini gösterir.
Hangi taslakları destekliyor?
Şemanın $schema anahtar sözcüğü taslağı belirler:
- Taslak 2020-12:
https://json-schema.org/draft/2020-12/schema - Taslak 2019-09:
https://json-schema.org/draft/2019-09/schema - Taslak 7:
http://json-schema.org/draft-07/schema# - Taslak 6:
http://json-schema.org/draft-06/schema#
$schema içermeyen bir şema, taslak 7 olarak denetlenir. Taslak 4 ve daha eski sürümler desteklenmez. Şemanın kendisi önce taslağının meta şemasına göre denetlenir; bu nedenle "type": "strin" gibi bir yazım hatası yok sayılmak yerine geçersiz şema olarak bildirilir. title, description ve examples gibi açıklama ekleyen anahtar sözcüklerin yanı sıra taslağın tanımadığı, kendinize ait x- açıklamaları gibi anahtar sözcükler de kullanılabilir: bunlar yok sayılır.
Hataları anlama
- Yollar, tüm belgeyi belirten
$ile başlayan JSONPath biçiminde yazılır:$.ingredients[1].unit, ikinci malzemeninunitdeğerini belirtir. - Eksik bir zorunlu özellik, bulunması gereken nesne üzerinde ve mesajda özelliğin adı belirtilerek bildirilir.
- Şemanın izin vermediği fazladan bir özellik için o özelliğin adı gösterilir.
enumveconstiçin mesajda izin verilen değerler listelenir.anyOfveoneOfkullanıldığında, başarısız olan her dal kendi hatalarını ekler; ardından anahtar sözcüğün kendisi için de bir hata eklenir. Bu nedenle tek bir yanlış değer birden fazla hataya yol açabilir.
Hata mesajları Ajv kitaplığından gelir ve İngilizcedir.
Biçimler
format belirtilen değerler de denetlenir: email, uri, uri-reference, date, time, date-time, duration, uuid, ipv4, ipv6, hostname, regex, json-pointer ve daha fazlası. Doğrulayıcının tanımadığı bir biçim, JSON Schema belirtiminin izin verdiği şekilde yok sayılır.
Başvurular
$ref, aynı şema içindeki #/$defs/address veya #/definitions/address gibi tanımlarla çalışır. Diğer dosyalara veya URL'lere yapılan başvurular alınmaz: böyle bir başvuruya ihtiyaç duyan şema, çözümlenemeyen başvuru belirtilerek geçersiz olarak bildirilir.
Nasıl çalışır?
Araç, yaygın olarak kullanılan bir JSON Schema doğrulayıcısı olan Ajv ile doğrulama yapar ve biçimleri ajv-formats ile denetler. Her şey tarayıcınızda çalışır: şema ve veriler hiçbir zaman yüklenmez.
Özellikler
$schemadeğerine göre seçilen JSON Schema taslakları: 6, 7, 2019-09 ve 2020-12- Yolu, anahtar sözcüğü ve mesajıyla birlikte her hata
- Veride işaretlenen başarısız değerler; tıklayarak ilgili konuma kaydırma
- E-postalar, URI'ler, tarihler, UUID'ler, IP adresleri ve daha fazlası için biçim denetimleri
- Şemanın meta şemasına göre denetlenmesi
- JSON sözdizimi hatalarının satır ve sütun bilgisi
- Tarayıcınızda çalışır