Конвертер JSON в TypeScript

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

• Примитивы: строки, числа и логические значения отображаются в string, number и boolean.
• Вложенные объекты становятся отдельными именованными интерфейсами в PascalCase, так что billing_address превращается в BillingAddress.
• Массивы объектов объединяются в один тип элемента с именем в единственном числе: users даёт User[]. Ключ, отсутствующий в части элементов, становится необязательным (key?:).
• Значения null объединяются с другими значениями этого ключа: string | null. Ключ, который всегда null, получает тип unknown или any.
• Смешанные массивы становятся массивами объединений, например (number | string)[].
• Одинаковые структуры объявляются один раз и переиспользуются, а разные структуры с одинаковым именем получают числовой суффикс.
• Ключи, не являющиеся корректными идентификаторами, например "first-name" или "2fa", берутся в кавычки.

interface или type

Для простых структур объектов они почти взаимозаменяемы. Объявления interface можно расширять и объединять, и они дают чуть более понятные ошибки компилятора. Псевдонимы type также умеют выражать объединения и mapped types. Многие команды используют интерфейсы для моделей API и типы для всего остального; выбирайте то, что ожидает ваша кодовая база или линтер (@typescript-eslint/consistent-type-definitions).

Как получить более точные типы

Типы могут быть полными ровно настолько, насколько полон пример. Вставьте ответ с необязательными полями или массив с несколькими разными элементами, чтобы генератор смог определить необязательные и nullable-ключи. Даты и перечисления приходят в JSON как обычные строки; сужайте их вручную, например status: 'active' | 'disabled'. Для валидации во время выполнения используйте сгенерированные типы вместе с библиотекой схем вроде Zod.