Lección 6 de 6 · 2 min
Newman + CI: la colección que corre sola
Al terminar sabrás
11 min- Exportar una colección y correrla desde la terminal con Newman
- Generar un reporte HTML de la ejecución
- Automatizar la colección en GitHub Actions en cada push
Construyes: Tu colección de API corriendo en CI, con reporte y check rojo cuando algo falla.
Del clic al pipeline
Ya tienes una colección con variables, requests encadenados, aserciones y datos. Corre perfecto cuando aprietas "Run" en Postman. Pero una prueba que depende de que un humano apriete un botón no es automatización. Newman es el runner de línea de comandos de Postman: corre esas mismas colecciones desde la terminal, y por lo tanto, desde un pipeline de CI.
Instalar y correr
Exporta tu colección (y tu entorno) desde Postman como archivos .json. Luego:
npm install -g newman newman-reporter-htmlextra
newman run coleccion.json -e entorno.json
Verás el resultado en la terminal: cada request, cada aserción en verde o rojo, y un resumen final. Si algo falla, Newman termina con código de salida ≠ 0 — la señal que CI necesita para poner el check en rojo.
Reporte HTML y datos
newman run coleccion.json \
-e entorno.json \
-d telefonos.csv \
-r cli,htmlextra
-d telefonos.csvcorre la colección una vez por fila (data-driven de la lección 5).-r cli,htmlextragenera el resumen en terminal y un reporte HTML navegable con cada request, tiempo y aserción.
Ese HTML es evidencia lista para compartir con el equipo.
En GitHub Actions
# .github/workflows/api.yml
name: API Tests
on: [push, pull_request]
jobs:
newman:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with: { node-version: "20" }
- run: npm install -g newman newman-reporter-htmlextra
- run: newman run coleccion.json -e entorno.json -r cli,htmlextra
- uses: actions/upload-artifact@v4
if: always()
with:
name: reporte-api
path: newman/
Cada push ejecuta la colección completa. Si una aserción falla, el job queda rojo y (con if: always()) igual subes el reporte HTML para diagnosticar.
Cierre del curso
Fundamentos, requests, colecciones, variables, encadenamiento, aserciones, data-driven y CI: tienes el stack completo de API testing. El siguiente paso natural es sumarlo a tu automatización e2e —Playwright también prueba APIs— y practicar en el playground de automatización.
Comprueba lo aprendido en el quiz y lleva tu colección a CI en el reto final.
Compruébalo
0/3Responde sin mirar atrás. Verás la explicación al instante.
1. ¿Qué es Newman?
2. ¿Qué comando corre una colección con un archivo de datos y genera reporte HTML?
3. Un test de la colección falla en CI. ¿Qué debería pasar en el pipeline?
Reto final: tu API en CI
Exporta tu colección y tu entorno desde Postman. Instala Newman (npm i -g newman) y córrela localmente con reporte HTML.
Luego crea un workflow de GitHub Actions que la ejecute en cada push y suba el reporte como artefacto.