Генератор JSON Schema

Создайте JSON Schema из ваших данных или проверьте JSON по существующей схеме

Генератор JSON Schema

Версия черновика

Отметить все поля как обязательные

Разрешить дополнительные свойства

Ввод JSON

Данные JSON

JSON Schema

100% на стороне клиента. Ваши данные JSON никогда не покидают ваш браузер.

Примеры использования

Используйте Draft-07 для новейших возможностей, включая условные схемы и кодирование контента.

Включите «Отметить все поля как обязательные» для строгой валидации обязательных полей.

Скачайте сгенерированную схему и добавьте её в проект для автоматической валидации в CI.

Вставьте пример ответа API, чтобы быстро создать схему для вашей документации.

JSON Schema Types

Supported JSON Schema data types:

string - Text values
number - Decimal numbers
integer - Whole numbers
boolean - true/false
array - Ordered lists
object - Key-value pairs
null - Null value

Возможности

Автоматическая генерация схемы

Вставьте любой JSON и получите полную схему с автоматически определёнными типами, форматами и структурой

Валидация по схеме

Проверяйте данные JSON по любой схеме и просматривайте подробные сообщения об ошибках несоответствий

Несколько версий черновиков

Поддержка Draft-04, Draft-06 и Draft-07 в соответствии с требованиями вашего проекта

Приватно и офлайн

Работает полностью в вашем браузере, никакие данные JSON не отправляются на сервер

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

Вставьте ваш JSON

Вставьте данные JSON в поле ввода или попробуйте один из предоставленных примеров.

Настройте параметры

Выберите версию черновика и переключите параметры, такие как обязательные поля и дополнительные свойства.

Сгенерируйте или проверьте

Нажмите «Сгенерировать схему» для создания схемы или перейдите на вкладку «Проверить» для валидации JSON по схеме.

Часто задаваемые вопросы

JSON Schema — это словарь для аннотирования и валидации JSON-документов. Она описывает ожидаемую структуру, типы данных, обязательные поля и ограничения вашего JSON. Документ схемы сам является JSON и может быть использован для автоматической валидации API payloads, входных данных форм, конфигурационных файлов или записей базы данных. Это основа спецификаций OpenAPI/Swagger и широко используется в CI-пайплайнах для тестирования контрактов данных.

Вставьте любой валидный JSON и нажмите Generate Schema. Инструмент рекурсивно проходит по каждому свойству, определяет типы (string, number, integer, boolean, null, object, array), обнаруживает распространенные форматы строк (date-time, email, URI, UUID) и создает полное дерево схемы. Дополнительные параметры позволяют пометить все поля как обязательные, запретить дополнительные свойства или добавить плейсхолдеры описания для документации.

Draft-07 — правильный выбор для большинства проектов: это наиболее поддерживаемая версия, которая добавляет такие функции, как условия if/then/else и ключевые слова кодирования контента. Draft-06 ввел «const» и «contains». Draft-04 — самая старая версия, которую следует использовать только если конкретный инструмент (старые валидаторы, некоторые инструменты Swagger 2.0) явно требует этого. В случае сомнений используйте Draft-07.

Да. Перейдите во вкладку Validate, вставьте свои данные JSON в левой панели и свою схему в правой панели, затем нажмите Validate. Инструмент выполнит полную проверку и сообщит о каждой ошибке с путем к полю и описанием нарушения. Это позволяет проверить JSON из API, отправки формы или файла конфигурации на соответствие любой схеме — не только той, что была сгенерирована этим инструментом.

Ключевое слово required перечисляет поля, которые должны присутствовать в JSON. Когда вы включаете «Mark all fields as required», каждый ключ, найденный в вашем образце JSON, добавляется в массив required. На практике вы обычно будете редактировать этот список после генерации — удаляя ключи, которые действительно являются необязательными. Тот факт, что поле является обязательным, означает, что валидация не пройдет, если этот ключ отсутствует; это ничего не говорит о том, что значение поля не должно быть null.

Когда в схеме additionalProperties установлено в false, валидация отклоняет любой JSON, содержащий ключи, не определенные в объекте properties. Это полезно для строгих контрактов API, где вы хотите поймать опечатки в названиях полей или предотвратить отправку клиентами незаявленных полей. Оставление значения true (или его отсутствие) позволяет включать любые дополнительные поля без ошибок валидации — это лучше подходит для схем с обратной совместимостью.

Скачайте или скопируйте схему, а затем используйте библиотеку валидации: Ajv (JavaScript/Node.js), jsonschema или jsonschema-rs (Python/Rust), Newtonsoft.Json.Schema (C#) или NetworkNT JSON Schema Validator (Java). В Ajv: const validate = ajv.compile(schema); const valid = validate(data). Файл схемы также можно ссылаться в спецификациях OpenAPI в разделе components/schemas для автоматической генерации документации.

Да. Этот инструмент работает на 100% в вашем браузере. Ваши данные JSON никогда не отправляются на сервер, не сохраняются и не логируются. Вы можете безопасно использовать его с ответами API, содержащими учетные данные, внутренними файлами конфигурации или любыми конфиденциальными данными.

Что такое генератор JSON Schema?

Генератор JSON Schema автоматически создаёт определение JSON Schema из примера данных JSON. Вместо того чтобы писать определения схемы вручную, вы вставляете свой JSON, и инструмент определяет типы, структуры, вложенные объекты и массивы для создания валидного документа схемы. Это экономит часы ручной работы и снижает вероятность ошибок в определениях схемы.

Как это работает

Генератор анализирует ваш ввод JSON и рекурсивно обходит каждое свойство. Он определяет типы данных (string, number, integer, boolean, null, object, array), распознаёт строковые форматы, такие как даты и email, и строит полное дерево схемы. Вы можете настроить вывод с помощью параметров для обязательных полей, дополнительных свойств и заполнителей описаний. Всё выполняется на стороне клиента в вашем браузере.

Типичные сценарии использования

Разработчики используют генераторы JSON Schema для документирования REST API, валидации конфигурационных файлов, применения контрактов данных между микросервисами и создания валидаторов форм. Схемы, сгенерированные из реальных ответов API, служат живой документацией, которую можно автоматически тестировать в CI-пайплайнах. Они также необходимы для спецификаций OpenAPI и Swagger.

Конфиденциальность и безопасность

Этот генератор JSON Schema работает на 100% на стороне клиента. Весь анализ, генерация схемы и валидация выполняются в вашем браузере с помощью JavaScript. Никакие данные JSON не отправляются на сервер. Никакие cookie не отслеживают ваш ввод, и ничего не сохраняется после окончания текущей сессии. Безопасен для проприетарных API, внутренних конфигураций и конфиденциальных данных.

Безопасность и конфиденциальность

Безопасность ваших данных — наш приоритет

Локальная обработка

Вся обработка происходит в вашем браузере

Без передачи данных

Ваши данные не отправляются на наши серверы

Без хранения данных

Данные не хранятся и не передаются

SSL-шифрование

SSL-шифрование для безопасного соединения

Был ли этот инструмент полезен?

Генератор JSON Schema