Las variables te permiten asignar un nombre a un valor y reutilizarlo donde lo necesites.
Por ejemplo, en lugar de pegar un token de API que cambia con frecuencia en cada solicitud, define una variable como ACCESS_TOKEN y usa {{ACCESS_TOKEN}} en tus solicitudes. Cuando el token expire, actualiza la variable una vez y todas las solicitudes que la utilicen tomarán automáticamente el nuevo valor.
Tipos de variables de un vistazo
Apidog soporta varios tipos de variables, cada una diseñada para escenarios específicos. Puedes usar: variables globales a nivel de equipo, variables globales a nivel de proyecto, variables de módulo, variables de entorno, variables de datos de prueba y variables locales.
Variables Globales
Las variables globales te permiten compartir datos ampliamente. Hay dos tipos:
Variables Globales a Nivel de Proyecto: Limitadas al proyecto actual. Perfectas para pasar datos entre solicitudes en el mismo proyecto. Por ejemplo, almacena un token del endpoint de inicio de sesión como una variable global a nivel de proyecto, luego reutilízalo en otras solicitudes dentro de ese proyecto.
Variables Globales a Nivel de Equipo: Compartidas entre todos los proyectos de un equipo. Ideales para la colaboración entre proyectos. Por ejemplo, si un servicio de autenticación emite un token utilizado por múltiples proyectos, almacénalo como una variable global de equipo.
Nota sobre permisos: Los miembros regulares solo pueden ver y cambiar los valores actuales de las variables globales de nivel de equipo existentes. No pueden añadir/eliminar variables ni renombrarlas. Solo los administradores de equipo pueden gestionar completamente las variables de nivel de equipo en Recursos del Equipo → Variables.
Variables de Módulo
Las variables de módulo están limitadas a un módulo específico. Si importas una Colección de Postman, sus variables de colección se importan como variables de módulo de Apidog.
Son excelentes para la configuración específica del módulo. Por ejemplo, un proyecto podría tener módulos separados para usuarios, pedidos y productos; cada uno puede mantener su propia configuración en variables de módulo.
Asegúrate de que Apidog esté actualizado para usar las variables de módulo.
Variables de Entorno
Las variables de entorno son probablemente tu tipo más utilizado. Te permiten cambiar entre entornos sin modificar la configuración de cada solicitud.
En la práctica, normalmente tienes múltiples entornos (local, prueba, staging, producción). Cada uno tiene diferentes direcciones de servidor, conexiones a bases de datos o configuraciones de terceros. Con las variables de entorno, puedes alternar entre ellos instantáneamente.
Nota: Solo un entorno puede estar activo a la vez. Cuando seleccionas un entorno, todas las variables definidas en él entran en vigor.
Variables de Datos de Prueba
Las variables de datos de prueba impulsan las pruebas basadas en datos. Cuando necesitas probar el mismo endpoint con muchos conjuntos de datos, esta es tu aliada.
Prepara un archivo CSV o JSON con múltiples filas (u objetos). En un escenario de prueba automatizado, importa el archivo, y Apidog iterará cada fila como un conjunto de variables y ejecutará la prueba para cada una.
Variables Locales
Las variables locales tienen la vida útil más corta: válidas solo durante una única solicitud o ejecución de prueba. Desaparecen después de la ejecución.
Debido a que las variables locales tienen la prioridad más alta, son perfectas para anular momentáneamente otros tipos de variables. Por ejemplo, tu entorno define user_id, pero para una prueba especial, necesitas un valor diferente; establece una variable local con el mismo nombre en lugar de cambiar el entorno.
Prioridad de las Variables
Cuando varias variables comparten el mismo nombre, Apidog las resuelve por prioridad (de mayor a menor): Variables Locales > Variables de Datos de Prueba > Variables de Entorno > Variables de Módulo > Variables Globales a Nivel de Proyecto > Variables Globales a Nivel de Equipo.
Ejemplo: Si defines tres variables llamadas userId:
- Variables globales a nivel de proyecto
userId = 1000 - Variables de módulo:
userId = 2000 - Variables de entorno:
userId = 3000
Cuando usas {{userId}} en una solicitud, el valor efectivo es 3000 (del entorno). Si no hay valor de entorno, se recurre al valor del módulo (2000), y luego al valor global del proyecto (1000).
Valores Iniciales vs. Valores Actuales
Las variables globales, de módulo y de entorno tienen valores iniciales y actuales; esto equilibra el intercambio de equipo con la privacidad personal.
- Los valores iniciales residen en los servidores de Apidog y se sincronizan con los compañeros de equipo. Úsalos para configuraciones compartidas, como URLs de servidores de prueba y claves de API públicas.
- Los valores actuales residen solo en tu dispositivo. Úsalos para secretos como claves de API personales, contraseñas o configuraciones de entorno privadas.
Cuando existe un valor actual, Apidog lo prefiere. Si el valor actual está vacío, Apidog usa el valor inicial. ¿Quieres que el valor actual siga al inicial? Haz clic en el icono de enlace junto al valor actual para volver a vincularlo.
Los valores actuales se almacenan en tu dispositivo y pueden perderse si borras la caché o cambias de dispositivo. En la versión web de Apidog, se almacenan en el navegador. Para moverlos a un nuevo dispositivo, exporta/importa entornos para migrar los valores actuales.
Nota: Al ejecutar pruebas automatizadas con Apidog CLI, ten en cuenta una diferencia clave: El cliente de Apidog utiliza los valores actuales durante la ejecución, mientras que la CLI utiliza los valores iniciales. Si los resultados difieren entre el cliente y la CLI, esta es una razón común.
Formas de Establecer Variables
Elige el método que mejor se adapte a la procedencia del valor y a cómo lo usarás.
Establecer Variables Directamente en la Página de Gestión de Entornos
El método más sencillo. Haz clic en el botón de Gestión de Entornos (arriba a la derecha), cambia a global o a un entorno específico, luego añade nombres y valores.
Este método es ideal para configuraciones estables, como conexiones a bases de datos. Puedes establecer tanto valores iniciales (compartidos) como actuales (privados).
Usar la función "Almacenar Variable"
A menudo, el valor de la variable proviene de una respuesta, como un token de un endpoint de inicio de sesión o un ID de usuario de un endpoint de creación de usuario. Utiliza la función visual "Almacenar Variable" en los Post Processors para configurar una nueva variable.
En los Post Processors de una solicitud, añade "Almacenar Variable", elige la fuente (comúnmente la respuesta JSON) y selecciona el campo usando JSONPath.
Por ejemplo, si el JSON de respuesta es:
{
"user": {
"id": "69",
"email": "Ralph85@gmail.com",
"first_name": "Katlynn",
"last_name": "Reichert",
"api_token": "dolore ut mollit Duis sit",
"created_at": "2025-09-19T01:03:50.236Z",
"updated_at": "2025-05-10",
"deleted_at": "2025-09-18T18:30:51.217Z",
"role": "developer",
"metadata": {}
}
}Usa $.user.email para extraer el token.
También puedes establecer variables directamente desde la sección de respuesta de una solicitud.
Establecer Variables a Través de Scripts
Para lógica más compleja, usa Scripts Personalizados en Pre Processors o Post Processors. Apidog proporciona una API de scripts completa para manipular todos los tipos de variables.
// Establecer una variable global a nivel de proyecto
pm.globals.set('variable_key', 'variable_value');
// Establecer una variable global a nivel de equipo (debe definirse primero en la página de Recursos del Equipo)
pm.globals.set('variable_key', 'variable_value', 'TEAM');
// Establecer una variable de entorno
pm.environment.set('variable_key', 'variable_value');
// Establecer una variable de módulo
pm.moduleVariables.set('variable_key', 'variable_value');
// Establecer una variable local
pm.variables.set('variable_key', 'variable_value');Al almacenar objetos o arrays, conviértelos a string primero y parsea al leer. Por ejemplo:
pm.environment.set('user', JSON.stringify(userObj));
const users = JSON.parse(pm.environment.get('user'));Nota: Los scripts solo pueden establecer los valores actuales de las variables. Los valores iniciales deben establecerse en la Página de Gestión de Entornos.
Usar Datos de Base de Datos como Variables
Apidog puede obtener datos directamente de una base de datos y establecerlos como variables, lo cual es excelente para pruebas que dependen de registros reales.
Añade una Operación de Base de Datos en los Post Processors, configura la conexión y escribe la consulta SQL. Luego extrae los campos en variables usando JSONPath.
Consejos para Usar Variables
Dónde Funcionan las Variables
Las variables se resuelven solo cuando se envía una solicitud. Esto significa que puedes usarlas en encabezados, parámetros, cuerpo, escenarios de prueba y scripts, en cualquier lugar involucrado en el envío de una solicitud.
Dado que Apidog es visual primero, una regla simple: si ves un botón de "Valor Dinámico", puedes usar variables allí.
Sintaxis Básica
Usa doble llave para referenciar una variable: {{variableName}}. Esto funciona en URL, encabezados, parámetros y cuerpo.
Por ejemplo, en parámetros:
Y en el cuerpo:
Notas para cuerpos JSON: las variables de cadena necesitan comillas, las variables numéricas no. Las dobles llaves pueden activar advertencias de lint de JSON, pero pueden ignorarse con seguridad.
Si ves "variable no resuelta", no te asustes. Las variables establecidas en Post Processors o scripts pueden no existir hasta que se ejecute la solicitud, y las variables locales desaparecen después de la ejecución. La mejor manera de confirmar es enviar la solicitud.
Obtener Campos Hijos de una Variable
A veces, tus variables almacenan objetos o arrays, no solo cadenas o números. Por ejemplo, una API de usuario a menudo devuelve un objeto con id, nombre, email, etc.
Supongamos que almacenaste este objeto de respuesta como una variable llamada user:
{
"id": 1001,
"name": "Joe",
"email": "joe@example.com",
"role": "admin"
}Puedes referenciar campos específicos con la notación de punto, como {{user.id}} (1001) o {{user.name}} ("Joe").
Para arrays, es similar. Si tienes una variable users:
[
{"id": 1001, "name": "Joe"},
{"id": 1002, "name": "Rio"},
{"id": 1003, "name": "Outher"}
]Usa {{users[0].name}} para obtener el nombre del primer usuario, o {{users[1].id}} para el id del segundo usuario.
Esto sigue una semántica similar a JSONPath: el nombre de la variable actúa como la raíz ($).
Usar Variables en Scripts
Puedes usar variables en los scripts personalizados de Pre Processors o Post Processors. Apidog proporciona un conjunto completo de APIs de script, lo que te permite acceder de forma flexible a diferentes tipos de variables.
// Obtener una variable global a nivel de proyecto
pm.globals.get('variable_key');
// Obtener una variable global a nivel de equipo
pm.globals.get('variable_key', 'TEAM');
// Obtener una variable de entorno
pm.environment.get('variable_key');
// Obtener una variable de módulo
pm.moduleVariables.get('variable_key');
// Obtener una variable local
pm.variables.get('variable_key');Para objetos/arrays almacenados como cadenas, parsea primero:
const userObj = JSON.parse(pm.environment.get('user'));
console.log(userObj.name);Pruebas Dirigidas por Datos con Variables de Datos de Prueba
Sube un archivo CSV o JSON que contenga múltiples filas de datos. Durante la ejecución, Apidog sustituye {{variableName}} por los valores de cada fila y ejecuta la prueba una vez por fila, perfecto para validar la robustez con muchas entradas.
Expresiones de Valor Dinámico
Más allá de tus propias variables, Apidog soporta valores dinámicos, que generan datos aleatorios siguiendo reglas específicas.
En los scripts, puedes procesar cadenas que incluyen expresiones dinámicas con await pm.variables.replaceInAsync():
const template = "Hello, {{$person.fullName}}";
const result = await pm.variables.replaceInAsync(template);
console.log(result); // Muestra un nombre generado aleatoriamente
Los valores dinámicos son perfectos para generar datos de prueba aleatorios sin preparar un conjunto de datos de antemano.
Resumen
Las variables son una de las características más potentes de Apidog. Reducen la repetición, hacen que las pruebas sean flexibles y simplifican el cambio entre proyectos y entornos. Ya sea que compartas configuraciones globales entre equipos, impulses pruebas con datos CSV o anules valores localmente, las variables ayudan a mantener tu flujo de trabajo eficiente y organizado. Al dominar los tipos de variables, las prioridades y las formas de establecerlas, puedes asegurar que tus solicitudes de API permanezcan consistentes, mantenibles y listas para escenarios del mundo real.