"Si vous n'aimez pas les tests de votre produit, vos clients n'aimeront

probablement pas non plus le tester"

Test API avec Postman

Zied HANNACHI

Test lead automation chez ALL4TEST, pure player QA

 SOMMAIRE
• Qu'est-ce que l'API?
• Qu'est-ce que Postman?
• Pourquoi Postman?
• Installation du Postman

• Comment utiliser
Postman
• Qu'est-ce que HTTP?
• Testing Get Requests
• Testing Post Requests
• Comment créer des
tests Postman

Zied HANNACHI 2
 • API signifie Application Programming Interface . En termes
techniques, une API est un ensemble de procédures, de fonctions et
QU'EST-CE QUE L'API?
d'autres points d'accès qu'une application, un système d'exploitation,
une bibliothèque, etc. met à la disposition des programmeurs afin de
Zied HANNACHI lui permettre d'interagir avec d'autres logiciels. 3
 QU'EST-CE QUE POSTMAN?

Postman est une plateforme de À l'aide de l'outil Postman, nous

collaboration pour le pouvons envoyer des requêtes Étant à l'origine un plugin de
développement d'API. Il s'agit HTTP / s à un service, ainsi navigateur Chrome, Postman
d'un client API populaire et il qu'obtenir leurs réponses. Ce étend désormais sa solution
vous permet de concevoir, faisant, nous pouvons nous avec la version native pour Mac
créer, partager, tester et assurer que le service est et Windows.
documenter des API. opérationnel.

Zied HANNACHI 4
 POURQUOI POSTMAN?

GRATUIT: IL EST FACILE: TÉLÉCHARG PRISE EN CHARGE EXTENSIBLE: VOUS INTÉGRATION: VOU COMMUNAUTÉ ET
GRATUIT À EZ-LE ET ENVOYEZ DES API: VOUS POUVEZ LE S POUVEZ ASSISTANCE: IL
TÉLÉCHARGER ET À VOTRE PREMIÈRE POUVEZ EFFECTUER PERSONNALISER FACILEMENT DISPOSE D'UN
UTILISER POUR LES DEMANDE EN TOUT TYPE D'APPEL SELON VOS BESOINS INTÉGRER DES SUITES IMMENSE FORUM
ÉQUIPES DE TOUTES QUELQUES MINUTES. API (REST, SOAP OU AVEC L'API POSTMAN. DE TESTS DANS COMMUNAUTAIRE
TAILLES. HTTP SIMPLE) ET VOTRE SERVICE CI /
INSPECTER CD PRÉFÉRÉ AVEC
FACILEMENT MÊME NEWMAN
LES RÉPONSES LES (EXÉCUTEUR DE
PLUS IMPORTANTES. COLLECTE DE LIGNE
DE COMMANDE)

Zied HANNACHI 5
 INSTALLATION DU POSTMAN

Étape 1: Pour installer Postman,

cliquez sur ce lien et cliquez sur Étape 2: Ouvrez le fichier exe de
Télécharger pour Mac / Windows / Windows 64 bits Postman pour
Linux en fonction de votre plate- l'installer sur votre système.
forme.

Étape 3: Une fois l'installation de

Postman terminée, il vous sera
demandé de créer un compte.Vous Étape 4: Une fois connecté, choisissez
pouvez créer un compte plus tard en vos paramètres préférés et cliquez
cliquant sur le lien "Emmenez-moi sur Enregistrer.
directement à l'application, je vais
créer un compte une autre fois".

Zied HANNACHI 6
 COMMENT UTILISER • Tous les composants de l'outil Postman ont leur propre importance. Voyons
POSTMAN
maintenant les différentes options de l'espace de travail Postman.

Zied HANNACHI 7
 1. Nouveau: il s'agit de créer une nouvelle demande, une nouvelle collection ou un nouvel
