Démarrage rapide (5 minutes)
Objectif : partir d’une installation neuve et arriver à une requête authentifiée dont l’URL et le jeton viennent de variables. Comptez cinq minutes.
1. Créer un projet
Section titled “1. Créer un projet”Fichier ▸ Nouveau (Ctrl+N), puis Fichier ▸ Enregistrer sous
(Ctrl+Shift+S) pour lui donner un nom, par exemple demo.restorm.
Un projet est un simple fichier sur votre disque. Vous pouvez le poser dans un dépôt git dès maintenant — Restorm est fait pour ça.
2. Créer un dossier de variables
Section titled “2. Créer un dossier de variables”Clic droit dans l’arbre latéral ▸ Ajouter ▸ Dossier de variables.
Un dossier de variables (ou dossier d’environnement) est le conteneur qui
porte vos environnements — local, recette, production — et donc vos
{{variables}}. Toutes les requêtes qu’il contient héritent de
l’environnement sélectionné.
Ouvrez-le, créez un environnement local et ajoutez-y une variable :
| Clé | Type | Valeur |
|---|---|---|
baseUrl | Chaîne | https://api.exemple.test |
3. Créer et envoyer une requête
Section titled “3. Créer et envoyer une requête”Clic droit sur le dossier ▸ Ajouter ▸ Requête HTTP. Dans l’onglet qui s’ouvre :
- laissez la méthode sur
GET; - saisissez l’URL
{{baseUrl}}/health— la valeur résolue s’affiche sous le champ, c’est votre filet de sécurité ; - cliquez sur Send.
La réponse s’ouvre en dessous : statut, temps, taille, en-têtes, et le corps rendu dans une visionneuse JSON repliable.
4. Ajouter l’authentification
Section titled “4. Ajouter l’authentification”Plutôt que de coller un jeton en dur, créez une requête
d’authentification : clic droit ▸ Ajouter ▸ Requête d’authentification.
Configurez l’appel qui obtient le jeton (par exemple un POST /oauth/token),
puis, dans son onglet Configuration, déclarez ce qu’elle produit :
| En-tête produit | Valeur |
|---|---|
Authorization | {{token_type}} {{access_token}} |
La valeur est une expression évaluée sur le corps de la réponse de la
requête d’authentification. Renseignez au passage l’expression d’expiration
(par exemple {{expires_in}}) pour que Restorm renouvelle le jeton tout seul.
Revenez sur votre requête GET et, dans la barre du haut, choisissez cette
route d’authentification. L’en-tête est désormais injecté à chaque envoi, et
un 401 déclenche automatiquement un renouvellement puis un réessai.
Détails : Authentification.
5. Aller plus loin
Section titled “5. Aller plus loin”- Vous avez déjà une spécification ou une collection ? Fichier ▸ Importer
(
Ctrl+I) reconstruit tout l’arbre : voir Import & export. - Enchaînez plusieurs appels et vérifiez les résultats avec un scénario.
- Faites tourner ce scénario dans votre CI : Exécution headless.