# Formato de archivos

> Cómo se ve en disco una exportación de Mariner, para que puedas commitearla, compararla y revisarla como código.

## El paquete `.mariner`

**Export as Mariner…** (<kbd>⌘⇧X</kbd>) escribe una carpeta — un paquete de macOS — de pequeños archivos JSON, uno por petición, de modo que un cambio en una petición es un diff de un solo archivo en git.

```text
Orders API.mariner/
  mariner.json                 manifiesto: nombre, descripción, árbol ordenado
  collection-auth.json         solo cuando la colección define su propia auth
  environments/
    Orders API Variables.json
  requests/
    Auth/
      _folder.json             metadatos de la carpeta, opcional
      Login.json
    Orders/
      List orders.json
      Create order.json
```

- **`mariner.json`** lleva la `version` del formato (actualmente 1), el nombre y la descripción de la colección, y el `tree` — el orden exacto de carpetas y peticiones en la barra lateral.
- **Un archivo de petición** contiene el nombre, método, URL, cabeceras, parámetros de query, variables de path, body (tipo más texto o filas de formulario), auth, variables locales, reglas de captura, timeout y el [contrato](/es/docs/contracts) de la respuesta — la clave `contractSchema` solo se escribe cuando hay uno. Las variantes de body guardadas todavía no están en el formato; se quedan en el Mac que las escribió y viajan por la sincronización con iCloud.
- **Los secretos nunca se escriben.** Una variable secreta conserva su clave y su flag `secret` con el valor vacío; las credenciales de auth no están en el archivo en absoluto. Quien importa el paquete las rellena.
- Los entornos del workspace no forman parte de un paquete de colección — pertenecen al workspace. Compártelos aparte o recréalos; ver [Configurar entornos](/es/docs/environments).

Importa con **File → Import Mariner Collection…** y elige la carpeta. Los paquetes escritos antes del cambio de nombre, con extensión `.nvapi` y manifiesto `nvapi.json`, siguen importándose.

## Exportación a Postman

**Export as Postman…** escribe `‹Nombre›.postman_collection.json`, formato Collection v2.1: carpetas, peticiones, bodies, auth de colección y de carpeta — con todos los valores secretos y el client secret de OAuth en blanco.

## HAR

**Export HAR** en el [Historial](/es/docs/system#historial) escribe un archivo HAR 1.2 (`‹workspace›.har`) con las ejecuciones que se muestran en ese momento, incluidos timings y bodies tal como se guardaron (los bodies de más de 1 MB van recortados y marcados).

## Informes del runner

El runner de colecciones exporta **JSON** — título, `generatedAt` en ISO 8601, totales, milisegundos transcurridos, si la ejecución se canceló y un elemento por petición — o **CSV** con las columnas `name, method, url, status, durationMs, error, capturedKeys, contract`. Ambos están descritos en [Runner](/es/docs/runner).

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