Vous pouvez ajouter des appels API en tant qu'étapes dans votre scénario de test automatisé.
Ce que vous apprendrez
Ajouter une étape API depuis l'éditeur de test ou le chat
Configurer la méthode HTTP, les en-têtes, l'authentification, le corps et les paramètres par environnement
Utiliser le menu des variables pour insérer des identifiants, des variables de projet et des valeurs extraites
Exécuter l'étape et inspecter la réponse dans l'Inspecteur de réponse
Enregistrer la réponse de l'API en tant que variable réutilisable, avec assertions et extractions
1. Configurer votre appel API
Ajouter l'étape
Vous pouvez ajouter une étape API de deux façons :
Depuis l'éditeur — Cliquez sur Ajouter une nouvelle étape, puis dans le menu déroulant Type d'étape sélectionnez Appel API.
Depuis le chat — Envoyez un prompt comme « Ajoute une requête POST à https://example.com avec un Bearer token et un corps contenant id et content ». Thunders Copilot créera et pré-remplira l'étape pour vous.
Choisir l'environnement cible
Chaque étape API a un sélecteur d'environnement en haut du formulaire.
Choisissez Mêmes paramètres pour tous les environnements (l'option par défaut) pour les valeurs partagées. C'est la configuration de base que Thunders utilise dès qu'un environnement ne définit pas la sienne — ne remplissez que celle-ci si l'URL, les en-têtes, le corps et l'auth sont identiques partout.
Choisissez un environnement spécifique (par exemple Staging, Prod) pour définir des valeurs propres à cet environnement (URL, en-têtes, corps, auth, etc.).
Règle de priorité — une valeur spécifique à un environnement remplace la valeur partagée. Si aucune valeur n'existe pour l'environnement actif, Thunders revient à Mêmes paramètres pour tous les environnements (par défaut).
→ Vous n'avez besoin de surcharger que les environnements dont les paramètres diffèrent réellement.
Méthode et URL
Choisissez la méthode HTTP (GET, POST, PUT, PATCH, DELETE) et saisissez l'endpoint, par exemple https://jsonplaceholder.typicode.com/posts/1.
Paramètres
Ajoutez des paramètres de requête avec le bouton Add Row. Chaque ligne est une paire clé/valeur.
En-têtes
Ajoutez les en-têtes de la même façon — par exemple Content-Type: application/json.
Authentification
Choisissez l'une des options :
Aucune authentification — aucun en-tête Authorization envoyé.
Basic Auth — nom d'utilisateur + mot de passe.
Bearer Token — valeur du jeton.
Les champs mot de passe et jeton sont masqués par défaut. Cliquez sur l'icône en forme d'œil pour les afficher.
Corps de la requête
Choisissez le format du corps qui correspond à votre endpoint :
Raw JSON — collez une charge utile JSON (utilisé pour POST / PUT / PATCH).
URL-encoded — ajoutez des paires clé/valeur, envoyées en
application/x-www-form-urlencoded.
Variables dans les champs de la requête
Tapez [ ou / dans l'URL, les valeurs d'en-tête, les valeurs de paramètre, les champs d'authentification ou les valeurs du corps URL-encoded pour ouvrir le menu des variables. Vous pouvez :
Insérer une variable de projet, un identifiant ou une variable extraite existants.
Créer une nouvelle variable directement sans quitter l'étape.
Les corps Raw JSON utilisent directement la syntaxe [VARIABLE_NAME].
Enregistrer la réponse sous
La réponse complète de l'API est automatiquement enregistrée dans une variable pour pouvoir la réutiliser dans les étapes suivantes. Le champ Enregistrer la réponse sous est pré-rempli (API_RESPONSE_1, API_RESPONSE_2, …). Renommez-la avec un nom plus descriptif comme LOGIN_RESPONSE quand cela a du sens. La syntaxe complète de réutilisation est détaillée dans la section 4.
2. Exemple : utiliser des variables et des identifiants dans une étape API
💡 Vous pouvez créer des identifiants et des variables directement depuis l'étape API. Pendant l'édition d'une étape API, tapez [ ou / dans un champ supporté (URL, valeurs d'en-tête, valeurs de paramètre, champs d'authentification ou valeurs du corps URL-encoded) et choisissez Créer une nouvelle variable dans le menu — pas besoin de quitter le scénario de test. La page d'environnement reste utile pour gérer les valeurs existantes au même endroit.
Imaginez que vous souhaitez créer un nouvel utilisateur via une API qui exige une clé d'API dans l'en-tête Authorization, et un nom d'utilisateur / email / mot de passe dans le corps.
Créer les identifiants et variables
Soit directement depuis l'étape API (callout ci-dessus), soit depuis la page environnement / paramètres projet :
Un identifiant nommé
API_KEY— votre vraie clé d'API.Une variable nommée
USER_EMAIL— l'email de connexion utilisé dans le corps de la requête.Un identifiant nommé
PASSWORD— le mot de passe utilisé dans le corps de la requête.
→ Voir Ajouter / modifier / supprimer / utiliser des secrets et Variables pour les guides dédiés.
Les référencer dans l'étape API
Environnement :
Mêmes paramètres pour tous les environnementsMéthode :
POSTEn-têtes :
Content-Type: application/jsonAuthorization : Bearer Token →
[API_KEY]Corps (Raw JSON) :
{ "username": "user", "email": "[USER_EMAIL]", "password": "[PASSWORD]" }Lorsque Thunders exécute l'étape, [API_KEY], [USER_EMAIL] et [PASSWORD] sont remplacés par les valeurs de l'environnement actif.
Pourquoi c'est important :
Sécurité — les secrets ne sont jamais codés en dur dans les scénarios.
Maintenance — mettez à jour les identifiants en un seul endroit (l'environnement) et chaque étape qui les référence prend la nouvelle valeur.
Flexibilité — changez d'environnement actif pour pointer les mêmes tests vers dev, staging ou production.
Exécuter et inspecter la réponse
Cliquez sur Execute pour lancer le scénario. Une fois l'étape API terminée, la ligne de l'étape affiche un résumé compact :
Badge de la méthode HTTP, URL, et durée
Une carte Response avec le statut, la latence et le nombre d'éléments (par exemple
200 ok · 63 ms · 100 items)La mention « Full API response stored in [API_RESPONSE_1] »
Cliquez sur la ligne de l'étape API pour ouvrir l'Inspecteur de réponse dans la zone principale :
Cartes de métriques — Status code, Duration, Load Duration
Arbre JSON — déroulez et descendez dans le corps de la réponse
Copy — copie la réponse complète dans le presse-papiers
Assert / Extract — boutons en un clic sur chaque carte de métrique et chaque valeur JSON pour transformer une valeur en étape d'assertion ou en variable extraite
→ Guide complet des assertions et extractions : Assertions sur les réponses API et extraction de variables
Enregistrer la réponse et la réutiliser
Chaque étape API enregistre automatiquement la réponse entière dans la variable nommée dans Enregistrer la réponse sous (par défaut API_RESPONSE_N). Les étapes suivantes peuvent la référencer directement.
Règles de nommage — lettres majuscules, chiffres et underscores ; doit commencer par une lettre (regex ^[A-Z][A-Z0-9_]*$).
Syntaxe de référence dans n'importe quel champ supportant les variables, dans n'importe quelle étape suivante :
[LOGIN_RESPONSE]— l'objet réponse complet[LOGIN_RESPONSE].body.token— descend dans le corps JSON[LOGIN_RESPONSE].statusCode— code HTTP[LOGIN_RESPONSE].duration— durée de la requête (ms)
Vous pouvez les utiliser dans l'URL ou les en-têtes d'une étape API suivante, dans une assertion navigateur, dans une conditionnelle, et partout ailleurs où les variables sont acceptées.
Connexion
Exécuter et extraire accessToken dans la variable [ACCESS_TOKEN]
Utiliser la variable [ACCESS_TOKEN] dans l'appel API suivant pour identifier l'utilisateur
Reprendre l'exécution
→ Pour faire des assertions sur les valeurs de réponse et extraire des champs individuels dans leurs propres variables, voir le guide dédié : Assertions sur les réponses API et extraction de variables
Autres lectures connexes