Formato de arquivos

O pacote .mariner

Export as Mariner… (⌘⇧X) escreve uma pasta — um pacote do macOS — de pequenos arquivos JSON, um por requisição, de modo que uma mudança em uma requisição é um diff de um arquivo só no git.

Orders API.mariner/
  mariner.json                 manifesto: nome, descrição, árvore ordenada
  collection-auth.json         só quando a coleção define a própria auth
  environments/
    Orders API Variables.json
  requests/
    Auth/
      _folder.json             metadados da pasta, opcional
      Login.json
    Orders/
      List orders.json
      Create order.json

• mariner.json leva a version do formato (hoje 1), o nome e a descrição da coleção, e a tree — a ordem exata de pastas e requisições na barra lateral.
• Um arquivo de requisição contém o nome, método, URL, headers, parâmetros de query, variáveis de path, body (tipo mais texto ou linhas de formulário), auth, variáveis locais, regras de captura, timeout e o contrato da resposta — a chave contractSchema só é escrita quando existe um. As variantes de body salvas ainda não estão no formato; ficam no Mac que as escreveu e viajam pela sincronização com o iCloud.
• Os segredos nunca são escritos. Uma variável secreta mantém a chave e a flag secret com o valor vazio; as credenciais de auth não estão no arquivo de jeito nenhum. Quem importa o pacote preenche.
• Os ambientes do workspace não fazem parte de um pacote de coleção — eles pertencem ao workspace. Compartilhe à parte ou recrie; veja Configurar ambientes.

Importe com File → Import Mariner Collection… e escolha a pasta. Os pacotes escritos antes da troca de nome, com extensão .nvapi e manifesto nvapi.json, continuam sendo importados.

Exportação para o Postman

Export as Postman… escreve ‹Nome›.postman_collection.json, formato Collection v2.1: pastas, requisições, bodies, auth de coleção e de pasta — com todos os valores secretos e o client secret do OAuth em branco.

HAR

Export HAR no Histórico escreve um arquivo HAR 1.2 (‹workspace›.har) com as execuções mostradas naquele momento, incluindo timings e bodies como foram guardados (bodies acima de 1 MB vão cortados e marcados).

Relatórios do runner

O runner de coleções exporta JSON — título, generatedAt em ISO 8601, totais, milissegundos decorridos, se a execução foi cancelada e um item por requisição — ou CSV com as colunas name, method, url, status, durationMs, error, capturedKeys, contract. Os dois estão descritos em Runner.