JSON verisini şemaya göre doğrulama

Ne işe yarar?

JSON verisini bir JSON Schema belgesine göre incelemek, verinin beklenen türleri, zorunlu alanları ve tanımlanmış sınırları karşılayıp karşılamadığını görmenize yardımcı olur. JSON metnini ve şema metnini ayrı alanlara girerek doğrulama sonucu alabilirsiniz. Bu yaklaşım, özellikle bir veri örneğini göndermeden veya başka bir işleme almadan önce yapısal kontrolleri gözden geçirmek için uygundur.

Araç, girilen iki metni JSON olarak ayrıştırır ve ardından veriyi sağlanan şemaya göre kontrol eder. Sonuçta verinin geçerli olup olmadığı ve uygulanabilir doğrulama ayrıntıları bildirilir. İşlem durumu ile geçerlilik sonucu birbirinden ayrıdır; geçersiz veri veya ayrıştırma hatası, işlemin tamamlanmadığı anlamına gelmez.

Nasıl kullanılır?

JSON veri metninizi veri alanına, bu veriyi değerlendirecek JSON Schema metninizi şema alanına girin. Her iki alan da isteğe bağlıdır ve boş bırakıldığında boş metin olarak değerlendirilir; ancak alanlardan biri boş veya yalnızca boşluk içeriyorsa sonuç veri ya da şemanın eksik olduğunu belirten geçersiz bir sonuç olur.
Doğrulamayı başlatın. Araç önce veri metnini, sonra şema metnini JSON olarak ayrıştırır. Metinlerden biri JSON biçiminde değilse sonuç geçersiz olur ve ayrıştırma hatasına ilişkin bir açıklama gösterilir. Bu nedenle tırnak işaretlerini, süslü parantezleri, köşeli parantezleri ve virgülleri kontrol edin.
Geçerli JSON metinleriyle doğrulama sonucunu inceleyin. Şemada tanımlanan dize, sayı, tam sayı, doğru-yanlış, nesne ve dizi türleri; iç içe değerler için de kontrol edilebilir. Nesne kuralları tanımlanmışsa mevcut özellikler incelenir, zorunlu olarak belirtilen eksik özellikler bildirilir ve ek özelliklere izin verilmeyen bir şema, tanımlanmamış özellikleri reddedebilir.
Şemanızda bulunan sınırları da kontrol edin. Enum üyeliği, sayısal en düşük ve en yüksek değerler ile dizelerin en kısa ve en uzun uzunlukları uygulanabilir. Dizilerdeki öğeler için nesne biçiminde bir öğe kuralı varsa her öğe bu kurala göre incelenir. Nesne olmayan bir öğe kuralı koleksiyonu, kullanılacak ilk şemayı içermiyorsa doğrulama hatasına yol açabilir.

Sonuç nasıl okunur?

Geçerli bir sonuç, veri metninin sağlanan şemadaki ve çalışma davranışında uygulanan kontrollerden geçtiğini gösterir. Geçersiz sonuç ise tek bir nedene bağlı olmayabilir: eksik zorunlu özellik, uyumsuz tür, izin verilmeyen ek özellik, sınır ihlali, dizi öğesi kuralı sorunu veya ayrıştırma problemi ayrıntılarda belirtilebilir. Önce veri ve şema metninin gerçekten JSON olarak ayrıştırıldığını, ardından bildirilen doğrulama nedenini değerlendirin.

Örneğin {"age":-1} verisini, age alanını tam sayı ve en düşük değerini 0 olarak tanımlayan bir şemayla gönderirseniz beklenen sonuç şekli geçersiz bir doğrulama sonucu ve negatif tam sayının en düşük değeri karşılamadığına ilişkin bir ayrıntıdır. Bu, aynı şemanın başka kurallarının da ayrıca kontrol edilebileceği anlamına gelir; yalnızca bu örneğin gösterdiği ihlali yorumlamak gerekir.

Sonuçları JSON Schema özelliklerinin tamamını desteklediği varsayımıyla kullanmayın. İncelenen davranış; tür, bazı nesne ve dizi kuralları, enum, sayısal sınırlar ve dize uzunlukları gibi kontrolleri kapsar. Referanslar, birleştirme kuralları, biçim ve desen kuralları için burada doğrulanmış bir destek bulunmamaktadır.

Uygulamalı örnek

Bir veri kaydındaki yaş değerinin şemada tanımlanan en düşük tam sayı sınırına uyup uymadığını kontrol ediyorsunuz.

{"age":-1} verisini, age alanını tam sayı ve en düşük değeri 0 olarak tanımlayan JSON Schema metniyle birlikte doğrulayın.

Sonuçta geçersiz doğrulama durumu ve age değerinin izin verilen en düşük değeri karşılamadığına ilişkin bir ayrıntı görülür.

Sınırlamalar

Sonuç, çalışma davranışında incelenen JSON Schema kontrolleriyle sınırlıdır. Referans, birleştirme, biçim ve desen kurallarının desteklendiği doğrulanmamıştır; bu nedenle tam standart uyumluluğu sonucu olarak yorumlanmamalıdır.

Sık yapılan hatalar

JSON verisi veya şeması geçersiz sözdizimi içeriyorsa ayrıştırma hatası oluşur. Her iki metni de ayrı ayrı geçerli JSON olarak düzenleyip doğrulamayı yeniden başlatın.

Sık sorulan sorular

Veri veya şema alanı boş bırakılırsa ne olur?

Alanlardan biri boş veya yalnızca boşluk içeriyorsa araç veriyi geçerli saymaz ve eksik JSON ya da şema bilgisini belirtir. Her iki alana da metin girerek yeniden deneyin.

JSON ayrıştırma hatası alırsam neyi kontrol etmeliyim?

Metinlerden biri JSON olarak ayrıştırılamazsa geçersiz sonuç ve ayrıştırma hatası açıklaması alırsınız. Sözdizimini düzelttikten sonra tekrar doğrulayın.

Hangi JSON Schema kuralları kontrol edilebilir?

Tür, zorunlu özellik, ek özellik, dizi öğesi, enum, sayısal sınır ve dize uzunluğu gibi incelenen kurallar kontrol edilebilir. Referans, birleştirme, biçim ve desen kuralları için doğrulanmış destek bulunmadığından sonucu bu kapsamla sınırlı yorumlayın.