Postman : fonctionnalités, HTTP et collections

Ce blog est dans la continuité du blog précédent « Premiers pas avec Postman. Il donne plus d’informations sur l’interface et les fonctionnalités de base de Postman, ce qui aiderait un nouvel utilisateur à démarrer avec Postman. Je recommanderais fortement de lire le blog précédent, puis de parcourir celui-ci pour une meilleure compréhension

Protocole HTTP

HTTP (HyperText Transfer Protocol) est un protocole de transmission d’informations sur Internet. C’est un protocole client-serveur, ce qui signifie que les requêtes sont initiées par le client et envoyées au serveur, qui renvoie ensuite une réponse. HTTP est largement utilisé pour les communications Web et est également couramment utilisé pour les API (interfaces de programmation d’applications) comme moyen d’échanger des données entre les applications.

Dans le contexte des API, HTTP est utilisé pour envoyer des requêtes à un point de terminaison d’API et recevoir une réponse en retour. Le client (par exemple, une application Web ou une application mobile) envoie une requête au serveur, qui renvoie ensuite une réponse sous forme de données, telles que JSON ou XML. HTTP fournit un ensemble de méthodes standard, telles que GET, POST, PUT et DELETE, qui sont utilisées pour spécifier le type d’action que le client souhaite effectuer sur la ressource identifiée par le point de terminaison de l’API. Il s’agit d’un protocole fondamental pour le développement d’API et est essentiel pour permettre la communication entre différentes applications sur Internet.

Si nous essayons de comprendre à l’aide de l’exemple du magasin de location d’outils, le facteur a envoyé une demande au serveur du magasin de location car il demande des données. Le serveur a reçu la requête, a compris ce que nous voulions et a renvoyé un autre message que nous appelons la réponse. Pour rendre cette communication possible, nous avons utilisé HTTP qui est un protocole de communication. Le protocole n’est rien d’autre qu’un ensemble de règles que les deux parties doivent généralement suivre. La plupart des API utilisent le protocole HTTP. Pour pouvoir lire n’importe quelle documentation API, il est essentiel de comprendre certaines bases de HTTP

Figure 1 : HTTP

On peut voir https au début de l’adresse qui indique HTTP secure. HTTP sécurisé garantit que toutes les données que nous envoyons sont cryptées.

Demande et réponse

Une requête est un message envoyé par le client au serveur, lui demandant d’effectuer une action spécifique ou de renvoyer des informations spécifiques. La demande contient des informations telles que la ressource souhaitée, le type d’action à effectuer (par exemple, GET, POST, PUT, etc.) et tous les paramètres ou données nécessaires.

Une réponse est le message renvoyé par le serveur au client en réponse à une requête. La réponse contient des informations telles que le code d’état indiquant le succès ou l’échec de la demande, les données demandées par le client ou tout message d’erreur si la demande a échoué.

Ensemble, une demande et une réponse forment une transaction complète entre le client et le serveur dans laquelle le client fait une demande et le serveur renvoie une réponse. Ce processus est répété pour chaque demande et réponse ultérieure dans la communication entre le client et le serveur.

Comprenons ce qu’une requête et une réponse contiennent

Figure 2 : Requête et réponse

Dans Postman, nous pouvons sélectionner différentes méthodes de demande dans cette liste déroulante. Par défaut, GET est sélectionné

Figure 3 : Méthodes de demande

Une fois que nous envoyons la demande, voici l’interface de la façon dont nous pouvons voir. Dans la partie supérieure de l’écran marquée en rouge, nous pouvons configurer la demande et la partie inférieure de l’écran marquée en vert est l’endroit où nous pouvons voir la réponse

Figure 4 : Collectes

Dans la fenêtre inférieure de la réponse, nous pouvons voir status . Comme sur la capture d’écran, nous pouvons voir « 200 ok » qui indique que le serveur a compris notre demande et a pu répondre avec succès à ce que nous voulions

Collecte du facteur

Les collections Postman sont un moyen d’organiser et de regrouper les demandes d’API associées dans Postman. Ils vous permettent d’enregistrer, d’organiser et de réutiliser vos requêtes API selon vos besoins. Une collection peut contenir une ou plusieurs demandes d’API, et chaque demande peut avoir son propre ensemble unique de paramètres, d’en-têtes et d’autres propriétés. Avec les collections, vous pouvez facilement gérer et organiser vos demandes d’API pour une productivité accrue, ce qui facilite le suivi de votre travail et le partage de vos demandes d’API avec d’autres. De plus, les collections peuvent être exportées et importées entre différentes instances de Postman, ce qui facilite le partage de votre travail avec d’autres et la collaboration sur des projets de développement d’API.

Comment enregistrer une demande de facteur

L’idée la plus importante lorsqu’il s’agit de postman et d’une collection de requêtes est que nous ne pouvons pas stocker une requête en tant qu’instance dans postman ; à la place, nous devons l’ajouter à la collection. Une collection n’est rien de plus qu’un dossier utilisé pour contenir des demandes qui sont connectées à une API ou à une autre d’une manière ou d’une autre.

De cette façon, nous pouvons créer une collection

Conclusion

J’espère que les passionnés qui sont prêts à démarrer Postman ont été aidés par cette lecture rapide. Les idées fondamentales derrière HTTP, Request and Response, Collections et d’autres termes connexes ont été clarifiées grâce à ce blog, qui a aidé les utilisateurs à s’adapter correctement à l’interface.