🔗 REST Client

REST Client est une extension VS Code qui permet d'exécuter des requêtes HTTP dans des fichiers .http ou .rest, directement depuis l'éditeur.

REST Client est une extension VS Code : elle exécute des requêtes HTTP depuis des fichiers .http ou .rest, sans quitter l'éditeur.

🛠️ Installation

REST Client est une extension VS Code (éditeur : Huachao Mao). Installez-la depuis le Marketplace :

Ouvrez le panneau Extensions (Ctrl + Shift + X).
Recherchez REST Client.
Cliquez sur Installer.

Ou en ligne de commande :

code --install-extension humao.rest-client

🟩 Utilisation

L'extension s'utilise dans des fichiers .http ou .rest.

🧪 Exemple de fichier `.http`

@baseUrl = http://localhost:3000

### Lister les tâches
GET {{baseUrl}}/tasks
Accept: application/json

### Créer une tâche
POST {{baseUrl}}/tasks
Content-Type: application/json

{
  "title": "Configurer ESLint",
  "done": false
}

🧪 Variables d'environnement

Vous pouvez isoler l'URL d'API, un token ou un identifiant dans des variables :

@baseUrl = https://api.example.com
@token = ******

### Détail utilisateur
GET {{baseUrl}}/users/42
Authorization: {{token}}

Cette page parle uniquement de l'extension VS Code REST Client. Ce n'est pas un package Node.js à importer avec require() ou import.

🟩 Fonctionnalités principales

Support des méthodes HTTP (GET, POST, PUT, DELETE, etc.).
Gestion des en-têtes personnalisés.
Support des paramètres de requête.
Gestion des cookies.
Variables d'environnement et réutilisation d'extraits.
Séparateurs ### pour organiser plusieurs requêtes dans un même fichier.

🧪 Bonnes pratiques

Utilisez des variables pour les valeurs sensibles.
Organisez vos requêtes par domaine (auth.http, tasks.http, users.http).
Ajoutez un commentaire court avant chaque requête si son but n'est pas évident.
Versionnez vos fichiers .http quand ils servent aussi de documentation d'API.

🟩 Dépannage

Si vous rencontrez des problèmes :

Vérifiez que l'API est accessible.
Assurez-vous que l'URL et les en-têtes sont corrects.
Testez la requête avec ou sans variable pour isoler l'erreur.
Consultez la réponse affichée par l'extension pour voir le statut HTTP et le corps retourné.

Tooling

Terminez le quiz du chapitre pour le marquer comme complété.

Tableau de bord