Si vienes de Postman

Echolot lee las colecciones y los entornos de Postman tal como son, scripts incluidos. En este tutorial importas una colección, ves dónde fue a parar cada parte, la ejecutas y exportas un espacio de trabajo de vuelta a Postman.

• Tiempo: 15 minutos.
• Necesitas: una colección de Postman (v2.0 o v2.1) y sus entornos, exportados como JSON. ¿No tienes ninguna a mano? Crea una a partir de Alpenglow en el paso 1.
• Aprendes: importar, qué equivale a qué, confiar en los scripts importados, ejecutar una colección importándola o no, y exportar.

1. Consigue una colecciónCopy Anchor Link

Desde Postman: abre el menú ⋯ de la colección, elige Export y deja Collection v2.1. Exporta cada entorno de la misma manera desde su propio menú.

Para practicar con Alpenglow en su lugar:

1. Abre el espacio de trabajo Alpenglow y elige Archivo › Exportar espacio de trabajo… (⇧⌘E).
2. Elige Postman Collection v2.1. Su fila dice que caben 21 de las 29 solicitudes: las colecciones de Postman no tienen solicitudes de WebSocket, Socket.IO, MQTT, gRPC ni MCP, así que esas se quedan fuera.
3. Deja activado Incluir entornos (3) y elige Exportar…. Con entornos, la exportación es una carpeta de archivos: ponle nombre y elige Exportar.

La carpeta contiene Alpenglow.postman_collection.json y un .postman_environment.json por entorno. El informe lista lo que quedó Omitido y lo que Cambiado por el camino: las comprobaciones de Echolot pasaron a ser scripts pm.test(), las capturas de respuesta no se exportan y las variables secretas salen solo por su nombre, sin sus valores.

2. ImpórtalaCopy Anchor Link

1. Crea un espacio de trabajo nuevo: Archivo › Nuevo espacio de trabajo… (⌥⌘N), llamado From Postman.

2. Elige Archivo › Importar… (⇧⌘I). Selecciona la colección y los archivos de entorno juntos y elige Importar.

   También puedes arrastrar los archivos a la ventana, o copiar el JSON de una colección y pegarlo en la barra lateral (⌘V).

3. El informe, Importado …, lista cada archivo con su formato (Colección de Postman v2.1, Entorno de Postman) y lo que entró. Las notas dicen lo que no pudo entrar tal como era.

Para la exportación de Alpenglow, las notas dicen que se importaron 19 scripts de pruebas y que se ejecutarán cuando confíes en ellos, y que 2 valores secretos se guardaron en el llavero, no en los archivos del espacio de trabajo: la contraseña de la demo y el secreto de cliente de OAuth, que estaban escritos en la colección. Ahora las solicitudes se refieren a ellos como {{password}} y {{orders_with_oauth_2_clientSecret}}. Elige Mostrar en la barra lateral.

3. OriéntateCopy Anchor Link

Los cuerpos de archivo y los campos de archivo de form-data no entran, porque el archivo está en otro ordenador: el informe nombra cada uno, para que puedas volver a elegir el archivo en la pestaña Cuerpo.

4. Confía en los scriptsCopy Anchor Link

Los scripts pueden hacer todo lo que puede hacer un script, así que los importados no se ejecutan hasta que lo digas.

1. Abre una solicitud que tenga un script de pruebas, como Catalog › List products, y su pestaña Scripts. Un aviso dice Estos scripts vienen de fuera de Echolot.
2. Lee el script y elige Confiar en los scripts. Si envías primero, Echolot pregunta, y Confiar y enviar confía y envía al instante.
3. Envía. Los resultados de pm.test() del script aparecen en la pestaña Pruebas de la respuesta, bajo Scripts.

Los scripts se ejecutan en el sandbox de JavaScript propio de Echolot, no en Node. Consulta scripts y pruebas y la API de scripts.

5. EjecútalaCopy Anchor Link

1. Elige en la cabecera de la página el entorno que importaste, como Staging, o Sin entorno para la API de demostración de Alpenglow.
2. Haz clic derecho en la carpeta de la colección y elige Ejecutar carpeta. Ejecución ejecuta cada solicitud con sus scripts y comprobaciones.

La herramienta de línea de comandos ejecuta una colección sin importarla, como hace Newman. Allí los scripts se ejecutan sin preguntar:

echolot run Alpenglow.postman_collection.json --folder catalog --reporter console --reporter junit --out results.xml

--env-file admite un archivo de entorno de Postman, --folder el nombre de una carpeta en minúsculas y con guiones (catalog, agent-tools), y --data users.csv ejecuta una vez por fila. Los valores secretos vienen de variables de entorno ECHOLOT_SECRET_<NAME>.

6. Lo que funciona de otro modoCopy Anchor Link

• Todo es un archivo. Un espacio de trabajo es una carpeta de archivos TOML, uno por solicitud, lista para Git. No hay cuenta ni servicio de sincronización; los equipos comparten mediante Git. Consulta Git y equipos.
• Guardar es automático. No hay ⌘S; el pie de la barra lateral dice Todo guardado.
• Los secretos nunca van a archivos. El valor de una variable secreta vive en el llavero de este Mac; el archivo guarda solo su nombre.
• Comprobaciones sin código. La pestaña Pruebas comprueba el estado, las cabeceras, los valores JSON, el tiempo, un JSON Schema o una especificación OpenAPI sin ningún script. Consulta scripts y pruebas.
• Capturas sin código. En lugar de pm.environment.set("token", …) en un script de pruebas, deja el puntero sobre el valor de la respuesta y elige Guardar en una variable…. Consulta Encadenar solicitudes.
• Más que HTTP. El mismo espacio de trabajo contiene solicitudes de WebSocket, Socket.IO, MQTT, gRPC y MCP, especificaciones, mocks y flujos.

7. Exporta de vuelta a PostmanCopy Anchor Link

1. Elige Archivo › Exportar espacio de trabajo…, o haz clic derecho en una carpeta y elige Exportar carpeta….
2. Elige Postman Collection v2.1. La hoja dice cuántas solicitudes caben; WebSocket y los demás tipos de sesión se quedan fuera. Insomnia v5 también lleva WebSocket, Socket.IO y gRPC, y Colección de Bruno escribe una carpeta de archivos .bru.
3. Elige si quieres Incluir entornos, y después Exportar….

Las credenciales que escribiste en campos de autenticación o de cabeceras se escriben en claro, y el informe dice cuántas: pásalas antes a variables secretas. Las variables secretas salen por su nombre, sin sus valores. Consulta exportar.

Siguientes pasosCopy Anchor Link

• Tu primer espacio de trabajo: cómo se organiza un espacio de trabajo.
• Importar: también Insomnia, OpenAPI, HAR, cURL, Paw y Bruno.
• Probar una API y ejecutarla en CI: sustituye a Newman en tu pipeline.