De um comando curl
⌘⇧I, ou botão direito em uma coleção ou pasta → Import from cURL…, e cole. ⌘↵ analisa e mostra uma prévia; ⌘⇧↵ importa.
O Mariner entende comandos multilinha com continuações \ e as flags que importam: -X, -H, -d / --data-raw / --data-binary, --data-urlencode, -F (com arquivos), -G, -u, -b, -A, -e, --url. As flags sem equivalente — -k, -L, --compressed, -o — são ignoradas. Um body sem -X vira POST; o tipo de body é detectado pelo content type e pela forma.
Um header Authorization ou um -u usuário:senha é promovido para a aba Auth da requisição, e a credencial vai direto para as Chaves em vez de virar uma linha de header.
Do Postman
⌘⇧O → cole o JSON ou escolha o arquivo. O Mariner lê Collection v2.1 (v2.0 na medida do possível) e cria uma coleção nova no workspace atual com:
- pastas, recursivamente;
- método, URL, headers, query, variáveis de path e body de cada requisição, incluindo as partes de arquivo multipart;
- auth no nível da coleção e overrides por pasta, com os segredos enviados para as Chaves.
Os arquivos de ambiente do Postman não são importados — recrie-os como ambientes do workspace; costumam ser um punhado de chaves. Veja Configurar ambientes.
De um documento OpenAPI
File → Import OpenAPI Spec… aceita OpenAPI 3.0 / 3.1 em JSON (YAML não é suportado). Você recebe uma coleção com o nome da API, uma pasta por tag (as operações sem tag caem em Uncategorized) e uma requisição por operação com o primeiro exemplo de body JSON. Os esquemas de segurança viram auth no nível da coleção.
Todas as URLs são montadas como {{baseUrl}} + caminho, com as {chaves} convertidas em variáveis de path. Adicione uma variável baseUrl ao ambiente do workspace com a URL de servidor do documento e a coleção inteira aponta para ela.
De outro Mariner
File → Import Mariner Collection… e escolha o pacote .mariner (uma pasta). A prévia mostra a contagem de requisições, pastas e ambientes antes de confirmar. Os segredos nunca vão dentro de um pacote — digite de novo os tokens de auth depois de importar. A extensão antiga .nvapi continua funcionando.
Saídas
- Export as Mariner… (⌘⇧X) — o formato de pacote descrito em Formato de arquivos. Sem segredos.
- Export as Postman… — um arquivo de coleção v2.1. Sem segredos, incluindo o client secret do OAuth.
- Copy as cURL (⌘⌥C) — uma requisição para a área de transferência, com a auth herdada resolvida. Inclui as credenciais reais, então cole com cuidado.
- Generate Code… (⌘⇧C) — cURL, JavaScript (fetch ou axios), Python requests, Swift URLSession, Go net/http. As variáveis são resolvidas por padrão; os segredos ficam mascarados a menos que você ligue Include secrets.
- Export HAR — a partir do Histórico, um arquivo HAR 1.2 com as execuções filtradas naquele momento.