Tester une API avec Postman, Thunder Client et les fichiers .http

Pourquoi un outil de test ?

Taper une adresse dans le navigateur envoie toujours une requête GET. Pour créer (POST), modifier (PATCH) ou supprimer (DELETE), envoyer un corps JSON ou un jeton d'authentification, il faut un client d'API.

Quel que soit l'outil, on envoie une requête et on analyse la réponse.

Pour les exemples, générez une ressource dans votre projet : nest g res groupes (REST API, CRUD : oui), puis lancez npm run start:dev.

1. Postman

Postman est l'application de référence pour tester des API (postman.com).

1. Cliquez sur New → HTTP.
2. Choisissez la méthode POST et l'adresse http://localhost:3000/groupes.
3. Onglet Body → raw → JSON, saisissez { "code": "DEV101", "filiere": "Développement" }.
4. Cliquez sur Send et lisez la réponse : statut 201 Created, corps, durée.
5. Enregistrez la requête dans une collection « API stagiaires » pour la réutiliser.

Postman permet aussi de définir des variables d'environnement (par exemple {{baseUrl}}) pour passer facilement du serveur local au serveur de production.

2. Thunder Client (dans VS Code)

Thunder Client offre le même principe directement dans VS Code : icône éclair dans la barre latérale → New Request. Méthode, URL, onglet Body → JSON, puis Send. Pratique pour ne pas quitter l'éditeur ; certaines fonctions avancées sont réservées à la version payante.

3. Les fichiers .http (extension REST Client)

Avec l'extension REST Client, les requêtes sont écrites dans un simple fichier texte .http. Gros avantage : ce fichier est versionné avec le projet sur GitHub, l'équipe et l'enseignant peuvent rejouer les mêmes tests.

### Variables
@baseUrl = http://localhost:3000

### Lister les groupes
GET {{baseUrl}}/groupes

### Afficher le groupe 1
GET {{baseUrl}}/groupes/1

### Créer un groupe
POST {{baseUrl}}/groupes
Content-Type: application/json

{
  "code": "DEV101",
  "filiere": "Développement"
}

### Modifier le groupe 1
PATCH {{baseUrl}}/groupes/1
Content-Type: application/json

{
  "filiere": "Développement web et mobile"
}

### Supprimer le groupe 1
DELETE {{baseUrl}}/groupes/1

Au-dessus de chaque requête apparaît un lien Send Request: un clic, et la réponse s'affiche dans un panneau à droite. Les requêtes sont séparées par ###; une ligne vide sépare les en-têtes du corps.

4. curl (terminal)

curl http://localhost:3000/groupes
curl -X POST http://localhost:3000/groupes \
     -H "Content-Type: application/json" \
     -d '{"code":"DEV101","filiere":"Développement"}'
curl -i http://localhost:3000/groupes/1      # -i affiche aussi le statut et les en-têtes

Lire une réponse

• Statut: 200, 201, 400, 404… (leçon 1.2).
• En-têtes: Content-Type, X-Powered-By: Express (preuve que NestJS tourne sur Express !).
• Corps: les données JSON, ou le message d'erreur.
• Durée: utile pour repérer une route lente.

Activités

{
  "message": "Cannot GET /inconnu",
  "error": "Not Found",
  "statusCode": 404
}