Mock Server avec Postman

💡 Sujet

Un serveur de mock permet de simuler le comportement d'une API avant même qu'elle ne soit développée. Postman facilite grandement cette étape en important directement un fichier openapi.yaml.

---

⚙️ La procédure

1️⃣ Importation

• Dans Postman, cliquez sur Import.
• Glissez-déposez votre fichier openapi.yaml.
• Choisissez l'option Postman Collection (ou API) lors de l'import.

2️⃣ Création du Mock Server

• Faites un clic droit sur la collection générée.
• Sélectionnez Mock collection.
• Donnez un nom à votre serveur de mock (ex: "Mock API V1").
• Postman vous fournira une URL de type https://xxxx.mock.pstmn.io.

3️⃣ Configuration des exemples

• Pour que le mock renvoie des données réalistes, chaque requête dans la collection doit avoir un Example.
• Postman utilise les exemples (responses dans OpenAPI) pour décider quoi renvoyer selon les paramètres reçus.

---

🛠️ Avantages

• Développement Parallèle : Le front-end peut commencer à travailler sans attendre le back-end.
• Tests Facilités : Simulez facilement des erreurs (404, 500) en créant des exemples spécifiques.
• Zéro Code : Aucun serveur à coder ou à déployer.

---

🧩 Résumé

• Import direct : Utilise les définitions OpenAPI existantes.
• URL Publique : Accessible immédiatement par toute l'équipe.
• Basé sur les exemples : La qualité du mock dépend de la précision des examples dans votre YAML.

---

🔗 Références

• Postman Mock Servers Documentation