Variables y secretos

De dónde salen los valores

Mariner resuelve cada {{nombre}} a través de una cascada. Gana la última capa que define la clave:

1. Las variables globales — no cuelgan de ningún workspace ni de ninguna colección. La app no las crea: llegan al importar un paquete .mariner.
2. Las variables de la colección — importadas de una colección de Postman como ‹Colección› Variables. Aquí no hay nada que elegir: se aplican a todo lo que hay dentro de esa colección.
3. El entorno activo del workspace — el que muestra la píldora ● ENV.
4. Las variables locales de la petición — la pestaña Variables de la propia petición. Úsalas para un valor que no tiene sentido en ningún otro sitio; ganan sobre el entorno.

El orden es el de Postman (global < colección < entorno < local), así que una colección que importaste envía la misma petición en las dos apps. Pasa el cursor por un token de la URL para ver de qué capa salió su valor.

El valor de una variable puede contener a su vez otros tokens; Mariner resuelve hasta cinco niveles y deja un ciclo como texto literal.

Variables dinámicas incorporadas

Producen un valor nuevo en cada envío y nunca hay que definirlas:

Variables de path

Un segmento como /users/:id se convierte en una fila de la sección Path variables de la pestaña Params. Rellénala y el segmento se sustituye al enviar; déjala vacía y Mariner bloquea el envío hasta que lo hagas. Los puertos y https: no se confunden con variables de path — solo cuenta un dos puntos que sigue a una barra.

Secretos

Marca Secret en una variable y su valor queda enmascarado allí donde aparezca: la lista del entorno, la vista previa de la URL, el código generado. Revélalo cuando lo necesites con el icono del ojo.

• Los valores secretos quedan fuera de toda exportación — el paquete .mariner y el archivo Postman conservan la clave y sus flags con el valor vacío, para que quien lo reciba ponga el suyo.
• La hoja de generar código tiene un interruptor Include secrets, apagado por defecto, que avisa al activarlo.
• Las variables secretas se sincronizan con iCloud como cualquier otra, porque forman parte del entorno. Las credenciales introducidas en la pestaña Auth son distintas: van al Llavero de macOS y nunca salen del Mac — ver Autenticación.

Capturar valores de una respuesta

La pestaña Post-Response guarda reglas de captura: cuando llega una respuesta, toma un valor de ella y escríbelo en una variable. Un login que guarda su token es el caso clásico.

1. Pulsa Add rule y elige una fuente: una ruta JSON en el body ($.token, $.data.items[0].id), una cabecera, una cookie o el código de estado.
2. Elige el destino: el entorno activo del workspace o las variables de la propia petición, y la clave a escribir.
3. Opcionalmente, limita la regla a un rango de estados. El valor por defecto es 200–299, así que un login fallido nunca pisa un token bueno.

Cada regla muestra una vista previa en vivo contra la última respuesta, y el selector de valores permite hacer clic en un nodo del JSON en vez de escribir su ruta. Los resultados aparecen en la pestaña Captures de la respuesta. Durante una ejecución de colección, las capturas de una petición son visibles para la siguiente, que es lo que hace que una secuencia login → listado → detalle funcione sin intervención.

La sintaxis de rutas JSON es deliberadamente pequeña: $, claves con punto e índices numéricos. Sin comodines, sin filtros.