Postman est un outil puissant pour tester et exécuter des API. Nous l'utilisons intensément chez EMnify et les articles de notre base de connaissances API sont principalement basés sur ce logiciel. Le but de cet article est de vous donner un aperçu des fonctionnalités les plus importantes offertes par Postman et les liens pour trouver plus amples informations sur son utilisation.

1. Envoyer une requête 

Lorsque vous avez installé le logiciel, vous pouvez directement essayer d’exécuter un API. 

Entrez la requête GET dans le champs "enter request URL": 

https://baconipsum.com/api/?type=meat-and-filler

Le verbe http par défaut est GET. Cliquez sur envoyer et vous devriez voir un texte "lorem ipsum" apparaître dans le corps. 

Vous avez exécuté votre première API. 

Voici une courte vidéo décrivant comment exécuter une API plus complexe. Cette vidéo décrit comment renseignez des informations dans le Header ou le Body (musique forte, couper le son de votre ordinateur): 

Pour exécuter les API EMnify décris ici , il vous faut entrer notre URL https://cdn.emnify.net/ suivi  de la requête API que vous souhaitez utiliser tel que /api/v1/authenticate.

2. Collections

Vous avez la possibilité de sauvegarder vos API dans des "collections" qui constitue "un groupe de requêtes API sauvegardées que vous pouvez organiser en dossier."

Cliquez sur "enregistrer" à côté du bouton "envoyer", donnez un nom et une description à votre requête. Avant d'enregistrer, vous devez l'ajouter à une collection. Cliquez sur "Créer une collection", donnez-lui un nom et enregistrez. Vous pouvez le voir apparaître sur la gauche. 

Vous pouvez ajouter plus de requêtes dans votre collection mais aussi les diviser en dossier pour les organiser au mieux. 

3. Environnements, globals et variables

La documentation Postman couvre ces notions clés de manière très claire, pour trouver davantage d'information, visitez le site internet de Postman.

Trois vidéos Postman sont pertinentes sur le sujet : 

4. Runner

La fonctionnalité "Runner" vous offre la possibilité d'exécuter un ensemble de requête API appartenant à une collection, l'un après les autres. Voici une vidéo expliquant comment utiliser le "Runner":

Pour tester ce que vous venez d'apprendre, vous pouvez suivre l'un de nos articles tel que : Comment utiliser un jeton d'application (token) pour l'authentification des API.