Comment tester des API REST dans VS Code

Par Sayaib SarkarMis à jour le 5 min de lecture

Sur cette page 7 sections

Réponse courte : installez une extension de client REST, ouvrez-la à côté de votre code et envoyez vos requêtes depuis là. Ce guide utilise le REST API Client gratuit de DevSnip Pro : sans compte, avec environnements, collections, import cURL et génération de code. Les habitudes décrites fonctionnent avec n’importe quel client.

Le REST API Client de DevSnip Pro dans VS Code : une requête GET avec une réponse JSON formatée, le statut, la durée et la taille

Passer de votre éditeur à un outil d’API séparé coûte plus qu’il n’y paraît : vous copiez une URL depuis le code, collez un token depuis un fichier .env, envoyez, puis recopiez le JSON pour écrire un type ou un test. Dans VS Code, le code, la requête et la réponse restent côte à côte.

1. Envoyer votre première requête

  1. Lancez DevSnip Pro: REST API Client depuis la palette de commandes (Ctrl/Cmd+Shift+P), ou cliquez dessus dans la barre latérale DevSnip Pro.
  2. Cliquez sur Send a sample request. Il envoie GET https://jsonplaceholder.typicode.com/todos/1, une API de test publique et gratuite.
  3. Le panneau de réponse affiche le statut, la durée et la taille, le JSON formaté avec recherche, ainsi que les en-têtes et les cookies.

Pour votre propre API, tapez l’URL et appuyez sur Enter. Si vous avez déjà la requête sous forme de commande cURL (outils de développement du navigateur : Copy as cURL), collez-la dans la barre d’URL : la méthode, les en-têtes et le corps sont importés.

2. Arrêter de coder en dur les hôtes et les tokens

Créez un environnement pour chaque cible, comme local et staging, avec des variables comme baseUrl et token. Écrivez ensuite les requêtes ainsi :

Code
GET {{baseUrl}}/users/42
Authorization: Bearer {{token}}

Changer d’environnement relance la même requête sur un autre serveur, et les secrets restent en dehors de la requête que vous enregistrez.

3. Enregistrer ce que vous relancerez

Enregistrez vos requêtes dans des collections, regroupées en dossiers qui reflètent votre API (auth/, users/, billing/). L’historique garde tout ce que vous avez envoyé, avec les valeurs d’URL qui ressemblent à des identifiants masquées. Les requêtes enregistrées deviennent une documentation vivante pour la prochaine personne qui rejoint le projet.

4. Tester les cas d’échec, pas seulement `200 OK`

Un 200 avec le mauvais corps reste un bug. Pour chaque endpoint que vous touchez, vérifiez :

  • La forme : les champs sont-ils présents, du type attendu et nommés de façon cohérente ?
  • Les entrées invalides : un champ obligatoire manquant ou un champ du mauvais type doit renvoyer un 4xx clair, pas un 500 avec une trace de pile.
  • L’authentification : un token expiré ou absent. JWT Decoder & Signer signe un token de test avec un exp passé.
  • Les ressources inexistantes : un 404 avec un message utile.
  • Les en-têtes : Content-Type, les en-têtes de cache et les en-têtes CORS si un navigateur doit l’appeler (CORS Builder & Debugger explique les erreurs CORS).
  • Le temps : un endpoint qui prend 900 ms en local ne sera pas plus rapide en production.

Une fois que vous avez vérifié trois fois le même champ, transformez-le en assertion qui s’exécute à chaque envoi, chaînez les requêtes (connexion → création → vérification), ou lancez un lot pour voir les percentiles de latence. Ces outils avancés se paient en points gagnés en utilisant l’extension ; il n’y a rien à acheter.

5. Transformer la requête en code et en types

Quand la requête fonctionne, générez le code correspondant en JavaScript (fetch ou Axios), Python, Go, Java ou C#, ou exportez-la en cURL pour un README ou un rapport de bug. Pour obtenir des types à partir de la réponse, ouvrez JSON to Types depuis la barre latérale Tools : TypeScript, Zod, Pydantic, Kotlin, Swift, Dart, Java, Go ou JSON Schema.

Vous partez d’une spécification ? OpenAPI / Swagger Toolkit la vérifie, liste chaque endpoint et génère des types TypeScript, un client fetch et des commandes cURL.

6. Vérifier la base de données et la sécurité avant la mise en production

En résumé

ÉtapePourquoi c’est important
EnvironnementsUne requête, plusieurs serveurs ; aucun secret dans les requêtes enregistrées
CollectionsDes vérifications reproductibles et un savoir partagé
Cas d’échecRepère les bugs de contrat et de gestion d’erreurs
Code et typesPlus de copie manuelle d’URL et de JSON
Analyse de sécuritéDes en-têtes mal configurés se corrigent à peu de frais avant la publication

Essayez-le dans votre propre éditeur

Gratuit, sans compte, en local. Pour VS Code 1.93+ et les IDE JetBrains sous Windows, macOS ou Linux.

code --install-extension sayaib.hue-console