Пример JSON показывает наблюдаемые, а не все возможные значения API. TypeDraft выводит unknown[] для пустого массива и сохраняет null, не угадывая доменный тип.
Отсутствие не видно
Свойство, отсутствующее в единственном объекте, не появится в черновике. Используйте несколько объектов или настоящую схему.
Статический тип не проверяет данные
Объявления TypeScript исчезают во время выполнения. Проверяйте недоверенные ответы на границе приложения и обновляйте черновик по авторитетному контракту, а не считайте один пример доказательством.
Сверьте с настоящим контрактом
Скомпилируйте файл и сверьте каждое свойство с документацией API, OpenAPI или JSON Schema. Добавьте отсутствующие поля, исправьте null и optional и применяйте runtime-проверку на недоверенных границах. Храните показательный пример рядом с проверенным типом, чтобы замечать изменения.