Валідатор JSON Schema

Як працює валідатор JSON Schema

Що робить інструмент

Цей валідатор JSON Schema перевіряє JSON-дані на відповідність JSON Schema (draft-04, draft-06, draft-07 або 2019-09). Він повідомляє, чи є дані валідними, а якщо ні — показує шлях, ключове слово та повідомлення для кожної помилки, щоб ви могли виправити дані або скоригувати схему.

Поширені сценарії використання для розробників

Розробники використовують валідатор JSON Schema, щоб тестувати payload-и запитів/відповідей API, валідувати конфіг-файли, генерувати або налагоджувати валідацію на основі схем у коді та переконуватися, що OpenAPI або інші формати, керовані схемами, є коректними. Також це корисно під час створення форм або ETL-пайплайнів, які покладаються на JSON Schema.

Ввід схеми та даних

Вставте або завантажте вашу JSON Schema в одну панель, а ваші JSON-дані — в іншу. Інструмент парсить обидва та запускає валідацію. Підтримувані версії схем визначаються за ключовим словом "$schema". Невалідний JSON у будь-якій панелі буде повідомлено до запуску валідації.

Поширені помилки та крайові випадки

Переконайтеся, що сама схема є валідним JSON і використовує підтримуваний URL "$schema". Порожні дані або дані, що не є об’єктом, можуть бути валідними або невалідними залежно від схеми (наприклад, required-поля, обмеження типів). Вкладені помилки показуються з нотацією шляху; виправте одну помилку та запустіть повторно, щоб побачити решту проблем.

Коли використовувати цей інструмент, а коли — код

Використовуйте цей валідатор для швидких перевірок, налагодження та дослідження схем. Для продакшну запускайте валідацію у вашому застосунку за допомогою бібліотеки на кшталт Ajv або подібної, і тримайте схеми та логіку валідації у системі контролю версій і тестах.