Tutoriel Postman

Introduction à Postman

Postman est un outil populaire pour tester les API, qui simplifie le développement et les tests des API. Il offre une interface conviviale pour envoyer des requêtes, recevoir des réponses et automatiser les tests d'API.

Fonctionnalités de Postman

Créer et exécuter des requêtes API (GET, POST, PUT, DELETE, etc.)
Valider les réponses et les en-têtes
Prise en charge des mécanismes d'authentification (OAuth, Authentification basique, etc.)
Tests automatisés à l'aide de scripts de test
Gestion des environnements et des variables

Installation

Suivez ces étapes pour installer Postman :

Téléchargez Postman depuis le site officiel : Téléchargements Postman.
Installez l'application sur votre système d'exploitation (Windows, macOS ou Linux).
Inscrivez-vous ou connectez-vous pour commencer à utiliser Postman.

Premiers Pas

Étape 1 : Créer une nouvelle requête

Pour créer une nouvelle requête :

Ouvrez Postman et cliquez sur Nouvelle Requête.
Sélectionnez le type de requête (ex. : GET, POST).
Entrez le point de terminaison API dans le champ URL.
Cliquez sur Envoyer pour exécuter la requête.

Étape 2 : Ajouter des paramètres

Vous pouvez ajouter des paramètres de requête ou des données dans le corps de la requête :

Paramètres de requête : Ajoutez-les dans l’onglet Paramètres.
Corps de la requête : Utilisez l’onglet Corps et sélectionnez le format approprié (ex. : JSON, form-data).

Exemple : Requête GET

GET https://jsonplaceholder.typicode.com/posts/1
En-têtes : Aucun
Réponse :
{
  "userId": 1,
  "id": 1,
  "title": "Exemple de Post",
  "body": "Ceci est un exemple de requête GET."
}

Tests Automatisés avec Postman

Postman vous permet d’écrire des scripts de test pour valider les réponses des API.

Exemple : Écriture d’un test

Utilisez l’onglet Tests pour ajouter des scripts de test basés sur JavaScript :

pm.test("Le code de statut est 200", function () {
    pm.response.to.have.status(200);
});

pm.test("La réponse contient le titre", function () {
    pm.expect(pm.response.json()).to.have.property("title");
});

Utilisation des Environnements et Variables dans Postman

Postman prend en charge l’utilisation des environnements pour gérer plusieurs configurations (ex. : dev, staging, prod).

Étapes pour Créer un Environnement

Cliquez sur Environnement dans le coin supérieur droit.
Ajoutez des variables comme {{baseUrl}} ou {{apiKey}}.
Utilisez ces variables dans vos requêtes.

Exemple

URL de base : https://jsonplaceholder.typicode.com
Requête : {{baseUrl}}/posts/1

Exécution des Collections

Les collections dans Postman vous permettent de regrouper des requêtes liées et de les exécuter séquentiellement ou en parallèle.

Étapes pour Créer une Collection

Cliquez sur Nouvelle Collection.
Ajoutez des requêtes à la collection.
Utilisez le Runner pour exécuter l’ensemble de la collection.

Fonctionnalités Avancées

Simulation d'API

Créez des serveurs fictifs pour simuler les réponses d’API pendant le développement.

Intégration avec CI/CD

Exportez votre collection et exécutez-la en utilisant Newman, un outil en ligne de commande pour Postman.

$ newman run collection.json

Bonnes Pratiques

Utilisez des variables pour gérer les données dynamiques.
Regroupez les requêtes dans des collections pour une meilleure organisation.
Rédigez des tests complets pour chaque requête.
Intégrez Postman aux pipelines CI/CD pour des tests automatisés d'API.