Проверка JSON Schema онлайн

Проверяет, что ответ API или фикстура совпадают со схемой: типы полей, required, enum, длины строк. Ошибка приходит путём $.items[0].id, а не «validation failed».

Список ошибок копируйте в тикет или в тест. Саму схему правьте в репозитории или в OpenAPI. Генератор схемы с соседней страницы — черновик, не контракт.

Данные

Вставьте сюда данные, которые нужно преобразовать, проверить или разобрать.

Объект JSON Schema: type, properties, required. $ref не раскрывается.

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

Вставьте экземпляр и схему. Схему можно получить соседним сервисом «JSON → JSON Schema» и поправить вручную.

Как интерпретировать результат

OK — документ валиден. Иначе список путей вроде $.user.email, где правило не сошлось. Это подмножество Draft, не полный AJV.

Схема — контракт, не пример

Ответ API «похож» на документацию, пока не приедет null вместо строки. JSON Schema фиксирует тип, обязательные поля, enum и длины. Валидатор гоняет конкретный документ по правилам и возвращает путь ошибки, а не общее «invalid».

Черновик схемы можно снять соседним генератором из примера и вычистить: убрать лишний required, ослабить additionalProperties. Потом проверяйте фикстуры и логи этим сервисом.

Что умеет этот диалект

type (в том числе массив типов), properties, required, items, enum, const, min/maxLength, pattern, minimum/maximum, min/maxItems, additionalProperties как false или вложенная схема. $ref, allOf/anyOf, if/then не раскрываются — встройте фрагмент или проверяйте куски.

Это не AJV и не полный Draft 2020-12. Для CI в репозитории лучше библиотека языка. Здесь — быстро понять, почему стенд отверг тело запроса.

Куда девать отчёт

Список $.user.email копируйте в тикет, в ожидаемый текст теста, в комментарий к OpenAPI. Сам документ после правки снова прогоните. Секреты из боевого ответа в форму лучше не класть.

Частые вопросы

Это генератор схемы?

Нет. Генератор — страница «JSON → JSON Schema». Здесь проверка готовой схемы.

Какой draft?

Подмножество: type, properties, required, items, enum, const, длины, min/max, pattern, additionalProperties.

$ref и allOf?

Не раскрываются. Встройте фрагмент в properties или проверьте куски по отдельности.

additionalProperties: false?

Любое поле вне properties станет ошибкой.

Зачем, если есть TypeScript?

Схема живёт в API-контракте и в OpenAPI. TS на фронте её не заменяет.

Почему valid, а сервер 400?

На бэкенде другая схема, или включены allOf/$ref, которых здесь нет.

Можно ли OpenAPI?

Вставьте кусок schema из components.schemas, не весь spec.