Concepts clés
Une fois ces quatre designs assimilés, tous les protocoles et scénarios qui suivent sont simples :
- Le modèle à trois entités : comment Groupe / Environnement / Requête se relient
- Design Pre-URL de l'environnement : pourquoi les requêtes ne stockent que des chemins relatifs
- Le pipeline d'assemblage de l'envoi : comment un « Envoyer » transforme la configuration en requête réelle
- Le système de variables : d'où se résout
{{variable}}et les trois couches de variables
Le modèle à trois entités
Pourquoi l'environnement est-il lié au groupe plutôt qu'à chaque requête ? Un groupe représente généralement « toutes les API d'un module sous une même cible de déploiement ». Lier au niveau du groupe signifie que changer d'environnement bascule tout le groupe d'un coup — sans édition requête par requête. Si une requête a besoin d'un autre environnement, placez-la simplement dans un groupe lié à cet environnement.
Design Pre-URL de l'environnement
C'est le design le plus important — et le plus mal compris.
Les requêtes stockent des chemins relatifs ; les environnements stockent des adresses de base
Dans les outils traditionnels chaque requête stocke une URL complète (https://api.example.com/v1/users), donc passer à l'environnement de test implique de remplacer les domaines en lot. Cet outil inverse la logique :
Le scheme décide du protocole et de TLS (essentiel !)
Les Pre-URLs sont stockées par protocole, mais le protocole réellement servi par une entrée est décidé par le scheme au début de l'URL. Le scheme exprime à la fois « quel protocole » et « chiffré ou non (TLS) » :
| Protocole | Scheme en clair | Scheme chiffré |
|---|---|---|
| HTTP | http:// | https:// |
| WebSocket | ws:// | wss:// |
| TCP | tcp:// | tcps:// |
| UDP | udp:// | — |
| gRPC | grpc:// | grpcs:// |
| MQTT | mqtt:// | mqtts:// |
⚠️ Erreur fréquente : l'adresse de base d'un WebSocket doit s'écrire
ws:///wss://. Si vous tapezhttps://, c'est traité comme HTTP et la requête WebSocket échoue faute d'adresse de base. Gardez la ligne de protocole et le scheme cohérents.
Le pipeline d'assemblage de l'envoi
Appuyer sur « Envoyer » ne déclenche pas directement un socket. Le pipeline assemble « requête + environnement du groupe + variables » pas à pas en une requête réelle, et insère une chaîne d'actions avant et après l'appel réseau :
Points clés :
- Les chaînes d'actions ne s'exécutent que si « exécuter les scripts » est activé. Appuyer sur Envoyer dans l'app les exécute par défaut ; les envois automatisés / MCP doivent l'activer explicitement. Scripts désactivés, rien ne se passe : ni token injecté avant l'envoi, ni chiffrement. C'est exactement pourquoi le contrôle négatif « sans token → 401 » des recettes se comporte ainsi.
- Les scripts de pré-envoi réécrivent la requête qui va partir ; les scripts de post-réponse réécrivent la réponse reçue. Les deux peuvent lire et écrire les variables d'exécution.
Le système de variables
Il existe trois sortes de « variables » aux portées différentes. Les confondre est le piège le plus courant pour les débutants.