Генераторы

JSON to types generator

Сгенерируйте TypeScript interface, Zod-схему или JSON Schema из примера JSON.

JSON-пример

Результат

Тип
ToolPage
Формат
typescript
Свойств
4
Глубина
3
Длина
96

Тип выводится по одному примеру данных. Для API-контрактов проверьте необязательные поля и варианты значений вручную.

JSON to types generator превращает пример JSON в TypeScript interface, Zod-схему или JSON Schema. Инструмент полезен разработчикам, аналитикам API и no-code пользователям, которым нужно быстро описать структуру payload.

Как выводятся типы

Генератор разбирает JSON, определяет типы значений, объединяет элементы массивов и строит текстовый контракт. Всё происходит в браузере; пример JSON не отправляется на сервер.

Как сгенерировать типы из JSON

  1. Вставьте JSON. Используйте очищенный пример ответа API, конфигурации или тестовых данных.
  2. Назовите root-тип. Укажите понятное имя, например UserProfile, ProductCard или ApiResponse.
  3. Выберите формат. TypeScript удобен для типов, Zod — для runtime-валидации, JSON Schema — для документации и API-контрактов.
  4. Проверьте опциональность. Один JSON-пример не знает всех вариантов API, поэтому необязательные поля нужно сверить вручную.

Принцип вывода

JSON value -> inferred node -> TypeScript | Zod | JSON Schema

Массивы анализируются по первым элементам, а вложенные объекты превращаются во вложенные типы. Если в массиве разные типы, выводится union.

Пример

Поле "id": 1 станет number, "tags": ["seo"] станет string[], а объект "author": { "name": "Ann" } станет вложенным object type.

Источники

Подробнее о проверке формул и источников — в методологии Calcup.

Не вставляйте реальные токены, персональные данные и коммерческие payload без очистки. Тип выводится по примеру, а не по полной спецификации API.

FAQ

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

Почему поле получилось обязательным?

Если поле есть в примере JSON, генератор считает его обязательным. Для реального API проверьте документацию и включите опциональные поля при необходимости.

Что выбрать: TypeScript или Zod?

TypeScript описывает типы на этапе разработки. Zod добавляет runtime-проверку данных, которые приходят извне.

JSON Schema заменяет OpenAPI?

Нет. JSON Schema описывает структуру данных, а OpenAPI описывает ещё эндпоинты, методы, ответы и параметры.

Как обрабатываются массивы?

Генератор смотрит на элементы массива и объединяет их типы. Если массив пустой, тип элемента будет unknown.

Безопасно ли вставлять JSON?

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