Formato de archivos

El paquete .mariner

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

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 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.

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 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.