Contrat d'API généré à partir de la base
Généré le contrat d'API à partir de la base de données — OpenAPI,
client TypeScript typé de 44 076 lignes, 61 gestionnaires de
simulation et limites appliquées par l'interface — avec un contrôle
à chaque étape qui échoue en cas de divergence.
2025

Situation. L'interface et le serveur avancent à leur propre rythme,
et leurs hypothèses sur le contenu d'une requête peuvent diverger
sans que personne le remarque. La découverte se fait généralement
par une erreur 422 dans le navigateur — après la livraison de
l'incompatibilité, au moment le plus coûteux pour l'apprendre.
Écrire les deux côtés à la main à partir du même document ne résout
pas le problème ; cela déplace simplement la divergence vers la
personne qui a oublié de relire ce document.

Tâche. Les deux côtés devaient être générés à partir d'une source
unique plutôt que faire l'objet d'un accord entre deux sources,
chaque étape de génération étant vérifiée au lieu d'être tenue pour
fiable.

Action. La chaîne part de la base de données et progresse vers
l'extérieur. Le schéma et ses fonctions définissent les structures ;
les types Go définissent l'API ; Huma en produit la description
OpenAPI ; un client TypeScript typé — 44 076 lignes — est généré à
partir de cette description ; 61 gestionnaires simulés sont générés
à ses côtés pour que les tests de l'interface s'exécutent contre le
véritable contrat plutôt qu'un jeu de données de test écrit à la
main ; et les limites imposées par l'UI dans un formulaire viennent
du même endroit au lieu d'être ressaisies dans un validateur. Chaque
relais possède un garde‑fou. Un contrôle de contrat en CI compare ce
qu'envoie l'interface à ce qu'attend l'API et fait échouer la
compilation en cas de divergence, avec en dessous une sonde du
schéma qui vérifie les structures réelles plutôt que leur
description. Le contrôle couvre délibérément les endroits où les
divergences se cachent volontiers : les champs facultatifs du corps,
où « absent » et « null » se confondent, et les énumérations des
paramètres de requête, où les deux côtés peuvent diverger
discrètement sur les valeurs autorisées.

Résultat. Un champ ne peut pas changer d'un seul côté — la
compilation échoue au premier relais qui détecte l'écart, quelques
minutes après la modification. Cela a supprimé une catégorie de
défauts récurrents et réellement agaçants, invisibles en revue de
code et ne se manifestant qu'à l'exécution. Le coût est une étape de
génération au milieu de tout : régénérer est une corvée, et la
fiabilité de la chaîne dépend de son maillon le moins surveillé,
raison pour laquelle chaque relais a reçu un garde‑fou.

Catégories:
1Ingénierie backend	/fr/categories/backend/	engineer.company	70
1API et intégration	/fr/categories/api/	engineer.company	70
1DevOps	/fr/categories/devops/	engineer.company	70
1Automatisation et CI/CD	/fr/categories/automation/	engineer.company	70
1Fiabilité et sauvegardes	/fr/categories/reliability/	engineer.company	70
1Tests et assurance qualité	/fr/categories/testing/	engineer.company	70

Prestations:
1Développement backend et API	/fr/services/backend-development/	engineer.company	70
1Outils pour agents d'IA et serveurs MCP	/fr/services/ai-tools/	engineer.company	70
1DevOps et automatisation CI/CD	/fr/services/devops-cicd/	engineer.company	70

hCette page sur le Web	URL:https://engineer.company/fr/portfolio/generated-the-api-contract-from-the-database-out/	engineer.company	70
