1. Nouvelle requête
Dans Postman, choisis New, puis HTTP.
Informatique · Web et réseaux
Avant d'écrire une ligne d'appli, tu veux savoir si l'API répond, avec quels codes et quelles données. Postman sert à ça.
Déjà à l'aise ? Aller au quizLe point de départ
Une appli de classe affiche des articles venus d'une API. Avant de coder, tu envoies une requête à la main et tu lis la réponse.
Tout se vérifie à la main, avant la moindre ligne d'appli.
Après cette fiche, tu sais
pm.test et enchaîner des requêtes ;Oui, non ? Tu me diras si je me trompe.
Premier envoi, premier code
Notion 1 · L'outil
Postman est un client HTTP graphique. Tu choisis la méthode, tu écris l'adresse, puis tu cliques sur Send. Il existe en application de bureau et en version web.
Pour s'entraîner sans rien casser, on utilise une API de test.
Pour s'entraîner
JSONPlaceholder est une fausse API publique. Elle sert des articles, des utilisateurs et des commentaires. Ses lectures renvoient des données de test, et ses écritures sont simulées : rien n'est vraiment enregistré.1
Un POST, un PUT, un PATCH ou un DELETE ne change rien de réel ici.
Ce que tu remplis
Une requête tient en quatre champs : la méthode, l'adresse, les en-têtes et le corps. Tu les remplis, puis tu envoies.
Pour un GET, le corps reste vide.
Ta première requête, en trois gestes
Dans Postman, choisis New, puis HTTP.
Choisis GET, puis tape https://jsonplaceholder.typicode.com/users.
La réponse 200 OK contient la liste des 10 utilisateurs, en JSON.
Fais défiler : chaque requête part vers JSONPlaceholder. Les codes affichés sont ceux que l'API a réellement renvoyés, y compris ses bizarreries.
Lire une liste
Ce que tu reçois
La réponse a trois parties : une ligne d'état, des en-têtes, puis un corps. Postman affiche aussi le temps de réponse.
Le corps, ici du JSON13, est ce que ton programme lira.
GET /users.1Tu veux dire que mon adresse est peut-être fausse ?
| Verbe | Dans Postman | Chez JSONPlaceholder |
|---|---|---|
| GET | pas de corps | 200, ou 404 si l'article n'existe pas |
| POST | Body → raw → JSON | 201 et un id 101, simulé |
| PUT | corps complet | 200 (500 pour un article inexistant) |
| PATCH | seulement les champs à changer | 200, le reste de l'article intact |
| DELETE | pas de corps | 200 et {} (beaucoup d'API répondent 204) |
Le sens de chaque méthode et de chaque code est détaillé dans la fiche HTTP et REST. Quand tu choisis Body → raw → JSON, Postman ajoute l'en-tête Content-Type: application/json pour toi.
Ranger, partager, lancer d'un coup
Notion 2 · Les collections
Une collection regroupe les requêtes d'une même API, parfois en dossiers. On la sauvegarde, on la partage, on l'exporte en JSON, et on la lance d'un coup.
Le Runner, vu à la notion 4, lance toutes ces requêtes d'un coup.
Les onglets d'une requête
La partie ?clé=valeur de l'adresse.
Le jeton, la clé d'API ou les identifiants.
Les en-têtes, comme Content-Type.
Le corps envoyé, par exemple du JSON pour un POST.
Le code exécuté avant l'envoi ou après la réponse.
Démonter une adresse
Une adresse se découpe : le protocole, le serveur, le chemin, puis les paramètres après le ?.12
L'onglet Params écrit cette dernière partie à ta place.
Authorization : le jeton
Certaines API demandent un jeton. Avec le type Bearer Token, Postman ajoute pour toi l'en-tête Authorization: Bearer … à chaque envoi.14
Jeton absent ou faux : 401. Jeton valide, droits insuffisants : 403.9
Jamais de jeton dans l'adresse.11
Changer de serveur sans rien réécrire
Notion 3 · Variables et environnements
Une même API tourne sur ta machine, sur un serveur de test, puis en production. Au lieu de corriger l'adresse partout, tu écris une variable, {{base_url}}, et chaque environnement lui donne sa valeur.
Postman remplace la variable au moment de l'envoi.
Fais défiler : la même requête part vers trois serveurs, sans rien réécrire.
La requête contient {{base_url}} : Postman la remplacera par une valeur au moment de l'envoi.
Environnement « Développement » : l'API tourne sur ta machine, port 3000.
Un clic sur « Test » : les mêmes requêtes visent le serveur de test, sans rien réécrire.
« Production » : la vraie API. Prudence avec les requêtes qui modifient ou suppriment.
Cinq portées
Une variable peut vivre à cinq niveaux : globale, de collection, d'environnement, de fichier de données, locale. Si le même nom existe à plusieurs niveaux, le plus étroit gagne.4
Une variable d'environnement l'emporte donc sur une variable de collection.
Un coffre pour les secrets
Pour un mot de passe ou un jeton, Postman propose un coffre (Postman Vault) plutôt qu'une variable partagée.4
Une variable partagée peut se retrouver dans un fichier exporté.
Variables dynamiques
Postman fournit des variables recalculées à chaque envoi : {{$randomInt}} (un entier de 0 à 1 000), {{$randomEmail}}, {{$guid}} et {{$timestamp}} (l'heure Unix, en secondes).5
Dans un corps JSON : { "id": {{$randomInt}} }
Tester, c'est attendre quelque chose
Notion 4 · Les tests automatiques
L'onglet Scripts a deux parties : Pre-request, exécuté avant l'envoi, et Post-response, exécuté après la réponse. Les scripts de la collection passent d'abord, puis ceux du dossier, puis ceux de la requête.2
Les tests vivent dans Post-response.
Anatomie d'un test
Un test a un nom, une fonction et une assertion. On l'écrit en JavaScript, avec l'objet pm.8
Si l'assertion est fausse, le test échoue.
pm.test("Le statut est 200", function () {
pm.response.to.have.status(200);
});
pm.test("La réponse est du JSON", function () {
pm.response.to.be.json;
});
pm.test("L'article appartient à l'utilisateur 1", function () {
const article = pm.response.json();
pm.expect(article.userId).to.eql(1);
});
pm.test("Réponse en moins de 500 ms", function () {
pm.expect(pm.response.responseTime).to.be.below(500);
});Enchaîner deux requêtes
Un script post-réponse range une valeur dans une variable, que la requête suivante utilise.
const id = pm.response.json().id; // 101 chez JSONPlaceholder
pm.environment.set("postId", id);Ici, l'id 101 vient de la réponse du POST.
Le Collection Runner
Le Runner lance toute une collection, une requête après l'autre, avec ses tests. On peut répéter le passage (itérations), attendre entre deux requêtes et fournir un fichier de données CSV ou JSON pour tester plusieurs cas.3
Premier passage
Trois situations de tests. Choisis la bonne réponse : les scripts ont été exécutés avec Newman contre JSONPlaceholder.
Range chaque tâche dans le script où elle doit s'écrire.
Place à l'intégration continue
Notion 5 · Automatiser
Une collection exportée se lance en ligne de commande. Dans un pipeline d'intégration continue (GitHub Actions, GitLab CI…), elle est rejouée à chaque modification du code.
Une seule commande suffit, sans fenêtre Postman.
L'outil en ligne de commande officiel de Postman, signé par l'éditeur.6 Une collection exportée en fichier se lance sans compte ; la connexion (postman login) sert notamment à publier les résultats dans Postman.
L'ancien lanceur, libre et toujours disponible. Il ne lit pas le nouveau format de collection v3 de Postman v12 et suivants : Postman conseille de passer à la Postman CLI.7
# Postman CLI npm install -g postman-cli postman collection run collection.json -e environnement.json # Newman (collections au format v2.1) npm install -g newman newman-reporter-html newman run collection.json -e environnement.json -r cli,html newman run collection.json --bail # s'arrête au premier échec
Le rapport HTML de Newman demande le paquet newman-reporter-html, installé au même endroit que Newman : sans lui, -r html s'arrête avec « could not find "html" reporter ». Toutes ces commandes ont été testées (Postman CLI 1.67, Newman 6.2.2).
Fais défiler : ce que fait un pipeline quand quelqu'un pousse du code.
Quelqu'un pousse une modification du code de l'API sur le dépôt.
Le pipeline démarre : il installe l'API sur un serveur de test.
Il lance la collection avec la Postman CLI : toutes les requêtes et tous les tests.
Tests verts : l'API est déployée. Un seul test rouge : le pipeline s'arrête et prévient l'équipe.
Six pièges à éviter
Elle prouve seulement ce que les tests vérifient. Contre JSONPlaceholder, les créations et suppressions sont simulées : rien n'est enregistré.
Beaucoup d'API répondent 204 à un DELETE, JSONPlaceholder répond 200. Un test se règle sur la documentation de l'API testée.
Toute personne qui reçoit la collection récupère le jeton. Range les secrets dans le coffre de Postman, et jamais dans l'adresse : elle finit dans les journaux des serveurs.11
Un JSON envoyé comme texte brut peut être refusé ou mal lu. Choisis Body → raw → JSON, qui ajoute l'en-tête.
Le Runner continue avec les requêtes suivantes. Par défaut, il ne s'arrête que sur une erreur dans un script ou un échec d'envoi (option Stop run if an error occurs).3 Pour s'arrêter au premier test raté, Newman a l'option --bail.
Vérifie l'environnement choisi avant Send : la même requête vise un autre serveur selon l'environnement.
Entraîne-toi
Cherche d'abord, puis ouvre le corrigé. Les scripts ont été exécutés avec Newman contre JSONPlaceholder.
GET /posts renvoie exactement 100 articles.Voir le corrigépm.test("100 articles", function () {
pm.expect(pm.response.json().length).to.eql(100);
});base_url existe dans la collection et dans l'environnement actif, avec deux valeurs différentes. Laquelle Postman utilise-t-il ?Voir le corrigéCelle de l'environnement : de globale à locale, la portée la plus étroite gagne, et l'environnement est plus étroit que la collection.
GET /posts/101 renvoie 404. Bug ?Voir le corrigéNon : JSONPlaceholder simule les écritures, l'article n'a jamais été enregistré. Contre une vraie API, ce même enchaînement serait un excellent test.
collection.json avec l'environnement test.json dans un pipeline, avec l'outil officiel de Postman ?Voir le corrigénpm install -g postman-cli postman collection run collection.json -e test.json
La mission, pour de vrai
Dans le vrai Postman
Ouvre Postman et refais la scène du Runner toi-même, contre JSONPlaceholder.
base_url = https://jsonplaceholder.typicode.com, puis sélectionne-le.GET /posts, POST /posts, GET /posts/{{postId}}, PUT /posts/1, PATCH /posts/1, DELETE /posts/1, toutes avec {{base_url}}.GET /posts ; 201 et un id pour le POST, qui range aussi l'id dans postId ; 404 pour la relecture ; 200 pour les trois dernières.postman collection run.À retenir
Douze questions pour finir
Authorization: Bearer, risques d'un jeton placé dans l'adresse. rfc-editor.org, consulté le 8 octobre 2026.Fiche relue et sourcée en septembre 2026, refaite en récit en octobre 2026. Codes de JSONPlaceholder relevés le 1er octobre 2026 ; scripts exécutés avec Newman 6.2.2 et la Postman CLI 1.67.0.