Voyons d’abord ce que disent les auteurs de Postman eux-mêmes :
« Postman est un puissant ensemble d’outils de test d’API, devenus indispensables à bien des développeurs. Nous faisons d’excellents produits qui aident à bâtir des interfaces remarquables et à travailler plus efficacement. Postman est utilisé par plus d’un million de développeurs dans le monde, et ce nombre ne cesse de croître. Nous comptons développer d’autres produits afin d’offrir aux développeurs la solution la plus puissante pour créer et tester des API. »
La version actuelle de Postman est plus puissante encore que les anciennes, et nombre de fonctions Pro sont désormais gratuites. Mieux : cet outil n’a pas été conçu pour les seuls développeurs. Même l’essai des réponses automatiques ne demande pas de savoir particulier. C’est un outil très simple et pourtant puissant.
Envoyer une requête
Si vous ouvrez cet ensemble, allez dans « Request Methods », puis dans « GET Requests », toutes les données enregistrées apparaîtront au centre de la fenêtre de Postman. Cliquez maintenant sur « Submit ». Vous venez d’envoyer votre première requête et de recevoir votre première réponse.
Les requêtes POST sont un peu plus délicates, mais restent claires et logiques. Cette fois, vous utiliserez votre propre requête. Cliquez sur le signe plus pour ouvrir un nouvel onglet, changez le type de requête de GET en POST et indiquez https://jsonplaceholder.typicode.com/posts comme adresse de la requête. C’est un service REST gratuit que l’on peut utiliser avec des données fictives. Il est très utile pour apprendre, imiter le fonctionnement d’un serveur et diffuser des exemples de code.
Il vous faut maintenant le corps de la requête POST. Cliquez sur « Body » sous l’adresse, changez le type en « raw » et « Text » en « JSON ». Collez ensuite cette requête dans l’éditeur :
- {
- “title”: “My first POST request”,
- “body”: “Content of my first POST request!”,
- “userId”: 789
- }
Cliquez sur « send ». Vous devriez recevoir une réponse contenant votre texte, preuve que la requête a abouti. Enregistrez-la pour plus tard. Vous pouvez aussi créer une nouvelle collection : cliquez simplement sur « Save » à droite de l’adresse. Une fenêtre d’enregistrement s’ouvre, où vous pouvez donner un nom à votre requête et créer pour elle une nouvelle collection.
Les tests
Autre belle possibilité de Postman : les tests automatiques des requêtes. Dès que vous créez un test pour une requête, Postman éprouve chaque réponse reçue selon vos cas. Voyons un exemple simple.
Ajoutez une nouvelle requête pour obtenir le POST de https://jsonplaceholder.typicode.com/posts avec ID = 6 et ouvrez l’onglet « Tests ». À droite de la fenêtre de Postman s’affiche une liste de fragments. Elle vous aidera à écrire le premier test, le deuxième et tous les suivants, car ce code convient à tout : il suffit de l’ajuster un peu à vos besoins.
tests[“Status code is 200”] = responseCode.code === 200;
- var jsonData = JSON.parse(responseBody);
- tests[“User ID is 1”] = jsonData.userId === 1;
- tests[“Post ID is 6”] = jsonData.id === 6;
- tests[“Body matches string”] = responseBody.has(“dolorem eum magni eos aperiam quia”);
- Dans notre premier test, nous vérifierons si la réponse à notre requête renvoie le statut HTTP « 200 », si l’identifiant de l’utilisateur vaut 1 et celui du billet 6, et si le corps de la réponse contient le texte attendu.
Cliquez maintenant sur « Submit ». Une fois la réponse reçue, ouvrez l’onglet « Tests » et vérifiez s’ils sont tous passés.
Par cet article, nous voulions montrer combien il est simple et agréable de travailler avec Postman !