Démarrage rapide · Votre première requête en trois étapes
Objectif : construire une requête HTTP fonctionnelle de zéro. Une fois la ligne principale « Groupe → Environnement → Requête » comprise, chaque autre protocole n'est qu'un protocole différent et une Pre-URL différente.
Étape 1 : créer un groupe, lier un environnement
Dans Quick Request, l'environnement est lié au groupe, et toutes les requêtes du groupe le partagent.
- Créez un nouveau groupe (ex.
Mon premier groupe). - Liez un environnement au groupe. Si vous n'en avez pas encore, créez d'abord un environnement (ex.
Local).
Pourquoi cette couche supplémentaire ? Parce que quand un module passe de dev / staging / production, vous ne voulez éditer que l'environnement — pas des dizaines de requêtes.
Étape 2 : renseigner la Pre-URL dans l'environnement
Un environnement conserve une adresse de base par protocole. Pour envoyer du HTTP, renseignez l'entrée http :
| Ligne de protocole | Exemple d'adresse de base | Notes |
|---|---|---|
| HTTP | http://127.0.0.1:18080 | Utilisez https:// pour activer TLS |
| WebSocket | ws://127.0.0.1:18085 | Utilisez wss:// pour activer TLS |
| gRPC | grpc://127.0.0.1:18089 | Utilisez grpcs:// pour activer TLS |
| MQTT | mqtt://127.0.0.1:18884 | Utilisez mqtts:// pour activer TLS |
⚠️ Le piège le plus facile : le protocole auquel appartient une adresse de base est décidé par le scheme au début de l'URL, pas par la ligne où vous l'avez tapée. Une adresse de base WebSocket doit s'écrire
ws://…ouwss://…; si vous tapez par erreurhttps://…, c'est traité comme HTTP, la requête WebSocket ne trouve pas d'adresse de base et échoue. Gardez la ligne de protocole et le scheme cohérents.
(Les ports comme 18080 ci-dessus viennent du serveur de test d'exemple ; remplacez-les par vos vraies adresses pour tester vos propres API.)
Étape 3 : créer une requête, ne remplir que le fragment de chemin, envoyer
Créez une requête dans le groupe :
- Protocole : HTTP ; Méthode :
GET. - URL — ne remplir que le fragment de chemin :
/echo(pas l'hôte complet — l'hôte est déjà fourni par la Pre-URLhttpde l'environnement). - Appuyez sur Envoyer.
Vous verrez /echo renvoyer exactement ce que vous avez envoyé. Ce qui est réellement parti sur le fil est http://127.0.0.1:18080/echo.
Ça marche — et maintenant ?
- Comprendre « pourquoi seulement
/echo» et « d'où vient{{x}}» → concepts - Signer les requêtes avant envoi / déchiffrer les réponses → scripts
- Copier une recette « login pour token, attachement automatique pour tout le groupe » → recettes
- Changer de protocole (WS/TCP/UDP/gRPC/MQTT) → la page du protocole correspondant (voir l'index)