Валидатор JSON Schema

Что это такое

JSON Schema — словарь для описания структуры JSON-данных: какие свойства обязательны у объекта, какого типа каждое значение, допустимые диапазоны и шаблоны, длина массивов и многое другое. Его используют в спецификациях OpenAPI, редакторы — для автодополнения в конфигурационных файлах, а серверы — чтобы отклонять некорректные запросы.

Этот валидатор проверяет JSON-документ по схеме и перечисляет все найденные проблемы. Для каждой ошибки показано место в данных (JSON Pointer вроде /tags/1), понятное сообщение и ключевое слово схемы, которое не прошло, — так данные или схему можно быстро исправить. Поддерживаются draft 2020-12, 2019-09, draft-07 и draft-04, включая $ref, $defs, allOf/anyOf/oneOf, if/then/else, unevaluatedProperties и проверку форматов.

Как пользоваться

1. Вставьте данные в поле Данные JSON, а схему — в JSON Schema, или загрузите файл в каждое поле. Пример загружает запись пользователя с несколькими намеренными ошибками.
2. Результат обновляется по мере ввода: зелёная метка, если данные корректны, иначе — число ошибок и их список.
3. Оставьте Версию в режиме «Авто», чтобы следовать $schema, или задайте её явно. Выключите Показывать все ошибки, чтобы остановиться на первой.
4. Копировать ошибки копирует список как обычный текст — для баг-репорта или код-ревью.

Если одна из сторон не является корректным JSON, сообщение укажет, где проблема — в данных или в схеме, — и назовёт строку и столбец.

Пример

Со схемой:

{
  "type": "object",
  "required": ["id"],
  "properties": {
    "id": { "type": "integer" },
    "age": { "type": "integer", "minimum": 0 }
  }
}

документ {"age": -1} даёт две ошибки: в (корне) отсутствует обязательное свойство id; в /age значение меньше минимума 0.

Советы

Добавьте "additionalProperties": false, чтобы ловить опечатки в именах свойств — иначе они проходят незаметно. Используйте enum или const для фиксированных значений и pattern для строк вроде артикулов. Когда схема разрастётся, вынесите повторяющиеся части в $defs и ссылайтесь на них через $ref.