environnement.
2. Importer: il s'agit d'importer une collection ou un environnement. Vous pouvez également
trouver d'autres options telles que l'importation à partir d'un fichier, d'un dossier, d'un lien ou d'un
collage de test brut.
3. Runner: nous pouvons exécuter des tests d'automatisation à l'aide de Collection Runner.
4. Ouvrir nouveau: nous pouvons ouvrir la fenêtre Postman ou Runner
5. Mon espace de travail: c'est votre espace de travail. Vous pouvez créer un nouvel espace de
travail en utilisant ceci. Un espace de travail est un contexte partagé pour la création et la
consommation d'API. Il permet une collaboration en temps réel au sein et entre les équipes.
6. Inviter: c'est inviter les membres de votre équipe à collaborer sur un espace de travail.
7. Historique: sauvegarde automatique des demandes et des réponses dans l'historique qui vous
permet de suivre facilement vos actions passées.

COMMENT 8. Collections: Il s'agit d'organiser et de suivre les demandes connexes.

9. Onglet Demande: titre de la demande sur laquelle vous travaillez. Par défaut, il est nommé

UTILISER
«Demande sans titre».
10. Requête HTTP: Vous pouvez voir des requêtes comme GET, POST, COPY, DELETE, etc.
11. URL de requête: Ici, nous mentionnons le lien vers lequel l'API communiquera. Il est également

POSTMAN connu comme point de terminaison.

12. Enregistrer: pour enregistrer la demande ou mettre à jour la demande existante.
13. Paramètres: Nous mentionnons les paramètres (valeurs clés) nécessaires à une demande.
14. Autorisation: les API utilisent l'autorisation pour garantir que les demandes des clients accèdent
aux données en toute sécurité. Nous mentionnons ici les détails de l'autorisation comme le nom
d'utilisateur, le mot de passe, le jeton du porteur, etc.
15. En-têtes: certaines API nécessitent que vous envoyiez des en-têtes particuliers tels que JSON,
JavaScript, etc., ainsi que des demandes, généralement pour fournir des métadonnées
supplémentaires sur l'opération que vous effectuez. Vous pouvez les configurer ici
16. Corps: Il vous permet de spécifier les données que vous devez envoyer avec une
demande. Vous pouvez envoyer différents types de données corporelles en fonction de votre API.
17. Script de pré-demande: les scripts de pré-demande sont écrits en JavaScript et sont exécutés
avant l'envoi de la demande. C'est parfait pour les cas d'utilisation comme l'inclusion de
l'horodatage dans les en-têtes de demande ou l'envoi d'une chaîne alphanumérique aléatoire dans
les paramètres d'URL.
18. Tests: Les tests sont les scripts exécutés lors de la demande. Les tests vous permettent de vous
Zied HANNACHI 8
assurer que votre API fonctionne comme prévu, d'établir que les intégrations entre les services
fonctionnent de manière fiable et de vérifier que les nouveaux développements n'ont rompu
aucune fonctionnalité existante.
 BLOCS DE CONSTRUCTION DU POSTMAN

Avant de tester une API, nous verrons d'abord quelques blocs de construction de Postman
Tool qui sont essentiels pour toutes les opérations de Postman.

Requests
Zied HANNACHI COLLECTIONS ENVIRONNEMENT 9
 Requests
Click sur New – Request

• Requests est une combinaison de l'URL, des en-têtes HTTP, du

BLOCS DE corps ou de la charge utile. Dans l'outil Postman, vous pouvez
CONSTRUCTION DU
POSTMAN enregistrer vos demandes et les utiliser à l'avenir en fonction
de vos besoins.
Zied HANNACHI 10
 • Vous pouvez faire des request aux API dans Postman. Request

BLOCS DE CONSTRUCTION d'API vous permet de récupérer des données à partir d'une source
de données ou d'envoyer des données. Les API s'exécutent sur des
DU POSTMAN serveurs Web et exposent les points de terminaison pour prendre
en charge les opérations que les applications clientes utilisent
pour fournir leurs fonctionnalités.

Zied HANNACHI • Chaque Request d'API utilise une méthode HTTP. 11

 HTTP signifie Hyper Text Transfer Protocol. HTTP
permet la communication entre les clients et les
serveurs. Les clients sont souvent des
navigateurs Web et les serveurs sont souvent des
QU'EST-CE ordinateurs sur le cloud.

QUE HTTP?
Si un client soumet une demande HTTP au
serveur, le serveur renvoie une réponse au
client. La réponse envoyée par le serveur
contient des informations d'état sur la demande
et le contenu demandé.

