Генератор 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
- Вставьте JSON (массив записей точнее выводит optional ключи, чем один объект). Загрузите sample для optional vs nullable.
- Задайте title схемы, Draft-07 (по умолчанию) или 2020-12. Выберите, отклонять ли additional properties.
- Читайте отчет вывода: число свойств, required, optional, подсказки форматов. Предупреждения про пустые массивы, объекты, all-null и смешанные union.
- Скопируйте JSON Schema или скачайте .schema.json для AJV, Zod (через конвертеры), OpenAPI или CI.
- На сервер ничего не уходит. Невалидный 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 - если клиенты могут присылать поля, которых не было в образце.
Похожие инструменты
Конвертер JSON в интерфейсы TypeScript
Бесплатный конвертер JSON в интерфейсы TypeScript. Вставьте JSON-образец, получите вложенные interfaces или type aliases, optional-ключи отдельно от JSON null. Ничего не загружается.
Минификатор и форматировщик JSON
Бесплатный онлайн-минификатор и форматировщик JSON. Сжимайте JSON для меньших payload или форматируйте (pretty-print) с отступом 2 пробела. Валидация по ходу - загрузка не нужна.
Тестер JSONPath
Тестируйте JSONPath онлайн в браузере. Извлеките поле из JSON, попробуйте пример фильтра и копируйте нормализованные пути - ничего не загружается.
Сравнение JSON (diff)
Бесплатный структурный diff JSON в браузере. Сравните два JSON по ключам и значениям, а не по порядку строк. Ничего не загружается.