Le fonctionnement de Postman se résume le plus souvent à formuler une requête en suivant la structure spécifique (Verbe http + URI + Version http + Headers + Body) puis à obtenir une réponse.
Comment écrire un test avec Postman
Dans l'interface, Postman propose l'onglet « Tests ». On peut s'en servir pour définir des variables Postman à l'issue d'une requête et pour effectuer des assertions dessus. Dans cet onglet, vous pourrez écrire votre code de test API.
L'API crée un langage universel pour faire communiquer le client et le serveur. On parle d'intégration ou de systèmes intégrés lorsque plusieurs systèmes sont reliés par une API. Ce type de système est interopérable et permet aux différentes applications d'échanger entre elles.
Pour tester notre API nous pouvons dans un premier temps utiliser l'extension Postman de Chrome ou l'extension RESTClient pour Firefox. Si on veut une solution en ligne de commande, curl permet de manipuler les différentes méthodes HTTP.
Un Endpoint est ce qu'on appelle une extrémité d'un canal de communication. Autrement dit, lorsqu'une API interagit avec un autre système, les points de contact de cette communication sont considérés comme des Endpoints. Ainsi, pour les API, un Endpoint peut inclure une URL d'un serveur ou d'un service.
Les différents verbes HTTP permettent d'interagir avec les ressources. GET est utilisé pour obtenir des informations, POST pour créer une nouvelle ressource, PUT pour mettre à jour des informations pour une ressource qui existe déjà et DELETE permet de supprimer une ressource.
Une API, ou interface de programmation d'application, est un ensemble de définitions et de protocoles qui facilite la création et l'intégration de logiciels d'applications.
Aujourd'hui, il existe trois grandes catégories de protocoles ou d'architectures API : REST, RPC et SOAP.
APIs et Web Services servent de “moyen de communication” entre plusieurs sites ou applications. La seule différence est qu'un service Web facilite l'interaction entre deux machines sur un réseau alors qu'une API sert d'interface entre deux applications différentes afin qu'elles puissent communiquer entre elles.
Tandis que les tests unitaires vérifient une partie précise d'une application, les tests d'intégration, également élaborés par l'ingénieur en développement, analysent le fonctionnement global de celle-ci. Plus précisément encore, les tests d'intégrations incluent dans leur champ d'action les composants externes.
Postman est une application pour faire des requêtes HTTP, et les collections Postman vous aident à organiser et à regrouper les demandes d'API liées.
REST (representational state transfer) est un style d'architecture logicielle définissant un ensemble de contraintes à utiliser pour créer des services web. Les services web conformes au style d'architecture REST, aussi appelés services web RESTful, établissent une interopérabilité entre les ordinateurs sur Internet.
Postman prend en charge les demandes adressées aux services Web Restful, SOAP et GraphQL. Une interface graphique fait de Postman un outil facile à utiliser dans le processus de test et de développement d'API.
REST est un ensemble de recommandations qui permet une mise en œuvre flexible, tandis que SOAP est un protocole avec des exigences spécifiques comme l'envoi de messages au format XML.
HTTP est généralement le protocole de communication le plus utilisé. Les Web services utilisent également SOAP, REST et XML-RPC comme moyen de communication. L'API peut utiliser n'importe quel moyen de communication pour initier une interaction entre les applications.
Une API, pour Application programming interface, est un programme permettant à deux applications distinctes de communiquer entre elles et d'échanger des données. Cela évite notamment de recréer et redévelopper entièrement une application pour y ajouter ses informations.
Il y a plusieurs avantages à utiliser Swagger, les principaux étant : La génération automatique de la documentation à partir du code. Tout changement dans le code met à jour automatiquement la documentation; les deux sont donc étroitement liés. Gain de temps et donc de qualité.
Les API sont des mécanismes qui permettent à deux composants logiciels de communiquer entre eux à l'aide d'un ensemble de définitions et de protocoles. Par exemple, le système logiciel du bureau météorologique contient les données météorologiques quotidiennes.
Si les deux logiciels ne partagent pas la même technologie, ils ne peuvent strictement rien échanger. C'est comme faire rentrer un carré dans un rond. Il faut donc un intermédiaire « parlant » le rond d'un côté et le carré de l'autre. Cet intermédiaire est souvent nommé médiateur ou connecteur ou encore middleware.
Comme toutes les API, REST permet de déplacer des données entre utilisateurs et applications. Par exemple, lorsque vous vous connectez à un site web ou accédez à une application sur votre téléphone, une API aide votre client à communiquer avec le serveur hôte.
Le modèle d'API ouverte et publique permet à tout le monde d'accéder à l'API et de la consommer. Le modèle le plus courant est celui des API de médias sociaux, fournies par exemple par Facebook et Twitter. Les API publiques sont réglementées par le nombre d'appels qui peuvent être effectués.
Pour effectuer des requêtes, il faut simplement appeler la méthode "get()" de la classe "HttpClient". On déclare le type de données attendu par la requête entre chevrons. Le paramètre de la méthode est l'URL de l'API avec laquelle on communique.
Conception et prototype. Commencez à concevoir votre API en créant un premier prototype que vous pourrez affiner par la suite. Toutes les API doivent répondre à des exigences de base en matière de fiabilité, de sécurité et d'évolutivité. Une fois le prototype créé, vous pourrez commencer à construire votre API.