Durante años, ejecutar colecciones de Postman fuera de la aplicación de escritorio significaba una única herramienta: Newman. Luego, Postman lanzó su propia herramienta oficial de línea de comandos, el Postman CLI, y ahora hay dos maneras de hacer prácticamente lo mismo. Ambas ejecutan colecciones sin la GUI, ambas se ajustan a los pipelines de CI/CD, y ambas ejecutan los mismos scripts de prueba. Entonces, ¿por qué dos herramientas, y cuál de ellas debería estar en tu pipeline?
La versión corta: Newman es el ejecutor de código abierto y sin cuenta que ha sido el estándar de la comunidad desde los primeros días. Postman CLI es la herramienta más nueva, vinculada a la cuenta, que conecta las ejecuciones con la nube de Postman e informa los resultados allí. La elección correcta depende de si deseas que los resultados se almacenen en la plataforma de Postman o prefieres un ejecutor que no necesite nada más que un archivo de colección. Este artículo los compara honestamente para que puedas decidir.
Qué es Newman
Newman es el ejecutor de colecciones de línea de comandos original de Postman. Es de código abierto, se distribuye como un paquete npm y es completamente gratuito. Ejecuta archivos de colección exportados de Postman, ejecuta cada solicitud y cada aserción pm.test, e informa el resultado a través de su código de salida.
El rasgo distintivo de Newman es la independencia. No requiere una cuenta de Postman, una clave API o una conexión de red a los servidores de Postman. Le entregas un archivo de colección JSON y lo ejecuta. Eso lo hace predecible y fácil de entender en entornos restringidos.
npm install -g newman
newman run checkout-api.postman_collection.json \
--environment staging.postman_environment.json
Newman también es ligero y extensible. Viene con reportes CLI y JUnit, y la comunidad mantiene reportes adicionales como newman-reporter-htmlextra para una salida HTML rica. Debido a que es un paquete de Node.js, también puedes llamarlo programáticamente desde un script. Nuestra guía sobre la diferencia entre Newman y Postman cubre cómo se relaciona con la aplicación de escritorio.
Qué es Postman CLI
Postman CLI es la herramienta oficial de línea de comandos que Postman construyó y ahora recomienda. Es un único binario que se instala con un script, no un paquete npm, y está vinculado a tu cuenta de Postman a través de una clave API.
# instalar (ejemplo para macOS/Linux)
curl -o- "https://dl-cli.pstmn.io/install/osx_64.sh" | sh
# autenticar, luego ejecutar
postman login --with-api-key YOUR_API_KEY
postman collection run checkout-api
La diferencia clave es el enlace a la nube. Cuando ejecutas una colección con Postman CLI, puede extraer la colección directamente de tu espacio de trabajo de Postman por ID, y envía los resultados de la ejecución de vuelta a la plataforma de Postman, donde aparecen en el historial del espacio de trabajo y los paneles de control. El gran punto de venta es la gobernanza de API y las comprobaciones de seguridad: Postman CLI puede ejecutar linting contra tus definiciones de API durante un pipeline, mostrando violaciones de esquemas y reglas como parte de la compilación.
Así, Postman CLI es menos un ejecutor de colecciones puro y más un agente de pipeline para la plataforma de Postman. Si tu equipo trabaja dentro de la nube de Postman y desea que el historial de ejecuciones y la gobernanza estén centralizados allí, esa integración es la razón para elegirlo.
Comparación lado a lado
| Aspecto | Postman CLI | Newman |
|---|---|---|
| Fuente | Código cerrado, herramienta oficial de Postman | Código abierto |
| Instalación | Script de instalación, binario único | Paquete npm |
| Cuenta de Postman | Requerida (inicio de sesión con clave API) | No requerida |
| Fuente de la colección | Extrae de la nube de Postman por ID, o archivo local | Archivo JSON local |
| Resultados de la ejecución | Reportados de vuelta a la plataforma de Postman | Salida de terminal y archivos de reportes |
| Gobernanza/linting de API | Integrado | No incluido |
| Reportes | Limitados, los resultados residen en Postman | CLI, JUnit, además de reportes HTML de la comunidad |
| Uso sin conexión | Limitado, diseñado en torno a la nube | Completamente sin conexión una vez que el archivo es local |
| Madurez | Más reciente | Estándar de la comunidad de larga data |
| Costo | Gratuito, pero vinculado a los límites de un plan de Postman | Gratuito, sin cuenta |
El eje decisivo es la nube de Postman. Postman CLI está diseñado para enviar resultados y gobernanza a la plataforma de Postman. Newman está diseñado para ejecutar un archivo e informar localmente, sin depender de los servidores de Postman.
Cómo encajan en CI/CD
Ambas herramientas funcionan en cualquier proveedor de CI, incluyendo Jenkins, GitHub Actions, GitLab CI y CircleCI. La mecánica difiere.
Con Newman, confirmas los archivos JSON de la colección y el entorno en tu repositorio, instalas Newman en el trabajo, lo ejecutas y dejas que el código de salida no cero falle la compilación en caso de un error de prueba. Todo está autocontenido en el repositorio y el pipeline. Nuestras guías sobre automatización de pruebas API en CI/CD y automatización de pruebas API con GitHub Actions muestran este patrón.
Con Postman CLI, almacenas una clave API de Postman como secreto en el proveedor de CI, te autenticas y ejecutas la colección por su ID. La colección se extrae de la nube de Postman en lugar del repositorio, y los resultados se publican de nuevo en el espacio de trabajo. Esto mantiene la fuente de verdad en Postman, lo que algunos equipos prefieren y otros encuentran limitante.
Una diferencia práctica: Newman mantiene las pruebas versionadas con tu código, ya que el JSON de la colección se encuentra en el repositorio. Postman CLI mantiene las pruebas versionadas en la plataforma de Postman, ya que las extrae por ID. Decide qué fuente de verdad desea tu equipo antes de elegir.
El ángulo de la gobernanza
La característica única que más claramente separa las dos herramientas es la gobernanza de la API. Postman CLI puede ejecutar una comprobación de estilo postman api lint contra una definición de API almacenada en tu espacio de trabajo de Postman, evaluándola contra reglas de nomenclatura, seguridad, completitud del esquema y consistencia. Cuando esa comprobación se ejecuta dentro de un pipeline, una definición que viola una regla falla la compilación antes de que el cambio se fusione.
Newman no tiene un equivalente. Ejecuta colecciones e informa los resultados de las pruebas, y ese es el límite de su trabajo. Si tu organización se preocupa por hacer cumplir los estándares de diseño de API automáticamente, esa capacidad solo existe en Postman CLI, y es una razón real para elegirlo. Si no haces cumplir las reglas de diseño en el pipeline, la característica es irrelevante y la simplicidad de Newman gana.
Vale la pena ser honesto al respecto porque replantea la comparación. Postman CLI no es solo "Newman, pero más nuevo". Es un tipo diferente de herramienta: un agente de pipeline para la plataforma de Postman que, por casualidad, incluye un ejecutor de colecciones. Newman es, y solo es, un ejecutor de colecciones. Una vez que lo ves de esa manera, la elección se trata menos de características y más de si deseas que tus pruebas estén vinculadas a la plataforma de Postman en absoluto.
Consideraciones de migración
Los equipos que ya usan Newman a veces se preguntan si deberían cambiarse a Postman CLI. Raramente hay una razón sólida para hacerlo. Newman sigue siendo mantenido, sigue siendo gratuito y sigue funcionando en todos los proveedores de CI. Cambiar significa añadir una clave API como secreto de CI, cambiar la forma en que se obtienen las colecciones y aceptar una dependencia de la nube de Postman. A menos que desees específicamente un historial de ejecución centralizado o verificaciones de gobernanza, los costos de migración superan los beneficios.
Los equipos que empiezan de nuevo se enfrentan a una elección más interesante. Si el equipo está comprometido con Postman como su herramienta principal y paga por un plan, Postman CLI mantiene todo en un solo ecosistema y es la elección natural. Si el equipo desea flexibilidad, pruebas versionadas en el repositorio y libertad de la nube de un solo proveedor, Newman, o una herramienta que no sea de Postman, tiene más sentido. No hay una respuesta universalmente correcta; solo hay la respuesta que coincide con la forma en que tu equipo ya trabaja.
Cuál deberías elegir
Elige Newman si deseas un ejecutor sin dependencia de cuenta, si quieres que las pruebas estén versionadas en tu repositorio, si necesitas informes HTML enriquecidos a través de reporteros de la comunidad, o si ejecutas en entornos restringidos donde no se permite llamar a la nube de Postman. La independencia y madurez de Newman lo convierten en la opción predeterminada segura para la mayoría de los pipelines.
Elige Postman CLI si tu equipo vive dentro de la plataforma de Postman, si deseas que el historial de ejecución y los paneles de control estén centralizados allí, o si la gobernanza de API y el linting de definiciones en el pipeline son valiosos para ti. Su estrecha integración en la nube es una ventaja genuina para los equipos centrados en Postman.
Si estás sopesando esta decisión, vale la pena preguntarse si quieres estar vinculado al ecosistema de Postman en absoluto. Para otros enfoques, consulta nuestra guía sobre ejecutar colecciones de Postman en CI sin Newman y nuestra visión más amplia de las pruebas de API sin Postman.
Una alternativa de herramienta única: Apidog
Tanto Postman CLI como Newman asumen que creaste tus pruebas en Postman. Apidog elimina esa división. Diseñas APIs, depuras solicitudes y construyes escenarios de prueba automatizados con aserciones visuales en una sola aplicación, y luego ejecutas esos escenarios en CI/CD con el ejecutor de línea de comandos integrado. No hay un paso de exportación ni un paquete de ejecutor separado, porque las definiciones de prueba y el motor de ejecución son el mismo producto.
Apidog también incorpora el diseño de API, servidores simulados y pruebas de rendimiento, para que un equipo pueda cubrir todo el ciclo de vida de la API sin tener que unir herramientas. Puedes descargar Apidog y usar sus funciones de prueba de forma gratuita, incluido el ejecutor CLI para pipelines.
Preguntas frecuentes
¿Postman CLI está reemplazando a Newman?
Postman posiciona a Postman CLI como su herramienta de línea de comandos oficialmente recomendada, pero Newman sigue siendo mantenido y ampliamente utilizado. Newman sigue siendo la mejor opción cuando deseas un ejecutor sin cuenta y con versiones en el repositorio. Es probable que ambos coexistan durante algún tiempo, por lo que no hay una necesidad urgente de migrar.
¿Postman CLI requiere una cuenta de Postman?
Sí. Postman CLI se autentica con una clave API de Postman y está diseñado para conectar las ejecuciones de vuelta a tu espacio de trabajo de Postman. Newman, por el contrario, no necesita una cuenta y se ejecuta puramente desde un archivo de colección local.
¿Qué herramienta ofrece mejores informes?
Newman tiene informes más flexibles a través de los reporteros de la comunidad, especialmente newman-reporter-htmlextra para una salida HTML detallada y JUnit XML para paneles de control de CI. Postman CLI informa los resultados directamente en la plataforma de Postman, lo cual es conveniente si tu equipo trabaja allí, pero menos flexible para archivos de informe independientes.
¿Puede Postman CLI ejecutar un archivo de colección local?
Postman CLI puede ejecutar colecciones desde archivos locales, pero está diseñado para extraer colecciones de la nube de Postman por ID y reportar los resultados. Si deseas una herramienta que trate un archivo JSON local como la fuente de la verdad sin involucrar la nube, Newman se ajusta a ese modelo de forma más natural.
¿Cuál es más rápido en CI?
Para la ejecución pura de colecciones, la diferencia es pequeña y depende del tamaño de la colección y las condiciones de la red. Newman tiene una huella más pequeña y no realiza viajes de ida y vuelta a la nube. Postman CLI añade la sobrecarga de la autenticación y la sincronización de resultados con la plataforma. Para la mayoría de los pipelines, elige basándote en la adaptación al flujo de trabajo en lugar de la velocidad bruta.