# Formato de arquivos

> Como uma exportação do Mariner fica em disco, para você commitar, comparar e revisar como código.

## O pacote `.mariner`

**Export as Mariner…** (<kbd>⌘⇧X</kbd>) 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.

```text
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](/pt-br/docs/contracts) 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](/pt-br/docs/environments).

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](/pt-br/docs/system#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](/pt-br/docs/runner).

---
Source: https://marinerhttp.dev/pt-br/docs/file-format · Mariner docs