Entretenir le dispositif
Le support à maintenir comprend : une documentation d’API, des exemples, des tests de contrat et un registre des consommateurs.
Prévoir des déclencheurs de mise à jour et un contrôle périodique des informations anciennes. Conservez l’historique des décisions significatives, car une date modifiée sans vérification du contenu ne constitue pas une véritable révision.
Le propriétaire de l’API porte le contrat, les consommateurs déclarent leurs usages, et sécurité et exploitation vérifient les contraintes.
Suivre disponibilité utile, erreurs par cause et consommateurs utilisant une version en retrait.
Tester un appel valide, un refus d’accès, une donnée invalide, un délai dépassé et une reprise.
Application à votre contexte
Associez la mise à jour aux événements qui changent la réalité : projet, incident, contrat, mouvement de personnel ou changement de données. Une revue périodique complète ce dispositif mais ne remplace pas ces déclencheurs.
Un test utile exerce un comportement attendu et dispose d'un résultat observable. Complétez les tests unitaires par des vérifications d'intégration et des parcours métier. Le taux de couverture du code ne démontre, à lui seul, ni la qualité des assertions ni l'absence de défauts.