Tests API : définition, outils et exemples (Postman, REST Assured, Playwright)

Un test API vérifie directement une interface de programmation (le plus souvent une API REST en HTTP) sans passer par l'écran : il envoie une requête, puis contrôle le code de statut, le corps de la réponse et les règles métier. Pour tester des API, utilisez Postman pour l'exploration et REST Assured (Java) ou requests + pytest (Python) pour l'automatisation en CI/CD — pas Selenium, conçu pour le navigateur. Selenium, REST Assured et Postman sont les outils les plus cités — mais ils n'ont pas du tout le même rôle. Ce guide clarifie leurs cas d'usage et vous aide à choisir.

Ce guide fait partie de notre dossier sur l'automatisation des tests : définition, outils et étapes pour automatiser vos tests logiciels.

Qu'est-ce qu'un test API ?

Un test API vérifie directement l'interface d'une application en envoyant des requêtes HTTP à ses endpoints et en contrôlant les réponses : code de statut, corps, en-têtes, temps de réponse et gestion des erreurs. Il contourne entièrement l'interface utilisateur, ce qui rend les tests API plus rapides et plus stables que les tests d'interface, et permet de tester les règles métier avant même que le front-end existe.

Dans une architecture microservices, les tests API valident aussi le contrat entre services : si une équipe renomme un champ ou change un format de réponse, une bonne suite de tests API échoue avant que le changement n'atteigne la production.

Pourquoi ne pas utiliser Selenium pour les API ?

Selenium est conçu pour automatiser les navigateurs (interactions UI). Il peut techniquement passer par l'interface graphique pour déclencher des appels API, mais c'est une mauvaise pratique : lent, fragile, impossible à utiliser sans front-end. Pour tester les API directement, utilisez des outils HTTP dédiés.

En pratique, les équipes Java gardent Selenium pour leurs tests d'interface et ajoutent REST Assured dans le même projet pour la couche API. Les deux s'exécutent avec JUnit ou TestNG : ils partagent le même build et le même pipeline CI.

Postman — L'outil de test et d'exploration

Postman est idéal pour explorer, documenter et tester manuellement les API REST. Son interface graphique permet de créer des requêtes, d'ajouter des assertions et d'organiser les tests en collections. Newman (CLI de Postman) permet l'intégration CI/CD.

REST Assured — Les tests API en Java

REST Assured est une bibliothèque Java (DSL fluent) dédiée aux tests d'API REST. Elle s'intègre nativement avec JUnit et TestNG, ce qui en fait le choix naturel pour les stacks Java/Spring Boot.

Une vérification typique se lit ainsi : given().auth().oauth2(token).when().get("/orders/42").then().statusCode(200).body("status", equalTo("PAID")). Les assertions utilisent les matchers Hamcrest, et la bibliothèque gère l'authentification, l'analyse JSON et XML, ainsi que des spécifications de requête réutilisables d'un test à l'autre.

Postman ou REST Assured : lequel choisir ?

Choisissez Postman pour explorer et documenter une API, et REST Assured pour automatiser ses tests de régression dans un projet Java. Ils sont complémentaires, pas concurrents : Postman est un outil dans lequel on clique, REST Assured est du code qui vit à côté de l'application, passe en revue de code et s'exécute à chaque commit.

Si votre équipe ne travaille pas en Java, le même raisonnement s'applique avec un autre outil en code : requests + pytest en Python, ou Playwright en TypeScript.

Playwright peut-il tester des API ?

Oui. Playwright intègre une fonction de test d'API fondée sur APIRequestContext : la fixture request envoie des requêtes HTTP directement, sans ouvrir de navigateur, et expect(response).toBeOK() vérifie le statut. Tests API et tests de bout en bout partagent alors un seul projet TypeScript, un seul runner et un seul rapport. Le module 3 de la formation Playwright certifiante (certificat ADC) y est consacré.

Usage courant : préparer les données par l'API (créer un utilisateur, une commande) avant un test d'interface, puis vérifier par l'API l'effet de l'action. Les tests de bout en bout restent courts et moins fragiles.

Alternatives modernes

Le tableau ci-dessous résume les principales options. Aucune n'a besoin d'un navigateur, contrairement à Selenium, qui pour cette raison n'est pas un véritable outil de test API.

Comment exécuter des tests API dans un pipeline CI/CD ?

Lancez-les à chaque pull request, avant les tests d'interface plus lents. Les collections Postman s'exécutent avec Newman, les suites REST Assured avec Maven ou Gradle, Playwright avec npx playwright test et les suites Python avec pytest. Stockez les secrets dans les variables du pipeline, jamais dans la collection ni dans le code, et publiez le rapport comme artefact du build.

Rapides, les tests API trouvent leur place à la base de la pyramide des tests : beaucoup de tests API, moins de tests d'interface. Un test API en échec pointe aussi directement l'endpoint défaillant, ce qui fait gagner du temps de débogage. Consultez notre guide des tests automatisés dans un pipeline CI/CD pour des exemples de pipelines.

Quelle certification pour les tests API ?

L'ISTQB ne propose pas de certification dédiée aux tests d'API. Le parcours habituel est l'ISTQB Certified Tester Foundation Level (CTFL) pour les fondamentaux du test, puis le niveau spécialiste Test Automation Engineering pour l'architecture de l'automatisation. Ce que les recruteurs regardent le plus reste la pratique : un dépôt public avec une suite de tests API fonctionnelle qui tourne en CI. Voir aussi nos certifications.

Notre recommandation

Pour un projet Python, utilisez requests + pytest : simple, puissant, et s'intègre parfaitement avec vos tests existants. Pour un projet Java, REST Assured est le standard. Pour la documentation et l'exploration, Postman reste imbattable. Pour une équipe TypeScript qui écrit déjà des tests de bout en bout avec Playwright, utilisez la fixture request de Playwright plutôt que d'ajouter un outil de plus. Les meilleures équipes combinent Postman (exploration) + un outil de code (automatisation).

Vous ne savez pas quelle approche convient à votre stack, ou si vos tests API actuels détectent vraiment les régressions ? Notre audit QA en 5 jours ouvrés passe en revue votre suite de tests et votre CI, puis livre une stratégie de test et un plan d'action chiffré.

Questions fréquentes