Utiliser Postman pour concevoir une API

Rayed Benbrahim

Publié le 22 juin 2020

Lorsque vous débutez dans le développement backend, particulièrement si vous travaillez sur une API, l'outil essentiel pour vous aider dans votre développement s'appelle Postman.

A quoi sert Postman

Disponible sur Linux, MacOS et PC, Postman sert à effectuer des requêtes HTTP que vous pourriez difficilement faire via votre navigateur ou via des requêtes curL. L'avantage est de pouvoir avoir une interface graphique pour manipuler votre API.

Exemple d'une requête postman

Exemple d'une requête SOAP via Postman

Faire des requêtes POST, PUT, PATCH et DELETE

Lorsque vous développez un serveur et ses différents comportements, vous allez avoir besoin de tester ses fonctionnalités assez tôt dans le développement. Pour ne pas avoir à dépendre du développement du frontend avant de pouvoir tester les comportements de votre serveur, Postman vous permet de faire les requêtes directement via son interface.

Là où un navigateur simple vous permet de faire des requêtes GET directement dans la barre d'URL, Postman permet d'avoir une interface graphique pour manipuler les différents query parameters, HTTP methods, request headers et request body afin de tester votre serveur avant même d'avoir développé le client.

Au fur et à mesure que votre API se complexifie, vous allez avoir des cas d'usage qui nécessitent plusieurs appels.

Grâce à Postman et l'utilisation de ses collections, vous pourrez lancer vos appels de manière séquentielle et utiliser la réponse des appels précédents dans les appels suivants, le tout sans avoir à copier/coller les données.

Effectuer des tests automatisés

Non seulement Postman permet d'effectuer des requêtes séquentielles, mais il permet également de les évaluer. Grâce à sa librairie de test et sa syntaxe JavaScript, vous pourrez évaluer le résultat d'une requête pour vous assurer de sa réponse. Par exemple dans une requête PUT, vous pourrez vérifier que à une étape donnée de la séquence, le statut de la réponse est bien 200 et que le body contient bien l'élément modifié.

Description de l'interface postman

Postman offre la possibilité de tester ses requêtes et d'avoir un rapport à l'issu de chaque lancement de tests

Il est également compatible avec la librairie Newman qui permet de lancer cette suite de test directement en ligne de commande et de l'intégrer dans un pipeline d'intégration continu DevOps.

Débuter avec Postman

Installer Postman

Quel que soit votre système d'exploitation, rendez-vous sur le site de postman pour télécharger le fichier d'installation.

Si vous aviez déjà installé l'extension sur votre navigateur, prenez le temps de la supprimer. Ce client a été déprécié par l'équipe core pour se concentrer sur son client natif.

Executer ses premières requêtes

Une fois le client installé, assurez-vous d'avoir lancé votre serveur, en local ou un serveur en ligne puis saisissez l'endpoint que vous voulez tester dans l'URL.

Exemple d'une requête SOAP avec Postman

Exemple d'une requête SOAP avec Postman

Vous pourrez choisir la méthode HTTP, définir les headers et le body.

Aller plus loin avec Postman:

Derniers articles

Le dernier né des bases de données AWS, MemoryDB for Redis allie la souplesse et rapidité de Redis avec une sauvegarde résiliente, chose qui aujourd'hui n'existait que pour la solution Redis Entreprise. Avec MemoryDB for Redis, AWS entend bien prendre une part du gâteau de Redis Labs.

MongoDB a mis en service la version 5.0 de sa base de données NoSQL. Dans cet article, découvrez les nouveautés qu'apporte cette release ainsi que leurs explications.

Dans l'univers du Big Data et du Cloud, Snowflake a vu le jour en étant le premier fournisseur d'un Data Warehouse sur le cloud 100% scalable. Dans cet article, découvrez ce qu'est un Data Warehouse et en quoi Snowflake est une solution innovante pour les entreprises.

Souvent portée par une équipe d'analystes, la QA vient supporter l'équipe tech pour assurer que les évolutions en cours de développement et récemment déployés ne viennent pas perturber l'application. Dans cet article, découvrez comment les méthodes Shift-Left et Shift-Right viennent se complémenter pour assurer un bon niveau de qualité du logiciel déployé.

Docker Desktop est le client permettant de faire tourner des containers depuis son poste. Découvre ce tutoriel pour installer Docker sur ton Mac et faire tourner tes premiers containers.

Docker Desktop est le client permettant de faire tourner des containers depuis son poste. Découvre ce tutoriel pour installer Docker sur ton PC Windows et faire tourner tes premiers containers.

Les Jobs