Aller au contenu principal

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.

  1. Créez un nouveau groupe (ex. Mon premier groupe).
  2. 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 protocoleExemple d'adresse de baseNotes
HTTPhttp://127.0.0.1:18080Utilisez https:// pour activer TLS
WebSocketws://127.0.0.1:18085Utilisez wss:// pour activer TLS
gRPCgrpc://127.0.0.1:18089Utilisez grpcs:// pour activer TLS
MQTTmqtt://127.0.0.1:18884Utilisez 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://… ou wss://… ; si vous tapez par erreur https://…, 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 :

  1. Protocole : HTTP ; Méthode : GET.
  2. URL — ne remplir que le fragment de chemin : /echo (pas l'hôte complet — l'hôte est déjà fourni par la Pre-URL http de l'environnement).
  3. 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)