Comment transformer les appels API de mon application en tests API ?
Enregistrez-les pendant que vous utilisez l’application, examinez la liste et générez un test à partir des appels que vous conservez. Le Nexus Recorder de Nexus StudioQA, développé par Verdict System LLC, enregistre les appels d’une page sous forme de tests REST ou GraphQL, exclut les en-têtes d’authentification et de cookies et transforme les champs susceptibles de contenir des secrets en variables d’environnement. Tout s’exécute sur votre propre machine.
Dernière mise à jour :
Par l’équipe Nexus StudioQA, Verdict System LLC.
Comment fonctionne l’enregistrement ?
- Dans le Nexus Recorder, enregistrez les appels de la page pendant que vous suivez un parcours, par exemple une connexion puis un passage en caisse.
- Avant la création de tout test, la vue de vérification répertorie chaque appel avec sa méthode, son chemin, son statut, sa catégorie et la raison de son inclusion ou de son exclusion.
- Les appels métier, d’authentification, de lecture et de modification d’état sont inclus par défaut dans la suite. Les balises de télémétrie, les hôtes tiers, les ressources et les requêtes préliminaires en sont exclus, mais vous pouvez les réintégrer en les cochant.
- Les parcours transmettent une valeur d’une réponse à une requête ultérieure, par exemple le jeton renvoyé lors d’une connexion.
Que puis-je générer à partir d’un enregistrement ?
- Générer un test écrit la suite de tests API.
- Générer OpenAPI écrit une ébauche OpenAPI 3.1 avec les types et les codes de statut, sans aucune des valeurs enregistrées.
- Test de charge ouvre les mêmes appels sous forme de plan de charge.
Quels éléments sont exclus du fichier de test ?
| Ce que l’enregistrement a capturé | Ce que contient le fichier de test |
|---|---|
| En-têtes d’authentification et de cookies | Exclus |
| Champs dont le nom évoque un secret | Une variable d’environnement, répertoriée dans la section des données masquées |
| JWT, clés de fournisseurs et numéros de carte dans n’importe quel champ | Masqués en fonction de leur valeur, et pas seulement du nom du champ |
| Télémétrie, hôtes tiers, ressources et requêtes préliminaires | Exclus par défaut |
Lors de l’exécution du test, son jeton d’authentification est envoyé uniquement à l’origine définie dans API_BASE_URL, jamais à un autre hôte apparu dans l’enregistrement.
Comment les tests API sont-ils évalués ?
Ils s’exécutent depuis Patrol comme tout autre test, et chaque point de terminaison produit son propre dossier de preuves. Les tests API n’ont pas de bac à sable : ils s’exécutent réellement dès le premier clic. Ils reçoivent leurs propres verdicts API : API_SECURE lorsque toutes les assertions sont vérifiées et que la structure de la réponse correspond à la dernière enregistrée, API_FLAKY lorsqu’une nouvelle tentative réussit, et API_DRIFTED lorsque le test réussit mais que la structure a changé, avec la liste de chaque champ ajouté, supprimé ou dont le type a changé. La page Dérive du schéma API montre une dérive lors d’une exécution réelle.
Quelles sont les limites ?
- Un enregistrement ne contient que les appels effectués par la page pendant l’enregistrement. Un point de terminaison que le parcours n’a jamais sollicité n’y figure pas.
- L’enregistrement écrit des tests REST et GraphQL. Les tests SOAP sont créés manuellement, sous forme de XML envoyé en tant que texte et vérifié avec des règles textuelles.
- Les tests API utilisent le format propre à Studio : les transférer vers un autre moteur d’exécution nécessite donc de les réécrire. Les tests de navigateur écrits par le Recorder restent au format standard Playwright ou Selenium.
- Examinez le test généré avant de vous y fier : l’enregistrement sait ce que l’application a fait, pas ce qu’elle devrait faire.
Où puis-je le constater ?
La visite guidée de Studio présente le Nexus Recorder, et la page Dérive du schéma API explique les verdicts API à l’aide d’un exemple exécutable. L’essai gratuit utilise le même moteur sur votre propre application.