Zied HANNACHI 12
 QU'EST-CE QUE HTTP?

Les méthodes HTTP les plus couramment utilisées sont les suivantes

GET: LA MÉTHODE GET POST: LA MÉTHODE POST PUT: LA MÉTHODE PUT EST PATCH: LA MÉTHODE DELETE: LA MÉTHODE
EST UTILISÉE POUR EST UTILISÉE POUR UTILISÉE POUR METTRE À PATCH EST UTILISÉE POUR DELETE EST UTILISÉE
RÉCUPÉRER LES DONNÉES ENVOYER DE NOUVELLES JOUR LES DONNÉES METTRE À JOUR LES POUR SUPPRIMER LES
D'UNE API. DONNÉES À UNE API EXISTANTES DONNÉES EXISTANTES DONNÉES EXISTANTES LES
DONNÉES.

Zied HANNACHI 13
 Collection
BLOCS DE • Les collections sont un groupe de demandes
CONSTRUCTION enregistrées que vous pouvez organiser en
DU POSTMAN dossiers. Nous pouvons l'appeler comme un
référentiel pour enregistrer nos demandes.

Zied HANNACHI 14
Saisissez le nom et la description de la collection, puis cliquez sur
Créer pour créer une nouvelle collection

Click sur New – Collection

COMMENT CRÉER DES Vous pouvez ajouter n'importe quel nombre de demandes dans une
collection. Vous pouvez exécuter des collections dans Postman de
COLLECTIONS DANS deux manières. 1. Utilisation de Collection Runner & 2. Utilisation
POSTMAN de Newman. Nous verrons l'exécution des collections à l'aide de
Collection runner et Newman avant de fermer ce post.
Zied HANNACHI 15
 Environnement
Les environnements dans Postman nous permettent
d'exécuter des demandes et des collectes sur
différents ensembles de données. Nous pourrions
avoir des environnements différents pour le
BLOCS DE développement, l'assurance qualité et la
CONSTRUCTION production. Chacun de ces environnements aura
DU POSTMAN différentes configurations telles que l'URL, l'ID et le mot
de passe du jeton, les clés API, etc. Les
environnements sont des paires clé-valeur de
variables. Chaque nom de variable représente sa
clé. Ainsi, chaque fois que nous référençons un nom de
variable, cela nous permet d'accéder à sa valeur
correspondante.
Zied HANNACHI 16
 Click sur New – Environment

BLOCS DE CONSTRUCTION DU POSTMAN

Zied HANNACHI 17
 ÉTAPE 1: CLIQUEZ SUR ÉTAPE 2: CRÉATION
UN NOUVEL ONGLET D'UNE DEMANDE GET
POUR CRÉER UNE POUR UN POINT DE
NOUVELLE DEMANDE. TERMINAISON D'API
REST

