Leçon 26 : Guide pratique des tests automatisés d’API et des variables
Développement d’API REST : Construire, Tester, Dépanner
Dans cette dernière leçon, nous nous concentrons sur des **techniques pratiques de tests automatisés d’API** et sur la manière d’utiliser efficacement les variables dans Postman afin de gérer des données dynamiques entre différentes requêtes.
Utilisation des variables dans Postman
Les variables permettent de réutiliser des données telles que les endpoints d’API, les jetons d’authentification ou les identifiants d’utilisateurs
dans l’ensemble de vos tests. Postman prend en charge plusieurs types de variables :
- Variables globales : accessibles dans toutes les collections et environnements.
- Variables d’environnement : spécifiques à un environnement donné (par exemple dev, staging, production).
- Variables de collection : limitées à une collection particulière.
- Variables locales : disponibles uniquement dans une seule requête ou un script.
Exemple pratique : utilisation des variables
Supposons que vous souhaitiez créer puis vérifier un utilisateur via des requêtes POST et GET.
L’utilisation de variables garantit que vous pouvez référencer dynamiquement l’identifiant de l’utilisateur créé :
// Créer un utilisateur
POST /api/users
{
"name": "John Doe",
"email": "john@example.com"
}
// Stocker l'ID de l'utilisateur dans une variable
pm.environment.set("userId", pm.response.json().id);
// Utiliser la variable dans la requête GET suivante
GET /api/users/{{userId}}
Automatisation des tests avec des variables
Les variables facilitent l’enchaînement des requêtes et la création de tests automatisés robustes. Par exemple :
// Vérifier l'email de l'utilisateur
pm.test("User email is correct", function() {
var jsonData = pm.response.json();
pm.expect(jsonData.email).to.eql("john@example.com");
});
// Supprimer l'utilisateur après le test
DELETE /api/users/{{userId}}
Bonnes pratiques
- Utiliser des variables d’environnement pour passer facilement entre les endpoints dev, test et production.
- Effacer ou réinitialiser les variables après l’exécution des tests afin d’éviter les conflits.
- Utiliser des noms de variables descriptifs pour plus de clarté et de maintenabilité.
- Combiner les variables avec des scripts pré-requête pour générer des données dynamiques (horodatages, valeurs aléatoires).
- Intégrer les tests automatisés dans les pipelines CI/CD pour une validation continue.
Conclusion
Maîtriser les variables et les tests automatisés garantit que votre API REST est fiable, maintenable et prête pour la production.
Ces techniques améliorent la couverture des tests, réduisent le travail manuel et renforcent la qualité globale de l’API.