Outil Postman : Simplifier et remodeler les tests d'API

Publié: 2019-06-17

Aujourd'hui, les API (Application Programming Interfaces) sont partout sur Internet et jouent un rôle important dans notre économie. En tant qu'utilisateur final, nous utilisons des API au quotidien sans même nous en rendre compte. De la réservation d'un billet d'avion à la vérification de la météo. De la possibilité de vous connecter à vos comptes Google ou de réseaux sociaux à partir de n'importe quel site Web à la possibilité de choisir votre service de paiement préféré dans votre boutique de commerce électronique. Nous sommes entourés d'API et cela ne fait que créer un monde meilleur.

Bien que les API nous facilitent la vie, les développeurs ont leur part d'obstacles en termes de test avant de les utiliser sur des données en temps réel. Et c'est à ce moment-là que l'outil Postman a été introduit. L'outil Postman a pris d'assaut le monde des API depuis sa création et est utilisé par plus de 7 millions de développeurs dans le monde chaque mois ! Nous parlerons davantage de l'outil Postman, des tests d'API avec Postman, de l'automatisation des tests et plus encore dans cet article. Alors restez à l'écoute.

API_description

Création et test d'API

Bien qu'il existe plusieurs façons de créer une API, une API Web est généralement créée à l'aide du cadre REST (Representational State Transfer). Le cadre REST définit un ensemble de directives qui doivent être suivies lors de la création d'une API. Comme le principal motif de la création d'une API est de permettre à d'autres applications d'utiliser les services, chaque étape du processus de développement d'API nécessite des tests de fonctionnalité, de gestion des exceptions et de sécurité. C'est pourquoi suivre quelques conseils de conception d'API depuis le début du développement de votre API est essentiel pour minimiser les problèmes.

Facilitez les tests avec l'outil Postman

Qu'est-ce que l'outil Postman ? Comment ça marche?

L'outil Postman fait plus que simplement tester des API. À première vue, cela ressemble à une interface pour envoyer des requêtes HTTP et afficher les réponses. Mais au fond, Postman repose sur un ensemble complet d'outils puissants et très faciles à utiliser. L'outil Postman vous permet d'organiser vos demandes d'API dans des collections et des dossiers qui partagent des valeurs communes entre les demandes avec des variables d'environnement, des tests de script avec le runtime intégré basé sur node.js et de les automatiser avec Newman. Nous parlerons davantage de Newman, le gestionnaire de collection en ligne de commande pour Postman.


L'outil de test Postman est une plate-forme de développement d'API complète avec divers outils intégrés qui prennent en charge chaque étape du cycle de vie de l'API. L'outil Postman vous permet de concevoir, de simuler, de déboguer, de tester automatiquement, de documenter, de surveiller et de publier les API - tout à partir d'un seul endroit. Postman est accessible via des applications natives pour MacOS, Linux et Windows.

postman_description

La plate-forme complète de développement d'API de Postman vous permettra de créer des demandes, de créer et de gérer des collections et de régir le cycle de vie complet de vos API.

Évolution de l'outil Postman

L'outil Postman a commencé comme une application Postman Chrome à sa sortie, utilisée avec l'extension Postman Interceptor Chrome. L'extension Google Postman était largement acceptée et était l'un des outils de test les plus recherchés. Au fil des ans, l'écosystème des API a évolué et, grâce à cela, les capacités des applications natives Postman ont également été améliorées pour surpasser les performances de l'extension chrome postman.

Cependant, si vous utilisez toujours l'application Postman Google Chrome, vous remarquerez peut-être une bannière en haut indiquant "Les applications Chrome sont obsolètes. Téléchargez nos applications natives gratuites pour une assistance continue et de meilleures performances."

C'est quelque chose qui s'est produit lorsque Google a annoncé son intention de mettre fin à la prise en charge des applications Chrome pour les utilisateurs Windows, Mac et Linux. En réponse à la dépréciation de l'extension Postman Google Chrome, ils ont introduit des applications natives pour les utilisateurs Windows, Mac et Linux et ont encouragé leurs utilisateurs à commencer la migration. Les nouvelles applications natives Postman couvraient toutes les caractéristiques et fonctionnalités de l'extension chrome postman, et dans de nombreux cas, l'application native était encore meilleure que l'application Chrome d'origine.

applications natives

Avec l'application native Postman qui fonctionne mieux que l'application Postman Chrome, et le processus de migration étant facile (prend moins d'une minute !), il est temps de dire au revoir à l'extension Postman et de passer à leurs applications natives.

L'installation de l'application Postman est également simple. Vous devrez télécharger l'application postman sur https://www.getpostman.com/apps en fonction de votre système d'exploitation et suivre les instructions d'installation. Une fois installée, votre application postman est prête à commencer à accepter vos requêtes HTTP et à tester les API avec postman.

Pourquoi facteur ?

Suites de test - Créez-les facilement

Afin de garantir que votre API fonctionne comme prévu, l'outil Postman vous permet de créer des collections de tests d'intégration. Pour chacun de ces tests, exécutés dans un ordre précis, une requête HTTP est effectuée et les assertions écrites en JavaScript sont utilisées pour vérifier l'intégrité du code. Vous avez également la liberté de manipuler les données que vous recevez avec l'application Postman, grâce aux assertions écrites en JavaScript.

postman_screenshot

Tester sur différents environnements ? Aucun problème!

À quelle fréquence constatez-vous que, étant donné que votre environnement local est configuré un peu différemment du serveur de test, votre collection de tests qui s'exécute parfaitement sur votre environnement local rencontre des problèmes lorsque vous l'exécutez sur un autre. L'outil de test Postman vous permet de stocker certaines informations sur les différents environnements que vous utilisez et d'insérer automatiquement la configuration d'environnement correcte pour la collection de tests que vous exécutez.

postman_screenshot

Stockage de données

Vous pouvez avoir une API qui nécessite des données spécifiques reçues d'une autre API. L'outil Postman vous permet de stocker ces données de tests précédents dans des variables globales, et celles-ci peuvent être utilisées de la même manière que les variables d'environnement. Vous pouvez stocker la réponse ou une partie de la réponse et l'utiliser pour les appels d'API suivants.

Meilleure intégration

L'outil de test Postman possède une interface unique qui vous permet d'exécuter facilement une série de tests directement à partir de la ligne de commande. Newman, qui est la propre interface de ligne de commande (CLI) de Postman, permet d'exécuter ces tests sur des systèmes qui n'ont pas d'interface graphique. De plus, Newman vous donne la possibilité d'exécuter une collection de ces tests directement à partir de la plupart des outils de construction.

Newman - Intégration continue dans l'outil Postman

Newman est essentiellement un outil d'interface de ligne de commande qui vous permettra d'exécuter des collections Postman directement à partir de la ligne de commande. Leur site officiel décrit Newman comme - "Newman est un gestionnaire de collection en ligne de commande pour Postman. Newman vous permet d'exécuter des collections de la même manière qu'elles sont exécutées dans un gestionnaire de collection Postman". Puisque nous savons tous qu'une intégration continue nous aide à combiner différents codes et à exécuter différents tests en continu. Cette combinaison de tests et de code est généralement un succès grâce à l'intégration continue, qui dans Postman est effectuée par Newman.

Newman est conçu pour s'intégrer facilement à vos systèmes de build et à votre serveur d'intégration continue. Il permet aux développeurs d'obtenir un retour rapide sur les performances des API après des modifications de leur code. Avec l'aide de Newman, il est intégré à CI et après cela, si des modifications sont apportées, CI exécutera les collections de facteur avec Newman.