De nos jours les API prolifèrent de plus en plus. Que l'on soit du côté utilisateur ou créateur de l'api avoir des outils simples pour pouvoir les tester, utiliser de manière manuelle, documenter etc. semble indispensables. Postman est l'un des outils pouvant vous apporter cela, venez découvrir l'outil ainsi que ses diverses utilisations. Slides de la présentation effectué le 13/10/2016 au dev/var Collection postman http://bit.ly/2eO6ge3

1. Postman
/dev/var#15 13/10/2016

2. Sommaire 1 Contexte
2 Requêtes
3 Tests api
4 Autres
fonctionnalités

3. Contexte

4. @kandran | 3 /dev/var#15
Présentation
Share
Run Test
Document

5. @kandran | 4 /dev/var#15
Versions
Logicielle • Application
chrome
• Application
chrome
bundle
• Native
Offre
• Gratuite
• Entreprise
• Cloud
(abonnement)

6. Requêtes

7. @kandran | 6 /dev/var#15
Requêtes simple
Verbe
Params
Response

8. @kandran | 7 /dev/var#15
Requêtes avancés : variables
Scopes :
• Environnement
• Globale
Variable préexistante :
• $randomInt
• $timestamp
• $guid
Utilisation
• Dans n’importe quel champs (url, params etc)
• Entre {}  exemple {event} pour la variable event

9. @kandran | 8 /dev/var#15
Requêtes avancés : pre-request script
Technique :
• En JavaScript
• Exécuté avant l’envoi de la request
• Utilisation de librairies possible
Fonctionnel :
• Permet de modifier des variables
• Gestion du workflow

10. @kandran | 9 /dev/var#15
Requêtes avancés : tests
• Similaire au pre-request script
• Lancé après chaque request
• Conversion xml -> json
• Parsing json
• Snippet de test (temps reponse, status code etc)
• Json data validator
• Ex : tests["Status code is 200"] = responseCode.code === 200;

11. Tests API

12. @kandran | 11 /dev/var#15
Tests : Runner
• Permet de lancer tout les tests d’une collection
• Choix de l’environnement dans l’interface
• Choix du nombre d’itération
• Manuel

13. @kandran | 12 /dev/var#15
Tests : Newman
• En cli (via npm)
• Même fonctionnalité que le test runner
automatisable et intégrable dans
un process d’intégration continue

14. Autres fonctionnalités

15. @kandran | 14 /dev/var#15
Capture du trafic
Interceptor :
• Nécessite un plugin sur chrome (postmanInterceptor)
• Permet de capturer le trafic http de chrome (cookies, url,
params etc)
• Utile pour pouvoir rejouer les appels (debug, crawl etc)
Proxy :
• Comme interceptor mais via un proxy
• Utilisable avec des terminaux mobiles

16. @kandran | 15 /dev/var#15
Partager et documenter
Possibilité de partager une collection via un lien
La documentation est en markdown, requête par
requête. On peux stocker les réponses.

17. @kandran | 16 /dev/var#15
Alternative
Quelques alternatives :
• Paw
• SoapUi
• HTTPie (cli)
• REST Client (plugin navigateur)
• HttpRequester (plugin navigateur)
• hurl.it (online)
• Et pleins d’autres

18. Merci pour votre écoute
Avez-vous des questions ?