Saltar al contenido principal

Conceptos clave

Cuando estos cuatro diseños quedan claros, todos los protocolos y escenarios posteriores resultan sencillos:

  1. El modelo de tres entidades: cómo se relacionan Grupo / Entorno / Solicitud
  2. El diseño de Pre-URL del entorno: por qué las solicitudes guardan solo rutas relativas
  3. El pipeline de ensamblado del envío: cómo un «Enviar» convierte la configuración en una solicitud real
  4. 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)»:

ProtocoloSin cifrarCifrado
HTTPhttp://https://
WebSocketws://wss://
TCPtcp://tcps://
UDPudp://—
gRPCgrpc://grpcs://
MQTTmqtt://mqtts://

⚠️ Error habitual: la dirección base de un WebSocket debe escribirse como ws:// / wss://. Si escribes https://, 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 escribeVariables de entornoVariables de ejecuciónUso 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:

VariableGenera
{{$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 →