Aller au contenu

Migration vers Huma v2 avec parité de 100 %

Migré l'API HTTP de Fiber vers Huma v2 — 649 chemins et 760 opérations — puis atteint et maintenu une correspondance de 100 % entre les routes enregistrées par le serveur et la description OpenAPI publiée.

760 opérations d'API migrées avec une description toujours fidèle

Situation. L’API a commencé sur Fiber, avec une validation des requêtes écrite à la main, point de terminaison par point de terminaison. Cela convient lorsqu’il n’y en a qu’une poignée. Ce n’est plus le cas lorsque le périmètre grandit : cette validation artisanale devient une charge de maintenance, et de petites incohérences apparaissent, car les contrôles de chaque point de terminaison constituent leur propre cas particulier. Il n’existait par ailleurs aucune description unique de la structure de l’API.

Tâche. L’objectif était que la validation découle des types plutôt que de contrôles écrits à la main, avec un véritable contrat décrivant l’API — sans s’arrêter pour une réécriture globale d’un seul coup.

Action. La couche HTTP est passée à Huma v2 au‑dessus de Fiber, conservant ainsi le moteur d’exécution existant. Chaque point de terminaison reçoit des structures d’entrée et de sortie, à partir desquelles Huma génère la validation des requêtes et la modélisation des réponses. Une description OpenAPI en découle sans travail supplémentaire, ce qui permet à la documentation de suivre le code au lieu de dépérir dans un wiki. Tout nouvel élément a été écrit avec Huma et les routes existantes migrées, avec exactement deux points de terminaison restant directement sur Fiber — ceux des WebSocket, où l’accès au socket est réellement nécessaire et où le modèle requête/réponse de Huma ne convient pas. L’ensemble a atteint 649 chemins portant 760 opérations, avec un contrôle en CI comparant les routes réellement enregistrées par le serveur à celles annoncées dans la description OpenAPI. La correspondance est de 100 % et le reste, car une route non décrite fait échouer la compilation.

Résultat. Les nouveaux points de terminaison bénéficient d’une validation et d’une documentation à jour sans travail supplémentaire, et toute une catégorie de défauts de traitement des requêtes — du type « oh, ce champ n’a pas été vérifié ici » — a disparu. Avec 760 opérations, la description est le seul moyen pratique de consulter l’API, si bien que la garantie de son exhaustivité compte davantage qu’à cinquante. Le contrat typé a rendu l’API plus sûre à modifier et plus facile à transmettre, car les types indiquent ce qu’attend un point de terminaison.

  • Embranchement ferroviaire et voies
    Photo : music4life / Pixabay
  • Carte pliable, carte routière, itinéraire
    Photo : cocoparisienne / Pixabay

Mettez cette expérience au service de votre projet

Prenez « Migration vers Huma v2 avec parité de 100 % » comme point de départ pour un défi similaire dans votre organisation. Les prestations mobilisées pour cette réalisation sont disponibles pour votre projet. Des transmissions, procédures d'exploitation et manuels qui permettent à votre équipe de faire fonctionner le système sans rappeler ses concepteurs.

Découvrir nos prestations Contactez-nous

Examinez ce qui a conduit au résultat

Découvrez la situation, les décisions et le résultat de cet exemple. Nous pouvons discuter des éléments transposables à vos contraintes et de ceux qui nécessitent une autre démarche. Migration vers Huma v2 avec parité de 100 % — 760 opérations d'API migrées avec une description toujours fidèle

Découvrir nos prestations Contactez-nous

Un élément d'un parcours plus long — entièrement présenté sur ce site.

Chaque entrée suit la même structure : la situation, la tâche, ce que nous avons fait et ce qui a changé.

Voir l'ensemble du parcours

Définissez l'amélioration nécessaire

Présentez la décision, les personnes concernées et les options déjà envisagées. Nous pouvons expliciter les compromis et laisser une recommandation documentée.

Consulter les tarifs Contactez-nous

Envie d'API validées et bien documentées ?

Interrogez-nous sur les décisions qui sous-tendent « Migration vers Huma v2 avec parité de 100 % ». Vous parlerez aux personnes capables d'expliquer le travail et d'évaluer votre propre projet.

Découvrir nos prestations
welcome@engineer.company +45 50 10 61 84 Copenhague, Danemark
Code QR pour Migré l'API HTTP de Fiber vers Huma v2 — 649 chemins et 760 opérations — puis atteint et maintenu une correspondance de 100 % entre les routes enregistrées par le serveur et la description OpenAPI publiée.
Emportez cette page avec voushttps://advisory.engineer.company/fr/portfolio/migrated-the-api-to-huma-v2-at-100-parity/