Capturas de respuesta

Una captura guarda un valor de la respuesta de una solicitud en una variable, tras cada envío. Captura el token de acceso de una respuesta de inicio de sesión en {{token}} y todas las solicitudes que usan {{token}} envían el más reciente, sin copiar nada. Cuando el token se renueva, todas reciben el nuevo.

Las capturas se guardan con la solicitud, así que funcionan para todas las personas que tienen el espacio de trabajo, en la Ejecución y en los flujos, además de cuando haces clic en Enviar.

Guarda un valor de la respuestaCopy Anchor Link

La forma más rápida de crear una captura es desde la propia respuesta:

1. Envía la solicitud. En el ejemplo Alpenglow, envía Auth › Sign in.
2. En la pestaña Cuerpo, elige Árbol JSON (o Formulario, MessagePack o XML para esos cuerpos).
3. Pasa el puntero por el valor, como access_token, y haz clic en Guardar en una variable….
4. Escribe un Nombre de la variable, o conserva el que se sugiere a partir de la ruta. Los nombres que ya están en uso se ofrecen mientras escribes; elegir uno sustituye esa variable (el panel dice Reemplaza token).
5. En Guardar en, elige el entorno de la ventana (Entorno “Staging”) o Espacio de trabajo.
6. Marca Secreto para guardar el valor solo en el llavero, nunca en archivos. Viene marcado para los nombres que parecen credenciales (token, secret, password, apiKey y similares).
7. Deja marcado Actualizar en cada envío para convertirlo en una captura de la solicitud, guardada con ella. Desmárcalo para guardar el valor una sola vez.
8. Haz clic en Guardar.

Edita las capturasCopy Anchor Link

Las capturas de una solicitud están en su pestaña Variables, bajo De la respuesta, debajo de las variables propias de la solicitud. Cada fila es una captura:

Haz clic en Añadir valor para una fila nueva, y en el botón − para eliminar una. Tras un envío, cada fila muestra una marca verde cuando guardó su valor, o un aviso naranja con el motivo cuando no lo hizo.

De dónde vienen los valoresCopy Anchor Link

Entorno o espacio de trabajoCopy Anchor Link

• Entorno escribe la variable en el entorno elegido para la ventana en el momento del envío. Úsalo para valores que difieren según el servidor, como un token de staging y uno de producción. Si no hay ningún entorno elegido, no se guarda nada y la fila indica que elijas uno o que guardes en el espacio de trabajo.
• Espacio de trabajo escribe una variable del espacio de trabajo, la misma sea cual sea el entorno elegido.

El valor de un entorno prevalece sobre el del espacio de trabajo para el mismo nombre, así que una captura en el espacio de trabajo queda oculta cuando el entorno elegido tiene una variable con ese nombre. Consulta Entornos.

SecretosCopy Anchor Link

Un secreto capturado se escribe solo en el llavero. El archivo del espacio de trabajo nombra la variable, pero nunca contiene su valor, así que puedes subir el espacio de trabajo al repositorio. Activa Secreto para todo token, ID de sesión o clave que captures. Consulta Secretos.

En Alpenglow, Auth › Sign in captura $.access_token en el secreto del espacio de trabajo token, y la carpeta Orders lo envía como token Bearer.

Cuando no se captura nadaCopy Anchor Link

Una captura deja su variable como estaba, e indica el motivo tras el envío, cuando:

• el estado de la respuesta es 400 o superior: solo se conservan valores de respuestas por debajo de 400, así que un inicio de sesión fallido nunca sobrescribe un buen token,
• la ruta no encuentra nada en la respuesta,
• el cuerpo supera los 32 MB,
• guarda en el entorno y no hay ningún entorno elegido,
• no se permite la escritura: cuando un agente de IA envía la solicitud, sus reglas deciden si puede cambiar variables. Consulta Agentes.

Capturas o valores de respuestaCopy Anchor Link

Los valores dinámicos como {{$response('auth/sign-in', '$.access_token')}} leen directamente la última respuesta de una solicitud y, si no tiene ninguna, la envían antes. En cambio, una captura copia el valor en una variable, lo que conviene a un valor que usan muchas solicitudes o que varias solicitudes pueden renovar. Ambos leen los mismos JSONPath y XPath.