Генераторы
JSON to types generator
Сгенерируйте TypeScript interface, Zod-схему или JSON Schema из примера JSON.
Результат
Тип выводится по одному примеру данных. Для API-контрактов проверьте необязательные поля и варианты значений вручную.
JSON to types generator превращает пример JSON в TypeScript interface, Zod-схему или JSON Schema. Инструмент полезен разработчикам, аналитикам API и no-code пользователям, которым нужно быстро описать структуру payload.
Как выводятся типы
Генератор разбирает JSON, определяет типы значений, объединяет элементы массивов и строит текстовый контракт. Всё происходит в браузере; пример JSON не отправляется на сервер.
Как сгенерировать типы из JSON
- Вставьте JSON. Используйте очищенный пример ответа API, конфигурации или тестовых данных.
- Назовите root-тип. Укажите понятное имя, например UserProfile, ProductCard или ApiResponse.
- Выберите формат. TypeScript удобен для типов, Zod — для runtime-валидации, JSON Schema — для документации и API-контрактов.
- Проверьте опциональность. Один JSON-пример не знает всех вариантов API, поэтому необязательные поля нужно сверить вручную.
Принцип вывода
JSON value -> inferred node -> TypeScript | Zod | JSON Schema
Массивы анализируются по первым элементам, а вложенные объекты превращаются во вложенные типы. Если в массиве разные типы, выводится union.
Пример
Поле "id": 1 станет number, "tags": ["seo"] станет string[], а объект "author": { "name": "Ann" } станет вложенным object type.
Источники
- RFC 8259: The JavaScript Object Notation Data Interchange FormatПроверено: 2026-05-24
- TypeScript Handbook: Object TypesПроверено: 2026-05-24
- JSON Schema: Getting started step by stepПроверено: 2026-05-24
Подробнее о проверке формул и источников — в методологии Calcup.
FAQ
Часто задаваемые вопросы
Почему поле получилось обязательным?
Если поле есть в примере JSON, генератор считает его обязательным. Для реального API проверьте документацию и включите опциональные поля при необходимости.
Что выбрать: TypeScript или Zod?
TypeScript описывает типы на этапе разработки. Zod добавляет runtime-проверку данных, которые приходят извне.
JSON Schema заменяет OpenAPI?
Нет. JSON Schema описывает структуру данных, а OpenAPI описывает ещё эндпоинты, методы, ответы и параметры.
Как обрабатываются массивы?
Генератор смотрит на элементы массива и объединяет их типы. Если массив пустой, тип элемента будет unknown.
Безопасно ли вставлять JSON?
Генерация выполняется локально, но лучше очищать примеры от секретов и персональных данных перед любой публикацией.