# 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.

---

- Rôle: Ingénieure backend
- Catégories: [Ingénierie backend](https://software.engineer.company/fr/categories/backend/), [API et intégration](https://software.engineer.company/fr/categories/api/), [DevOps](https://software.engineer.company/fr/categories/devops/), [Automatisation et CI/CD](https://software.engineer.company/fr/categories/automation/), [Fiabilité et sauvegardes](https://software.engineer.company/fr/categories/reliability/), [Tests et assurance qualité](https://software.engineer.company/fr/categories/testing/)
- Prestations: [Développement backend et API](https://software.engineer.company/fr/services/backend-development/), [Outils pour agents d'IA et serveurs MCP](https://software.engineer.company/fr/services/ai-tools/), [DevOps et automatisation CI/CD](https://software.engineer.company/fr/services/devops-cicd/)

<https://engineer.company/fr/portfolio/generated-the-api-contract-from-the-database-out/>
