HTTP et REST

Le type de requête le plus courant : tout ce qui parle HTTP, à commencer par les API REST.

Clic droit dans l’arbre ▸ Ajouter ▸ Requête HTTP.

Méthodes

GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS et QUERY.

L’URL

L’URL accepte des {{variables}} partout — schéma, hôte, port, chemin, chaîne de requête. La valeur résolue est affichée sous le champ.

Trois listes complètent l’URL :

• les paramètres de requête (?clé=valeur) ;
• les paramètres de chemin, qui remplacent les segments nommés du chemin ;
• les en-têtes.

Chaque ligne a une case d’activation, un type de valeur et une description.

Le corps

Quatre familles :

Type	Usage
Texte	JSON, XML, texte brut — avec coloration syntaxique et reformatage
Fichier	Envoie le contenu d’un fichier du disque
Formulaire (multipart/form-data)	Champs nommés, avec fichiers
x-www-form-urlencoded	Champs nommés encodés dans le corps

Options

• Délai d’expiration : en millisecondes, propre à cette requête ; à défaut, la valeur globale s’applique.
• Suivre les redirections : activé par défaut. Désactivez-le pour observer le 3xx lui-même et son en-tête Location.

La réponse

Statut, temps, taille, en-têtes, et le corps rendu selon son type de contenu : visionneuse JSON repliable, XML indenté, aperçu d’image, texte brut. L’onglet d’historique donne accès aux exécutions précédentes.

Authentification

Attachez une route d’authentification à la requête pour que les en-têtes soient injectés et le jeton renouvelé automatiquement. Voir Authentification.

Mode serveur

Restorm peut aussi héberger un serveur HTTP, pour tester la façon dont un client le consomme — typiquement le code de votre application, que vous pointez sur localhost le temps d’un essai.

Ajoutez-en un par Ajouter ▸ Serveur HTTP : il écoute sur localhost:<port><chemin> pour un couple méthode + chemin et répond avec le statut, les en-têtes et le corps que vous y configurez. D’autres protocoles s’hébergent de la même façon — voir Mode serveur et Simuler une API HTTP.

Extraits de code

Vingt-quatre langages et bibliothèques sont proposés dans l’onglet Code Snippets : cURL, JavaScript (Fetch, Axios), TypeScript, Python (Requests, http.client, aiohttp), Node.js natif, Go, Rust (reqwest), Java (HttpClient, OkHttp), C# (HttpClient), PHP (cURL, Guzzle), Ruby (Net::HTTP, Faraday), Swift (URLSession), Kotlin (OkHttp), Dart, R (httr), PowerShell, Elixir (HTTPoison), Clojure (clj-http).

Importer plutôt que saisir

Vous avez une spécification OpenAPI, une collection Postman, un fichier HAR ou une simple commande curl ? Fichier ▸ Importer reconstruit l’arbre pour vous. Voir Import & export.