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
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;
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
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.