Un exemple JSON montre les valeurs observées, pas toutes les possibilités. TypeDraft émet unknown[] pour un tableau vide et conserve null sans inventer un type.

L’absence reste invisible

Une propriété absente de l’unique objet n’apparaît pas. Utilisez plusieurs objets ou le vrai schéma.

Les types statiques ne valident pas les données

Les déclarations TypeScript disparaissent à l’exécution. Validez les réponses non fiables à la frontière de l’application et mettez le brouillon à jour depuis le contrat de référence, pas depuis un seul exemple.

Vérifiez le vrai contrat

Compilez le fichier puis comparez chaque propriété à la documentation API, OpenAPI ou JSON Schema. Ajoutez les champs absents, corrigez null et l’optionalité et validez à l’exécution aux frontières non fiables. Conservez un exemple représentatif près du type relu.