ДокументыИзображенияМедиаИнструменты PDF

Генератор JSON Schema Онлайн

Генерируйте JSON Schema из JSON-объекта прямо в браузере.

Processed in your browser

JSON Schema из примера данных мгновенно

Draft-07 и 2020-12

Поддержка актуальных версий JSON Schema.

Без интернета

Генерация в браузере без отправки данных на сервер.

Вложенные объекты

Рекурсивная генерация для любой глубины вложенности.

Мгновенно

Схема генерируется в реальном времени при вводе JSON.

Три шага — никаких сложностей

1

Вставьте JSON

Вставьте JSON-объект или массив в поле ввода.

2

Получите схему

Инструмент автоматически генерирует JSON Schema (Draft-07 или Draft 2020-12).

3

Скопируйте схему

Скопируйте готовую JSON Schema для валидации данных в вашем проекте.

Остались вопросы?

JSON Schema — словарный стандарт для описания и валидации JSON-документов. Схема определяет: типы данных полей, обязательные поля, форматы строк (email, date-time, uuid), диапазоны чисел, паттерны регулярных выражений, дополнительные ограничения. Инструменты (ajv, jsonschema) валидируют JSON-данные против схемы.

JSON Schema имеет несколько версий-черновиков: Draft-04, Draft-06, Draft-07, Draft 2019-09, Draft 2020-12. Инструмент генерирует Draft-07 по умолчанию — наиболее широко поддерживаемую версию. Выбор версии зависит от валидационной библиотеки в вашем проекте.

Почти всегда. Инструмент определяет типы из примера данных, но не знает: какие поля опциональны (required vs не required), допустимые диапазоны числовых значений, форматы строк (email, url, date), перечисляемые значения (enum). Сгенерированная схема — отправная точка, требующая ручной доработки.

Основные применения: валидация API-запросов и ответов (OpenAPI/Swagger использует JSON Schema), описание конфигурационных файлов (package.json, tsconfig.json), документирование форматов данных, генерация форм (react-jsonschema-form), TypeScript-типов (quicktype), mock-данных (json-schema-faker).

Node.js: библиотека ajv (Another JSON Validator) — самый быстрый валидатор. Python: jsonschema библиотека. Java: networknt/json-schema-validator. PHP: justinrainbow/json-schema. Все реализации проверяют JSON-данные против схемы и возвращают список ошибок при несоответствии.

JSON Schema: стандарт валидации данных и экосистема инструментов

JSON Schema — независимый стандарт, разрабатываемый сообществом json-schema.org. В отличие от XML Schema (XSD), JSON Schema не имеет официального стандарта ISO — процесс стандартизации продолжается. Draft 2020-12 (декабрь 2020) — последняя стабильная спецификация. OpenAPI 3.x использует JSON Schema как основу для описания моделей данных API.

Экосистема JSON Schema широка: ajv — de facto стандарт для Node.js (поддерживает Draft-04 до 2020-12, используется в Webpack и многих других пакетах). Hyperjump JSV — полная реализация 2020-12. В Python jsonschema поддерживает все версии. Для IDE-интеграции VS Code использует JSON Schema для валидации и автодополнения в tsconfig.json, package.json и других конфигурационных файлах.

Автоматическая генерация схем из примеров — удобный способ начать, но не замена тщательно написанной схемы. Хорошая схема явно указывает required-поля, добавляет минимальные/максимальные ограничения для чисел, format для строк (email, date-time), pattern для пользовательских форматов и additionalProperties: false для строгой валидации.