12.11 Tester une requête POST

Une requête GET est facile à tester en entrant directement son URL dans un navigateur. Il est également possible d'utiliser la commande curl.

curl peut aussi tester une requête POST. Il faut alors lui fournir des options spécifiques.

Attention : sous Windows, il faut utiliser des guillemets alentour des données et échapper les guillemets alentour des clés et des valeurs JSON.

Un autre outil est très intéressant pour tester une requête POST est l'application Postman, un environnement de test pour API.

Postman est disponible :

• en application Web (https://identity.getpostman.com/signup)
• en application de bureau, aussi appelée desktop (https://www.postman.com)

Attention : le serveur HTTP doit être disponible sur Internet pour que la version Web de Postman puisse y envoyer des requêtes.

Si le serveur n'est disponible qu'à partir du réseau local, seule la version de bureau pourra être utilisée.

Pour tester une requête POST avec l'une ou l'autre des versions de Postman :

• Créez-vous un compte si ce n'est pas déjà fait.
• Rendez-vous dans Workspaces / My Workspace (ou Create Workspace).
• Cliquez sur le + pour ouvrir un onglet.
• Sélectionnez POST dans la liste déroulante des verbes HTTP.
• Entrez l'URL à tester.
• Dans l'onglet Body, sélectionnez Raw puis, complètement à droite, JSON.
• Entrez au format JSON les clés et valeurs à envoyer avec la requête.
• Vous remarquerez dans l'onglet Headers que l'application s'est chargée d'ajouter l'en-tête Content-Type: application/json.
• Cliquez sur Send.
• La réponse du serveur apparaîtra au bas de la fenêtre. Important : en plus des informations retournées par le serveur, on voit dans le coin inférieur droit le code d'état HTTP de la réponse.

Pour plus d'information

« How to Make API Requests with Postman or cURL ». Tania Rascia. https://www.taniarascia.com/making-api-requests-postman-curl/