Перейти к содержимому
ToolsMinify logo
Инструменты для разработчиков

Генератор JSON Schema

Сгенерируйте черновик JSON Schema из JSON-образца в браузере - без аккаунта, загрузки и CLI.

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

Сгенерируйте черновик JSON Schema из JSON-образца в браузере - без аккаунта, загрузки и CLI. Вставьте ответ API или, лучше, массив записей. Вложенные объекты становятся вложенными схемами, массивы типизируются по всем элементам (не только первому), одинаковые пропущенные ключи - optional (не в required). JSON null дает nullable type, а не схлопывается в optional. Форматы строк выводятся для email, uri, uuid, date, date-time. Выберите Draft-07 или 2020-12, скопируйте или скачайте схему. Сочетайте с JSON to TypeScript Converter для интерфейсов из того же образца или JSON Minifier, если пришел минифицированный payload.

Как использовать Генератор JSON Schema

  1. Вставьте JSON (массив записей точнее выводит optional ключи, чем один объект). Загрузите sample для optional vs nullable.
  2. Задайте title схемы, Draft-07 (по умолчанию) или 2020-12. Выберите, отклонять ли additional properties.
  3. Читайте отчет вывода: число свойств, required, optional, подсказки форматов. Предупреждения про пустые массивы, объекты, all-null и смешанные union.
  4. Скопируйте JSON Schema или скачайте .schema.json для AJV, Zod (через конвертеры), OpenAPI или CI.
  5. На сервер ничего не уходит. Невалидный JSON дает строку и столбец.

Примеры: Генератор JSON Schema

Optional ключ из массива записей

[{"sku":"A1","qty":2},{"sku":"B7","qty":1,"gift":true}] дает схему массива с items, где required sku и qty, а gift optional (не в required).

Nullable и optional

Два пользователя: email отсутствует в одной строке, note null в другой - email optional string, note type ["string","null"]. Пропуск ключа и JSON null различаются.

Подсказки format для строк

Значения как email, https URL, UUID, ISO date или date-time получают format: email, uri, uuid, date или date-time для валидаторов.

Пустые контейнеры

{"items":[],"meta":{}} типизирует items как массив с пустой items schema и meta как объект без properties. Предупреждения предлагают более богатый образец.

Draft-07 и 2020-12

Оба draft дают ту же выведенную форму. Draft-07 - классический $schema URI для большинства инструментов. 2020-12 - когда стек явно ожидает этот диалект.

Типичные сценарии

  • Черновик JSON Schema до появления OpenAPI / AsyncAPI
  • Валидация webhook (Stripe, GitHub, Slack) в CI с AJV
  • Фикстура в контракт для contract tests
  • Стартовая схема для конфигов и feature-flag payloads
  • Пара с TypeScript-интерфейсами из того же JSON

Частые вопросы о Генератор JSON Schema

Как сгенерировать JSON Schema из образца JSON?
Вставьте образец, задайте title, выберите draft и скопируйте схему. Генерация в браузере. Вложенные объекты и массивы обходятся полностью, ключи, отсутствующие в элементах массива, не попадают в required.
Чем optional отличается от nullable?
Optional - ключ отсутствовал в части элементов массива, его нет в required. Nullable - ключ был и значение JSON null, тип включает null (например type: ["string","null"]). Генератор не схлопывает их, если образец не показывал оба случая.
Какой draft JSON Schema выбрать?
Draft-07 по-прежнему самый распространенный. 2020-12 - когда инструменты явно ждут этот $schema URI. Выведенные свойства одинаковы.
Почему items или properties пустые?
У пустых массивов нет элементов - items {}. У пустых объектов нет ключей - properties пуст. Вставьте насыщенный пример для конкретных типов.
Всегда ли верны string format?
Formats - эвристика по образцу (email, uri, uuid, date, date-time). Проверьте перед production-контрактом - строка может случайно походить на email.
Загружается ли мой JSON?
Нет. Генерация только во вкладке. Образец не покидает браузер.
Чем это отличается от JSON to TypeScript converter?
Оба идут по похожему образцу. Здесь JSON Schema для валидаторов и OpenAPI. TypeScript converter - интерфейсы для кода. Используйте оба из одного payload.
additionalProperties: false отклоняет неизвестные ключи?
Да при включенном Reject extras. Полезно для строгих API. Allow extras - если клиенты могут присылать поля, которых не было в образце.