Formation Postman : tester et automatiser les API REST

– Architecture REST : principes fondamentaux, ressources, endpoints et structure des URLs
– Méthodes HTTP : rôle et usage de GET, POST, PUT, DELETE et PATCH dans les opérations CRUD
– Codes de statut HTTP : interprétation des réponses (2xx, 3xx, 4xx, 5xx) pour diagnostiquer le comportement d’une API
– Format JSON : structure des données échangées entre client et serveur
– Documentation OpenAPI/Swagger : lire et interpréter une spécification pour en déduire les requêtes à construire

**Exemples d’activités pratiques :**
– Explorer une API publique à partir de sa documentation Swagger et identifier les endpoints disponibles

– Interface Postman : navigation dans les principaux panneaux (sidebar, request builder, response viewer, console)
– Installation et configuration : Postman Desktop et accès via l’application web
– Première requête : envoi d’un GET sur une API publique, lecture et interprétation de la réponse
– Collections : création, organisation en dossiers et bonnes pratiques de nommage
– Workspaces : structuration de l’espace de travail pour un projet d’API

**Exemples d’activités pratiques :**
– Installer Postman et envoyer une première requête GET sur une API de test
– Créer une collection organisée à partir d’une documentation Swagger

– Requêtes CRUD complètes : création de requêtes GET, POST, PUT, DELETE et PATCH sur une API REST
– Paramètres de requête : query parameters, path parameters et headers personnalisés
– Corps de requête : transmission de données en JSON, form-data et autres formats
– Authentification : configuration des modes API Key, Bearer Token et Basic Auth selon le contexte de l’API
– Import de requêtes : récupération de requêtes depuis un navigateur ou un fichier de collection

**Exemples d’activités pratiques :**
– Construire une collection CRUD complète (création, lecture, mise à jour, suppression) sur une API de gestion de ressources
– Configurer l’authentification Bearer Token pour accéder à une API sécurisée

– Variables d’environnement : isoler les configurations spécifiques à chaque contexte (dev, recette, production)
– Variables de collection et variables globales : portée et priorité de résolution des différents scopes
– Données dynamiques : générer des valeurs aléatoires et horodatées avec les variables intégrées de Postman
– Variabilisation des requêtes : remplacer les valeurs en dur par des références de variables pour rendre les collections portables

**Exemples d’activités pratiques :**
– Variabiliser une collection existante pour basculer entre un environnement de développement et un environnement de recette
– Utiliser des variables dynamiques pour générer des données de test uniques à chaque exécution

– Scripts Pre-request : préparer le contexte d’une requête (génération de tokens, calcul de signatures, initialisation de variables)
– Scripts de test : écrire des assertions avec pm.test et pm.expect pour valider les réponses (status code, body, headers, temps de réponse)
– Snippets : accélérer l’écriture des tests avec les modèles prédéfinis de Postman
– Chaînage de requêtes : extraire des données d’une réponse pour les injecter dans les requêtes suivantes
– Débogage : utiliser la console Postman pour inspecter les requêtes, réponses et variables en cours d’exécution

**Exemples d’activités pratiques :**
– Écrire une suite de tests validant le status code, la structure du body JSON et le temps de réponse d’une API
– Chaîner une requête d’authentification avec une requête métier en extrayant automatiquement le token de la réponse

– Collection Runner : exécuter une collection complète depuis Postman avec gestion des itérations et des données externes
– Newman : installer et configurer l’outil en ligne de commande pour exécuter les collections hors de l’interface graphique
– Rapports HTML : générer des rapports d’exécution lisibles avec newman-reporter-htmlextra
– Pipeline CI/CD : intégrer l’exécution des tests dans un workflow GitHub Actions pour automatiser les validations à chaque commit
– Analyse des résultats : interpréter les rapports et diagnostiquer les échecs dans un contexte d’intégration continue

**Exemples d’activités pratiques :**
– Exporter une collection et l’exécuter en ligne de commande avec Newman, puis consulter le rapport HTML généré
– Configurer un workflow GitHub Actions qui exécute automatiquement la collection de tests à chaque push