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
POSToPUT. - Encabezados — usa variables en los valores de los encabezados para mayor flexibilidad.
- Parámetros de consulta — enriquece las solicitudes
GETcon 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_URLoAPI_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.