Desde un comando curl
⌘⇧I, o clic derecho sobre una colección o carpeta → Import from cURL…, y pega. ⌘↵ analiza y muestra una vista previa; ⌘⇧↵ importa.
Mariner entiende comandos multilínea con continuaciones \ y los flags que importan: -X, -H, -d / --data-raw / --data-binary, --data-urlencode, -F (archivos incluidos), -G, -u, -b, -A, -e, --url. Los flags sin equivalente — -k, -L, --compressed, -o — se ignoran. Un body sin -X se convierte en POST; el tipo de body se detecta por el content type y la forma.
Una cabecera Authorization o un -u usuario:clave se promueve a la pestaña Auth de la petición, y la credencial va directa al Llavero en vez de a una fila de cabecera.
Desde Postman
⌘⇧O → pega el JSON o elige el archivo. Mariner lee Collection v2.1 (v2.0 en la medida de lo posible) y crea una colección nueva en el workspace actual con:
- carpetas, recursivamente;
- método, URL, cabeceras, query, variables de path y body de cada petición, incluidas las partes de archivo multipart;
- auth a nivel de colección y overrides por carpeta, con los secretos enviados al Llavero.
Los archivos de entorno de Postman no se importan — recréalos como entornos del workspace; suelen ser un puñado de claves. Ver Configurar entornos.
Desde un documento OpenAPI
File → Import OpenAPI Spec… acepta OpenAPI 3.0 / 3.1 en JSON (YAML no está soportado). Obtienes una colección con el nombre de la API, una carpeta por tag (las operaciones sin tag caen en Uncategorized) y una petición por operación con el primer ejemplo de body JSON. Los esquemas de seguridad se convierten en auth a nivel de colección.
Todas las URL se construyen como {{baseUrl}} + ruta, con las {llaves} convertidas en variables de path. Añade una variable baseUrl a tu entorno de workspace con la URL de servidor del documento y toda la colección apunta a ella.
Desde otro Mariner
File → Import Mariner Collection… y elige el paquete .mariner (una carpeta). La vista previa muestra el recuento de peticiones, carpetas y entornos antes de confirmar. Los secretos nunca van dentro de un paquete — vuelve a introducir los tokens de auth tras importar. La extensión antigua .nvapi sigue funcionando.
Salidas
- Export as Mariner… (⌘⇧X) — el formato de paquete descrito en Formato de archivos. Sin secretos.
- Export as Postman… — un archivo de colección v2.1. Sin secretos, incluido el client secret de OAuth.
- Copy as cURL (⌘⌥C) — una petición al portapapeles, con la auth heredada resuelta. Incluye las credenciales reales, así que pégalo con cuidado.
- Generate Code… (⌘⇧C) — cURL, JavaScript (fetch o axios), Python requests, Swift URLSession, Go net/http. Las variables se resuelven por defecto; los secretos quedan enmascarados salvo que actives Include secrets.
- Export HAR — desde el Historial, un archivo HAR 1.2 con las ejecuciones filtradas en ese momento.