TEST GET
REQUESTS 1.Définissez votre requête HTTP sur GET
2.Saisissez le lien dans l' URL de
la demande (https://jsonplaceholder.typicode.com/users)
3.Cliquez sur ENVOYER pour exécuter la demande sur le serveur
hébergeant le point de terminaison
4.Vous pouvez voir le message 200 OK dans la capture d'écran ci-
dessous, car notre demande a réussi. Dans certains cas, les demandes
GET peuvent échouer en raison d'une URL de demande non valide ou
d'une authentification incorrecte.
Zied HANNACHI 18
 TEST GET REQUESTS

Temps de réponse: nous Taille de la réponse: nous

pouvons voir des composants pouvons voir les composants
individuels comme le temps de individuels comme la taille de
connexion, le temps de socket, la réponse réelle, la taille des
la recherche DNS, etc., en-têtes, etc.,

Cookies: nous pouvons

En-tête de réponse: Ici, nous
trouver des informations
pouvons trouver des
relatives à la session dans les
informations sur la demande
cookies qui ont été renvoyés
qui a été traitée.
par le serveur.

Zied HANNACHI 19
Temps de réponse Taille de la réponse Cookies En-tête de réponse

TEST GET REQUESTS

Zied HANNACHI 20
 Post requests sont utilisées pour effectuer la
manipulation de données en ajoutant des données
au point de terminaison. Maintenant, ajoutons un
utilisateur dans l'application. Pour ce faire, nous
devons envoyer des données à l'application. Nous
TEST POST utilisons la demande POST pour envoyer des
REQUESTS données. Dans la demande POST, nous envoyons
des données dans le corps de la demande et l'API
nous renvoie certaines données en réponse à la
demande POST qui valide la création de
l'utilisateur. Nous utilisons les mêmes données que
celles utilisées dans la demande GET pour ajouter
un nouvel utilisateur.

Zied HANNACHI 21
 Set Set votre HTTP request dans POST

TEST POST
Input Input le lien dans
request URL (https://jsonplaceholder.typicode.com/users) REQUESTS

Click Click sur Body Tab et select “Raw” radio button –

Select JSON – Copiez et collez un seul résultat utilisateur de la
on précédente requête get.

Zied HANNACHI 22
 Cliquez sur ENVOYER pour exécuter la demande sur le serveur hébergeant le point de
terminaison

TEST POST REQUESTS

Zied HANNACHI 23
 1.Vous pouvez voir 201 message créé dans la capture d'écran ci-
dessous, car notre demande a réussi.
2.Vous pouvez voir les données publiées dans le corps.

TEST POST REQUESTS

Zied HANNACHI 24
 • Définissez la requête HTTP sur GET et saisissez l’URL
COMMENT • Remplacez l'URL par un paramètre tel que {{url}} . L'URL de demande doit
PARAMÉTRER être {{url}} / utilisateurs .

LES REQUESTS • Maintenant, nous devons définir des variables d'environnement pour définir des
paramètres. Pour ce faire, cliquez sur l'icône en forme d'œil et cliquez sur modifier
pour définir la variable sur une variable d'environnement globale pour l'utiliser
dans toutes les collections

Zied HANNACHI 25
 • Dans variable, définissez le nom sur l'URL qui
COMMENT PARAMÉTRER est https://jsonplaceholder.typicode.com et
cliquez sur Enregistrer.
LES REQUESTS
• Revenez à GET request et cliquez sur envoyer.

Zied HANNACHI 26
 • Les tests Postman vous permettent de vous assurer
que votre API fonctionne comme prévu. Il s'agit
d'établir que les intégrations entre les services
COMMENT CRÉER
fonctionnent de manière fiable et de vérifier que
DES
les nouveaux développements n'ont rompu
TESTS POSTMAN
aucune fonctionnalité existante. Il vous aide à
vérifier les résultats tels que le statut réussi ou
échoué, la comparaison des résultats attendus,
etc.,

Zied HANNACHI 27
 • Accédez à la demande GET que nous avons créée
précédemment. et passez à l'onglet tests. Dans la section des
extraits, cliquez sur «Status code : le code est 200». Le script sera

COMMENT CRÉER DES

rempli automatiquement.

• Cliquez sur Envoyer. Le résultat sera affiché.

TESTS POSTMAN • Ajoutons un autre test. Dans ce test, nous comparons le résultat
attendu au résultat réel. Pour ce faire, cliquez sur «Corps de
réponse: vérification de la valeur JSON» dans la section d'extraits
de code.Vérifions si Leanne Graham a l'ID utilisateur 1.
Zied HANNACHI 28
 • Pour spécifier le nom du test exactement ce que nous voulons
tester, remplacez simplement «Votre nom de test» du code par
«Vérifiez si Leanne Graham a l'ID utilisateur 1». Remplacez
également jsonData.value par jsonData [0] .name. Pour obtenir le
COMMENT CRÉER DES chemin (il est là dans le corps du résultat GET
précédent). Puisque «Leanne Graham» est l'ID utilisateur 1,
TESTS POSTMAN jsonData est dans le premier résultat qui doit commencer par 0.
Pour obtenir le deuxième résultat, utilisez jsonData [1] et ainsi de
suite pour les résultats suivants.

• Cliquez sur envoyer.

Zied HANNACHI 29
COMMENT EXÉCUTER • Cliquez sur le bouton Runner qui se
COLLECTIONS AVEC trouve à côté du bouton Importer.
COLLECTION RUNNER • La page Collection Runner devrait
apparaître
Zied HANNACHI 30
 •1. Tous vos runs récents
•2. Si vous utilisez un environnement spécifique, vous devez
sélectionner cet environnement
•3. Vous devez définir le nombre en fonction du nombre de fois que
vous souhaitez le répéter
•4. Les tests sans délai peuvent provoquer des erreurs, alors réglez le
temps de retard
•5. Indiquez comment vous souhaitez enregistrer les réponses
•6. Sélectionnez votre fichier de données
•7. Pour exécuter la collection

COMMENT EXÉCUTER
COLLECTIONS AVEC • La page Collection Runner devrait
COLLECTION RUNNER apparaître

Zied HANNACHI 31
 • Vous pouvez ajouter une collection sélectionnée ici. Vous devez
sélectionner le sous-dossier en fonction de tous les sous-dossiers

COMMENT EXÉCUTER disponibles. Exécutez Postman Test Collection en définissant des

itérations sur 2, un délai de 2500 ms et cliquez sur le bouton

COLLECTIONS AVEC Exécuter Postman Test.

COLLECTION RUNNER • Vous pouvez voir l'état du test après l'exécution des tests. Ici, nous
avons ajouté les demandes GET et POST, mais nous n'avons pas
reçu de demandes POST.Vous voyez donc un message pour les
requêtes POST comme «Cette requête n'a pas de tests».
Zied HANNACHI 32
 Installez node.js en utilisant ce lien

COMMENT
EXÉCUTER Ouvrez la ligne de commande et entrez npm install -g newman

COLLECTIONS
AVEC Accédez à l'espace de travail Postman après l'installation de Newman. Dans
NEWMAN la zone des collections, cliquez sur les trois points et sélectionnez Exporter.

Choisissez Exporter la collection en tant que collection v2.1 (recommandé),

puis cliquez sur Exporter.

Sélectionnez l'emplacement souhaité, puis cliquez sur Enregistrer. Il est

conseillé de créer un dossier spécifique pour vos tests Postman. Une
collection doit maintenant être exportée vers votre répertoire local choisi.

Zied HANNACHI 33
 COMMENT EXÉCUTER COLLECTIONS AVEC
NEWMAN

Cliquez sur l'icône en forme d'œil à côté de la

liste déroulante d'environnement dans Global,
sélectionnez Télécharger au format
L'environnement doit maintenant être exporté
JSON. Sélectionnez l'emplacement souhaité,
dans le même répertoire local que Collection.
puis cliquez sur Enregistrer. Il est conseillé que
l'environnement soit dans le même dossier que
votre collection.

Exécutez votre collection à l'aide de cette

Revenez maintenant à la ligne de commande et
commande: newman run
modifiez le répertoire dans lequel vous avez
PostmanTestCollection.postman_collection.js
enregistré la collection et l'environnement.
on -e Testing.postman_globals.json

Zied HANNACHI 34
 COMMENT EXÉCUTER COLLECTIONS AVEC
NEWMAN

Zied HANNACHI 35
 CONCLUSION

• Dans ce didacticiel « Postman », nous avons couvert les sujets les plus
importants. J'espère que vous avez appris à installer postman et à créer une
requête simple et à vérifier le temps de réponse et d'autres détails et à
apprendre à exécuter des collections à l'aide de Collection Runner &
Newman. Dans le prochain article, nous aborderons les sujets avancés de
l'outil Postman.

Zied HANNACHI 36
 AUTEUR
• Zied Hannachi est un ingénieur d’automatisation de test Full Stack, il évolue aujourd’hui en
tant qu’Expert de Test. Il a ensuite enchaîné les missions et a pu ainsi se bâtir une solide
expérience qu'il continue à développer. Il a passé 8 ans à jouer avec l'automatisation dans
des projets gigantesques en France.
• Il est passionné par la conception des frameworks d'automatisation qui suivent les concepts
OOP et les design pattern. Pour l'automatisation, ces armes sont Selenium (Java, C #,
JavaScript, Python et Ruby), Appium, REST-Sharp, REST-Assured, Cucumber, Specflow, etc.
• Il se consacre aux formations de test manuel et automatique et accompagne les sociétés
dans l’audit, implémentation de stratégie de test et implémentation des framework
d’automatisation de test.

Zied HANNACHI 37
 Merci

Zied HANNACHI 38