Проверка JSON Schema онлайн
Проверяет, что ответ API или фикстура совпадают со схемой: типы полей, required, enum, длины строк. Ошибка приходит путём $.items[0].id, а не «validation failed».
Список ошибок копируйте в тикет или в тест. Саму схему правьте в репозитории или в OpenAPI. Генератор схемы с соседней страницы — черновик, не контракт.
Данные
Результат
Скопировано
Как пользоваться
Вставьте экземпляр и схему. Схему можно получить соседним сервисом «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.