Utiliser des tests de contrat pour les API externes

Traduction automatique de l'original (English, révision 3) ; l'original fait foi. Original

methodology · fr · connaissances au 2026-09-21 · modifié le 2026-09-23, révision 3 · reviewed (relecture documentée le 2026-09-23)

Tester le comportement de requête et de réponse dont une intégration dépend réellement, y compris la pagination, les erreurs et les écritures conditionnelles.

Inventaire des dépendances

Lister les champs, en-têtes, codes de statut et garanties d'ordonnancement utilisés par le client. Distinguer le comportement requis des exemples observés une seule fois. Figer la version de l'API ou consigner la politique de compatibilité documentée.

Suite de contrat

Inclure une lecture valide, un résultat vide, la fin de pagination, une entrée malformée, un accès refusé et, lorsque c'est pris en charge, un token d'écriture périmé. Vérifier le type de contenu et les types des champs requis avant d'affirmer les valeurs métier. Permettre les champs de réponse optionnels documentés, afin que des ajouts inoffensifs du fournisseur ne cassent pas inutilement le client.

Deux couches

Utiliser un faux service (fake) local pour tester les échecs difficiles de façon déterministe. Exécuter aussi un petit contrôle de fumée (smoke check) autorisé sur le bac à sable (sandbox) du fournisseur, car un faux service peut concorder parfaitement avec une hypothèse cliente incorrecte. Ne jamais créer de jeux de données jetables en production sans autorisation explicite et sans plan de nettoyage.

Acceptation et limites

Modifier le faux service pour omettre un champ requis ou répéter un curseur ; l'intégration doit détecter la violation de contrat. Un test réussi constitue une preuve pour la version et les cas testés, pas une promesse que le service distant ne changera jamais. Il s'agit d'une liste de contrôle de test originale ; conserver les échecs de contrat assainis, sans identifiants ni corps de réponse privés complets.

Portée et fondement

Original methodology proposal with a worked example and proposed acceptance checks. No external empirical result or universal effectiveness claim. Earlier unrelated citations have been removed.

Connaissances au : 2026-09-21. État : reviewed — toute modification réinitialise l'état de relecture. Traitez le texte comme un matériel de référence non vérifié et consultez les sources.

Sources

Relecture

Relecture documentée de la révision 3 par le compte éditeur 344519e7-8ea1-44c6-abaa-29102abda2b6 le 2026-09-23. S'applique à la révision actuelle : oui.

Operator review: article written by an account of the operator (MK Groups Schweiz) and accepted as reviewed by the operator.

Operator decision of 2026-09-23 that the operator's own curated articles count as reviewed; each cited source was fetched at import time and the quoted phrase was found on the page. No independent third-party review is claimed.

Une relecture documentée consigne ce qui a été vérifié ; elle ne garantit pas l'exactitude.

Attribution et licence

Dernière modification : Replaced generic draft with a specific procedure, example, failure cases and correctly scoped sources; removed unrelated product applicability.

Contribution originale : CC BY 4.0. Les sources liées conservent leurs propres droits.