Conceptos clave
Cuando estos cuatro diseños quedan claros, todos los protocolos y escenarios posteriores resultan sencillos:
- El modelo de tres entidades: cómo se relacionan Grupo / Entorno / Solicitud
- El diseño de Pre-URL del entorno: por qué las solicitudes guardan solo rutas relativas
- El pipeline de ensamblado del envío: cómo un «Enviar» convierte la configuración en una solicitud real
- El sistema de variables: de dónde se resuelve
{{variable}}y las tres capas de variables
El modelo de tres entidades
¿Por qué el entorno se vincula al grupo y no a cada solicitud? Un grupo suele representar «todas las APIs de un módulo bajo un destino de despliegue». Vincular a nivel de grupo significa que cambiar de entorno mueve todo el grupo de una vez — sin editar solicitud por solicitud. Si una solicitud necesita otro entorno, simplemente colócala en un grupo vinculado a ese entorno.
Diseño de Pre-URL del entorno
Este es el diseño más importante — y el más malinterpretado.
Las solicitudes guardan rutas relativas; los entornos guardan direcciones base
En las herramientas tradicionales cada solicitud guarda una URL completa (https://api.example.com/v1/users), por lo que cambiar al entorno de pruebas implica reemplazar dominios en lote. Esta herramienta lo da la vuelta:
El scheme decide el protocolo y TLS (¡clave!)
Las Pre-URLs se guardan por protocolo, pero qué protocolo sirve realmente cada entrada lo decide el scheme del inicio de la URL. El scheme expresa tanto «qué protocolo» como «cifrado o no (TLS)»:
| Protocolo | Sin cifrar | Cifrado |
|---|---|---|
| HTTP | http:// | https:// |
| WebSocket | ws:// | wss:// |
| TCP | tcp:// | tcps:// |
| UDP | udp:// | — |
| gRPC | grpc:// | grpcs:// |
| MQTT | mqtt:// | mqtts:// |
⚠️ Error habitual: la dirección base de un WebSocket debe escribirse como
ws:///wss://. Si escribeshttps://, se trata como HTTP y la solicitud WebSocket falla por falta de dirección base. Mantén coherentes la línea de protocolo y el scheme.
El pipeline de ensamblado del envío
Pulsar «Enviar» no dispara directamente un socket. El pipeline ensambla «solicitud + entorno del grupo + variables» paso a paso en una solicitud real, e inserta una cadena de acciones antes y después de la llamada de red:
Puntos clave:
- Las cadenas de acciones solo se ejecutan con «ejecutar scripts» activado. Pulsar Enviar en la app las ejecuta por defecto; los envíos automatizados / MCP deben activarlo explícitamente. Con los scripts desactivados, simplemente no ocurre nada: ni tokens inyectados antes del envío ni cifrado. Es exactamente por eso que el control negativo «sin token → 401» de las recetas se comporta así.
- Los scripts de envío previo reescriben la solicitud que está a punto de salir; los scripts de post-respuesta reescriben la respuesta que recibes. Ambos pueden leer y escribir variables de tiempo de ejecución.
El sistema de variables
Hay tres tipos de «variables» con ámbitos distintos. Confundirlos es la trampa más habitual para principiantes.
¿Qué puede resolver realmente {{name}}?
| Dónde se escribe | Variables de entorno | Variables de ejecución | Uso típico |
|---|---|---|---|
{{name}} (en URL / params / headers / body) | ✅ | ❌ | Referenciar configuración del entorno, relleno dinámico |
| Leer variables dentro de scripts | ✅ | ✅ | Pasar tokens de login entre solicitudes, etc. |
Regla nemotécnica:
{{}}solo ve variables «de configuración»; los scripts pueden leer las tres capas. Las variables de ejecución son la «pizarra del runtime» — solo los scripts pueden escribir en ella, y{{}}nunca la mira.
¿Por qué {{authToken}} no puede leer el token guardado en el login? Porque el script de login lo almacenó en la capa de ejecución, que {{}} no interpreta. El enfoque correcto es un script de envío previo que lo lea e inyecte la cabecera (ver recetas, escenario 1).
Variables dinámicas {{$xxx}}
Dentro de {{}} también hay un conjunto de variables dinámicas integradas, generadas de nuevo en cada evaluación, utilizables directamente en URL / params / headers / body:
| Variable | Genera |
|---|---|
{{$timestamp}} / {{$timestampMs}} | Marca de tiempo Unix en segundos / milisegundos |
{{$isoTimestamp}} | ISO8601 UTC |
{{$uuid}} / {{$guid}} | UUID v4 |
{{$randomInt}} / {{$randomInt min,max}} | Entero aleatorio (por defecto 0..1000) |
{{$randomBoolean}} {{$randomFullName}} {{$randomEmail}} {{$randomPhoneNumber}} {{$randomIpv4}} {{$randomIpv6}} {{$randomUrl}} {{$randomColor}} {{$randomHexadecimal}} {{$randomAlphaNumeric}} {{$randomCity}} {{$randomCountry}} {{$randomDateRecent}} {{$randomPrice}} {{$randomWord}} {{$randomLorem}} {{$randomCompanyName}} etc. | Datos de ejemplo aleatorios variados |
Ejemplo: GET /echo?ts={{$timestamp}}&u={{$uuid}} — en la práctica, cada envío sustituye ts/u por valores reales recién generados.
Resumen
- Las solicitudes guardan fragmentos de ruta; los entornos aportan direcciones base por protocolo mediante Pre-URLs; el scheme decide protocolo + TLS.
- Enviar es un pipeline de ensamblado: unir URL → interpolar → ajustes de transporte → cadena previa al envío → red → cadena post-respuesta.
- Hay tres capas de variables:
{{}}lee las de configuración, los scripts leen las tres; los tokens pasan por scripts, no por{{}}.
Siguiente: scripts →