Variables

Qué son las variables

Las variables son pares nombre/valor reutilizables que defines una vez y referencias en tus verificaciones de API. En lugar de codificar la misma URL base, token o id de cuenta en cada verificación, guardas el valor como variable y lo referencias por su nombre — cámbialo en un solo lugar y todas las verificaciones que lo usan tomarán el nuevo valor.

Puedes incorporar variables en muchas partes de una verificación de API:

URLs — construye URLs de solicitud de forma dinámica.
Cuerpo — inserta variables directamente en el cuerpo de solicitudes POST o PUT.
Encabezados — usa variables en los valores de los encabezados para mayor flexibilidad.
Parámetros de consulta — enriquece las solicitudes GET con parámetros de consulta dinámicos.
Autenticación básica — pasa un usuario y una contraseña sin codificarlos en cada verificación.

Gestionar variables

Abre la página de Variables para crear, editar y eliminar variables. Las variables están vinculadas a tu equipo, por lo que cualquier miembro del equipo puede referenciarlas desde sus verificaciones.

Crear una variable

Haz clic en Nueva variable.
Introduce un nombre de variable — es el nombre que referenciarás en tus verificaciones (por ejemplo BASE_URL o API_TOKEN).
Introduce un valor de variable.
Haz clic en Guardar variable.

Tanto el nombre como el valor son obligatorios — no se puede guardar una variable con el nombre o el valor vacío.

Editar o eliminar una variable

Usa las acciones de fila en la página de Variables para actualizar el valor de una variable o eliminarla. Un cambio de valor surte efecto en la siguiente ejecución de cualquier verificación que la referencie.

Referenciar una variable en una verificación

Referencia una variable envolviendo su nombre en dobles llaves: {{NOMBRE_VARIABLE}}. LoadFocus sustituye el valor actual de la variable cuando se ejecuta la verificación.

Algunos ejemplos:

URL: https://{{BASE_URL}}/v1/users/{{USER_ID}}
Encabezado: Authorization: Bearer {{API_TOKEN}}
Parámetro de consulta: ?account={{ACCOUNT_ID}}
Cuerpo: { "email": "{{TEST_EMAIL}}" }

Variables vs. secretos

Usa variables para valores reutilizables no sensibles como URLs base, ids de cuenta o feature flags — sus valores se muestran en la lista de variables.

Usa secretos para valores sensibles como tokens de API, contraseñas y claves de firma. Los secretos son de solo escritura en la interfaz: una vez guardados, sus valores se enmascaran y nunca se vuelven a mostrar. Referencia un secreto igual que una variable, con {{NOMBRE_SECRETO}}.

Consejo: si un valor es sensible, guárdalo como secreto en lugar de como variable para que no sea visible en la lista.

Los Browser Checks usan un almacén aparte

Las variables y los secretos de esta página se aplican a los checks de API. Los Browser Checks leen de su propio almacén independiente, gestionado en Secretos y variables de monitoreo sintético.

Un valor guardado aquí no es visible para un Browser Check, y al revés tampoco. Si una referencia {{NAME}} se resuelve en un check de API pero llega vacía en un script de Playwright, casi siempre está definida en el otro almacén. Defínela en ambos sitios si los dos tipos de check la necesitan.

Guías relacionadas

Uptime Monitoring

Informes Externos