Valores dinámicos

Un valor dinámico es un token que Echolot calcula cada vez que se envía la solicitud: la hora actual, un UUID nuevo, una firma sobre el cuerpo o un valor de la última respuesta de otra solicitud. Se escribe como una variable, con un $ delante: {{$uuid}}, {{$sha256('{{password}}')}}. Los valores dinámicos funcionan donde funcionan las variables: la URL, los parámetros, las cabeceras, el cuerpo, los campos de formulario y los campos de autenticación.

Esta página muestra cómo añadirlos y editarlos. Todos los valores dinámicos, con sus argumentos, están en la referencia de valores dinámicos.

Añade uno desde la listaCopy Anchor Link

1. En cualquier campo que admita variables, escribe {{. Se abre una lista con primero las variables del ámbito y después los valores dinámicos por categoría.
2. Sigue escribiendo para acotarla: uuid, time, hmac. Cada entrada indica lo que da.
3. Muévete con ↑ y ↓ y pulsa ↩ o ⇥ para insertarlo; Esc cierra la lista.

Un valor que admite argumentos abre su editor en cuanto lo insertas, para que los rellenes en un formulario en lugar de escribirlos. Para abrir la lista sin escribir {{, haz clic con el botón derecho en el campo y elige Insertar variable o valor….

En el campo, un valor dinámico se muestra como una píldora con una etiqueta legible: el título del valor (HMAC-SHA256) o, para un valor de respuesta, la solicitud y lo que lee (Sign in › $.access_token). El texto subyacente se queda como está escrito.

Edita un tokenCopy Anchor Link

Haz doble clic en una píldora, o haz clic con el botón derecho y elige Editar token…. Se abre el editor de tokens:

• El botón de la parte superior indica qué es el token y lo cambia: una variable o un valor dinámico.
• Los campos son los argumentos del valor. Un argumento de solicitud es un menú con las solicitudes del espacio de trabajo por carpeta; un argumento de consulta (un JSONPath, un XPath, un nombre de cabecera) tiene un botón que lista lo que contiene la última respuesta, para que elijas un valor en lugar de escribir su ruta.
• Valor muestra lo que da el token ahora, con el entorno actual, o No se resuelve con el entorno actual y el motivo.
• Para una variable, Usar otra variable la cambia por otra, y Usar un valor de respuesta en su lugar la convierte en un valor de respuesta.
• Eliminar borra el token; OK conserva tus cambios.

Vista rápidaCopy Anchor Link

Pasa el puntero por una píldora para ver lo que da sin abrirla: el valor (enmascarado si es secreto, marcado como Secreto), de dónde viene y cómo está escrito. Para los valores dinámicos, la vista rápida indica cuándo se calculan: los valores de tiempo y los aleatorios dicen Se genera de nuevo en cada envío; arriba hay un ejemplo. Sus botones son Editar…, Copiar valor y Todas las variables…, que abre el panel de variables.

Escribirlos a manoCopy Anchor Link

{{$name}}                       no arguments
{{$name('text', 42)}}           text in single or double quotes, numbers as they are
{{$base64(user)}}               a bare name is a variable
{{$base64('{{user}}:{{pass}}')}} variables inside text
{{$sha256("{{$requestBody('')}}")}} a dynamic value inside another one

Un token dentro de un argumento entre comillas debe usar el otro tipo de comillas para sus propios argumentos: comillas dobles alrededor de un token cuyos argumentos van entre comillas simples, como en la última línea.

Qué puedes usarCopy Anchor Link

$env no está disponible para los agentes: cuando un agente de IA envía una solicitud, una variable de entorno de tu Mac queda fuera.

El ejemplo Alpenglow usa uno en Orders › Create order: su cabecera Idempotency-Key es {{$uuid}}, así que cada pedido es nuevo.

Valores de las respuestas de otras solicitudesCopy Anchor Link

Los valores de Respuestas leen la última respuesta de otra solicitud guardada. El primer argumento es la ruta de esa solicitud en el espacio de trabajo, su carpeta y su nombre como en los archivos: auth/sign-in para Auth › Sign in.

Cuando la solicitud que lee un valor aún no tiene respuesta, Echolot la envía antes. La línea bajo la barra de la URL lo indica antes de enviar: Primero envía “Sign in”. El último argumento opcional decide cuándo ocurre; en el editor de tokens es Enviarla antes:

{{$response('auth/sign-in', '$.access_token', 'fresh')}}

Las solicitudes que se leen unas a otras en círculo se rechazan, con los nombres de las solicitudes implicadas.

Para guardar un valor de una respuesta en una variable que lean todas las solicitudes, en lugar de apuntar a una sola solicitud, usa una captura de respuesta.

Valores de esta solicitudCopy Anchor Link

Los valores de Solicitudes leen una solicitud tal como se enviaría, con sus variables y su autenticación ya rellenadas. Deja vacío el primer argumento para la solicitud que se está enviando: {{$requestHeader('', 'X-Request-Id')}}. Echolot calcula solo la parte que pides, de modo que una cabecera puede firmar el cuerpo:

X-Signature: {{$hmacSha256('{{signingKey}}', "{{$requestBody('')}}")}}

jqCopy Anchor Link

Los filtros jq funcionan en $responseJq, $requestJq y $response(…, 'jq:…'), sin instalar nada. Un filtro con varios resultados los da uno por línea:

{{$responseJq('catalog/list-products', '.items[0].sku')}}
{{$responseJq('catalog/list-products', '[.items[].price.amount] | add')}}

Cuando un valor no se resuelveCopy Anchor Link

Un token que no se puede calcular (una variable que falta, una solicitud sin respuesta que no se puede enviar, un JSONPath que no encuentra nada) se envía tal como está escrito, y la línea bajo la barra de la URL muestra 1 problema. Haz clic en ella para ver cuál. El editor de tokens y la vista rápida dicen lo mismo.