Валидатор 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". Пустые данные или данные, не являющиеся объектом, могут быть валидными или невалидными в зависимости от схемы (например, обязательные поля, ограничения типа). Вложенные ошибки показываются с нотацией пути; исправьте одну ошибку и запустите проверку снова, чтобы увидеть оставшиеся проблемы.

Когда использовать этот инструмент, а когда — код

Используйте этот валидатор для быстрых проверок, отладки и изучения схем. Для продакшена запускайте валидацию в вашем приложении с библиотекой вроде Ajv или аналогичной, а схему и логику валидации храните в системе контроля версий и тестах.