Tester les API tierces : la méthode simple
Offrir une expérience utilisateur réussie est un défi permanent. Il faut répondre aux attentes des utilisateurs tout en garantissant les exigences non fonctionnelles comme la performance, la confidentialité et la sécurité.
Sur cette page

Un site web effectue en moyenne 40 appels à des API externes pour la mesure d’audience, le consentement et d’autres services partenaires. Ces API n’ont rien d’optionnel : elles font partie de l’expérience utilisateur, et il est donc important de les tester.
Les outils classiques d’automatisation des tests ont un périmètre étroit. Ils permettent des tests fonctionnels sur une interface web ou mobile, mais pas des tests d’API. À l’inverse, d’autres testent les API, mais pas l’interface utilisateur.
Dans cet article, nous partageons une méthode simple pour automatiser les tests des API tierces appelées par une application web. Nous utilisons Cerberus Testing, en trois étapes :
- Identifier vos attentes sur les API tierces
- Configurer votre test pour collecter les données réseau
- Ajouter vos attentes avec des filtres et des contrôles
Commençons par le commencement : explorer et définir vos attentes.
Identifier vos attentes sur les API tierces#
La première étape consiste à savoir quels appels externes il est le plus important de tester. Idéalement, vous connaissez l’application. Vous pouvez aussi interroger les équipes produit et techniques sur les intégrations spécifiques, et les impliquer ainsi dans la démarche.
Vous pouvez en outre repérer les différents appels tiers avec votre simple navigateur web. Dans Firefox, un clic droit puis « Inspecter » (Inspect) donne accès à différents éléments de traçabilité. Les données recherchées se trouvent dans l’onglet « Réseau » (Network).
Au fil de votre navigation sur le site, les différents appels aux API tierces apparaissent dans cette liste. Les éléments importants à noter sont le domaine et la requête : ils serviront à définir vos assertions.
Il s’agit ensuite de récupérer ces données dans votre test.
Configurer votre test pour collecter les données réseau#
Accéder aux données du navigateur et du trafic réseau n’a rien de trivial. Avec votre propre framework d’automatisation des tests, il faut beaucoup de code et d’intégration pour récupérer ces données, les analyser et les rendre exploitables.
Cerberus Testing vous donne accès nativement à ces données, déjà formatées. Il suffit de définir les deux actions low-code (s’ouvre dans un nouvel onglet) nécessaires après chaque page visitée. Ces deux actions sont les suivantes :
- « waitNetworkTrafficIdle » lance la collecte des données au bon moment ;
- « setNetworkTrafficContent » collecte effectivement les données.
Dès lors, votre cas de test collectera les données réseau à chaque exécution. Vous pouvez vérifier votre configuration en exécutant le cas de test. Point de vigilance : votre robot Selenium doit passer par un proxy pour accéder réellement aux données externes. Avec une offre Cloud, c’est disponible nativement ; sinon, il vous faut le robot dédié, cerberus-robot-proxy sur GitHub (s’ouvre dans un nouvel onglet).
Après l’exécution, vous accédez à ces données sous une forme structurée. Elles sont au format JSON pour faciliter leur lecture et vos contrôles, et déjà réparties entre métriques globales et métriques par domaine. Vous vous concentrez sur les vérifications, sans avoir à coder d’analyse technique (parsing).
Vous êtes maintenant prêt à ajouter les contrôles souhaités dans vos différents cas de test.
Ajouter vos attentes avec des filtres et des contrôles#
Vous pouvez reproduire cette structure pour capturer les données réseau dans vos cas de test. Les filtres et la vérification JSON vous simplifient la tâche : il suffit de préciser les attentes pour chaque fournisseur, avec une action et un contrôle.
L’action reste « setNetworkTrafficContent », avec ou sans filtre. Dans notre cas, nous filtrons sur « google-analytics » : seuls ces appels sont comptabilisés, ce qui simplifie le contrôle suivant.
Le contrôle sur « $.stat.total.requests.nb » accède à la valeur dans le JSON formaté préparé par Cerberus Testing. « Stat » signifie « statistics » (statistiques) et « nb », « number » (nombre). La même structure et le même mot-clé de contrôle permettent de vérifier n’importe quel élément du JSON.
Vous pouvez même ajouter ces contrôles à votre bibliothèque, pour les réutiliser d’un cas de test à l’autre et les reproduire au sein de votre test. Vous pouvez aussi ajouter des paramètres dynamiques par pays, ou issus d’un cas de test précédent, grâce à une propriété.
Ce n’est que le début de l’amélioration de la qualité de votre produit.
Étendre votre démarche par l’amélioration continue#
Nous avons couvert les 3 grandes étapes pour ajouter la vérification des appels aux API tierces dans votre application web. Cerberus Testing accélère votre démarche d’automatisation des tests en fournissant nativement les fonctionnalités nécessaires.
Nous avons présenté le cas simple consistant à vérifier qu’un appel a bien été effectué vers un service tiers. Le framework et les données disponibles vous permettent d’aller plus loin en contrôlant les résultats de l’appel d’API, et même en vérifiant que le temps de réponse reste sous un SLA donné.
Les interfaces utilisateur sont le fruit d’un assemblage de technologies qui crée de la valeur. En tant qu’ingénieurs, il nous revient de garantir que leur intégration sert une expérience utilisateur réussie, en constante amélioration.
Envie d’améliorer votre expérience utilisateur ? Essayez Cerberus Testing gratuitement.


