JSON Schema ویلیڈیٹر

یہ ٹول Ajv لائبریری کے ذریعے JSON Schema Draft-07، Draft 2019-09 اور Draft 2020-12 سپورٹ کرتا ہے۔ عام schema خصوصیات میں سے اکثر سپورٹڈ ہیں۔

جی ہاں! JSON Schema گہرائی تک نیسٹڈ آبجیکٹس اور اریز سپورٹ کرتا ہے۔ آپ نیسٹنگ کی کسی بھی سطح پر properties اور items بیان کر سکتے ہیں، ہر فیلڈ کے لیے الگ تصدیقی قواعد کے ساتھ۔

ٹول پہلے یہ جانچتا ہے کہ آپ کا schema خود درست JSON Schema ہے یا نہیں۔ schema میں خرابیاں ہوں تو ڈیٹا کی تصدیق کی کوشش سے پہلے ہی ان کی رپورٹ دی جاتی ہے۔

type (string, number, object, array, boolean, null)، نیسٹڈ schema کے ساتھ properties، لازمی کیز کی فہرست دینے والا required، مققدر قدروں کے سیٹ کے لیے enum، regex-مقید اسٹرنگز کے لیے pattern، اور حد کی جانچیں minimum/maximum اور minLength/maxLength۔ additionalProperties: false آبجیکٹ کو اضافی کیز کے خلاف سخت کرتا ہے۔ یہ سب مل کر API تصدیقی قواعد کا بڑا حصہ ڈھانپتے ہیں۔

جدید JSON Schema میں format بطور ڈیفالٹ ایک اینوٹیشن ہے، خودکار ایشورشن نہیں - ویلیڈیٹر اسے صرف کنفیگر ہونے پر لاگو کرتے ہیں، جسے 2020-12 اسپیک نے الگ format-assertion الفاظ کے سیٹ سے واضح کیا۔ جب لاگو ہونا یقینی ہو تو pattern یا کسٹم کی ورڈ استعمال کریں، ورنہ format کو انٹروپریبلٹی میٹا ڈیٹا سمجھیں۔

#/$defs/address کی طرف اشارہ کرتا $ref، $defs کے نیچے schema کے ایک ٹکڑے کا حوالہ دیتا ہے اور جہاں استعمال ہوتا ہے وہاں اس کے مطابق تصدیق کرتا ہے - یہی ڈی ڈوپلیکیشن میکانزم ہے۔ Draft 2020-12 نے پرانی definitions کا نام $defs رکھا اور کمنٹ ٹریز جیسی recursive ڈھانچوں کے لیے $dynamicRef کو باقاعدہ بنایا۔ حوالے بیرونی دستاویزات کی طرف بھی اشارہ کر سکتے ہیں، اگرچہ مقامی طور پر بنڈل کرنا زیادہ عام ہے۔

allOf کے لیے ہر ذیلی schema درست ہونا ضروری ہے - یہ ایک تقاطع ہے، بنیادی schema میں اضافی پابندیاں شامل کرنے کے لیے۔ anyOf کو کم از کم ایک درکار ہے - یہ اجتماع ہے، پولی مورفک پے لوڈز کے لیے۔ oneOf کو بالکل ایک درکار ہے؛ دو یا صفر ذیلی schema کے درست ہونے پر ناکام ہو جاتا ہے، جو لوگوں کی توقع سے زیادہ سخت ہے اور اوورلیپنگ schema میں غیر متوقع خرابیوں کی عام وجہ ہے۔

2020-12 نے اسپیسفیکیشن کو الگ الگ فعال کیے جانے والے الفاظ کے سیٹ میں تقسیم کیا (validation, annotation, format-assertion)، definitions کا نام $defs رکھا، exclusiveMinimum کو ایک سادہ نمبر میں سادہ کیا، اور پرانی items کی ورڈ کی جگہ prefixItems اور items لائے۔ زیادہ تر ٹولنگ دونوں سپورٹ کرتی ہے؛ draft-07 اب بھی سب سے زیادہ استعمال میں ہے، لیکن 2020-12 موجودہ شائع شدہ معیار ہے۔