Postman Collection Runner: Restricciones, novedades y soluciones

TL;DR

Postman restringió el acceso a Collection Runner en su nivel gratuito, interrumpiendo la ejecución automatizada de pruebas para los equipos que no se habían actualizado. Esto afecta las ejecuciones de pruebas locales, las tuberías CI/CD y cualquier flujo de trabajo que utilizara Runner para la ejecución masiva de solicitudes. Este artículo explica qué cambió, qué interrumpe en la práctica y cómo funciona el runner de Apidog sin restricciones en ningún plan.

Introducción

Collection Runner de Postman era una de sus características más utilizadas. Construías una colección de 50 solicitudes de API, hacías clic en "Ejecutar colección" y veías cómo Postman las ejecutaba en secuencia, con paso de variables entre solicitudes, aserciones de prueba en cada respuesta y un informe resumido al final. Para los desarrolladores que probaban flujos complejos de varios pasos, era esencial.

Luego vinieron las restricciones de 2026. Como parte de la reducción del nivel gratuito, Postman limitó el acceso a Collection Runner. Las cuentas gratuitas ya no pueden ejecutar colecciones más allá de un cierto número de solicitudes por mes, y algunas características de Runner ahora están completamente detrás de un muro de pago.

El impacto se hizo evidente rápidamente en los flujos de trabajo de los desarrolladores. Los equipos que tenían tuberías de CI que dependían de Newman (el runner CLI de Postman) comenzaron a alcanzar límites. Los desarrolladores que ejecutaban pruebas de humo previas a la implementación en Collection Runner encontraron la función atenuada o restringida.

Lo que Postman cambió en Collection Runner

El nivel gratuito de Postman ahora restringe Collection Runner de dos maneras principales:

Límites de ejecución mensuales. Las cuentas gratuitas tienen un tope en la cantidad de ejecuciones de Collection Runner que pueden realizar por mes. Postman no ha publicado el número exacto claramente, pero los informes de la comunidad lo sitúan en unas 25 ejecuciones por mes. Para los desarrolladores que ejecutan pruebas varias veces al día, este límite se alcanza en pocos días.

Restricciones de Newman CLI. Newman, la herramienta CLI de código abierto que le permite ejecutar colecciones de Postman en entornos de terminal y CI, anteriormente funcionaba con cualquier exportación de colección de Postman sin alcanzar los límites del plan. Después de 2026, algunas características de Newman se vinculan al nivel de plan de su cuenta de Postman cuando se utilizan colecciones sincronizadas en la nube.

Ejecución de pruebas sin código. El Collection Runner visual, accesible desde la barra lateral, muestra un estado con muro de pago en las cuentas gratuitas después de que se alcanza el límite de ejecución.

Lo que no está restringido: la ejecución individual de solicitudes manualmente (haciendo clic en "Enviar" en una sola solicitud) sigue siendo ilimitada. Las restricciones se dirigen específicamente a la ejecución automatizada por lotes.

Qué se rompe en la práctica

Pruebas de humo pre-commit y pre-implementación

Muchos equipos ejecutan un pase de Collection Runner antes de fusionar una PR o implementar en staging. Si tuvieras 30 solicitudes en tu colección de pruebas de humo, un equipo de tres desarrolladores, cada uno ejecutándola dos veces al día, agotaría el límite mensual gratuito de Postman en unos dos días.

Tuberías CI/CD

Las tuberías CI basadas en Newman son las más afectadas. Un flujo de trabajo de GitHub Actions como este:

- name: Run API tests
  run: newman run ./collections/api-tests.json -e ./environments/staging.json

Comenzará a fallar o a encontrar errores de velocidad una vez que se alcance el límite de la cuenta. Esto es especialmente perjudicial para los equipos con múltiples tuberías que se activan con cada push.

Suites de pruebas de extremo a extremo

Algunos equipos construyeron flujos de trabajo API de varios pasos en Postman que encadenaban solicitudes, pasando la salida de una solicitud (como un token de autenticación) a la siguiente. Collection Runner maneja esto a través del patrón pm.environment.set(). Con Runner restringido, estos flujos de trabajo solo pueden probarse recorriendo manualmente las solicitudes una por una.

Pruebas de carga y rendimiento

El Collection Runner de Postman tiene una opción de "retraso" e "iteraciones" que permite ejecutar una colección varias veces en secuencia, útil para pruebas de carga básicas. Con los límites de ejecución establecidos, este caso de uso desaparece efectivamente en el nivel gratuito.

Soluciones inmediatas dentro de Postman

Si aún no estás listo para cambiar de herramientas, existen algunas soluciones dentro del ecosistema de Postman.

Exportar a Newman y ejecutar localmente. Newman se ejecuta con un archivo JSON de colección exportado localmente sin necesidad de iniciar sesión en una cuenta de Postman, siempre que no uses funciones que se conecten a la nube. Exporta tu colección y entorno, luego ejecuta Newman completamente sin conexión:

newman run collection.json -e environment.json

Esto anula el límite de ejecución de la cuenta de Postman porque Newman está leyendo un archivo local. La limitación es que pierdes la sincronización con tu espacio de trabajo de Postman en vivo, por lo que debes reexportar cada vez que la colección cambie.

Dividir colecciones grandes en trozos más pequeños. Si estás cerca del límite mensual, dividir una colección de 100 solicitudes en cuatro colecciones de 25 solicitudes significa que cada una utiliza un contador de ejecución separado. Esta es una solución alternativa, no una solución, y rompe el flujo lógico de las pruebas de varios pasos.

Actualizar selectivamente. Si solo un miembro del equipo ejecuta la tubería de CI, tener esa cuenta en un plan de pago mientras los demás permanecen gratuitos es más barato que actualizar a todos. La cuenta de pago ejecuta Newman sin límites; los demás utilizan pruebas manuales.

Cómo funciona de manera diferente el Collection Runner de Apidog

El runner de Apidog, llamado "Escenarios de prueba" (Test Scenarios) o accesible a través del botón "Ejecutar" en cualquier colección, no tiene límites de ejecución mensuales en ningún plan. Esto incluye el nivel gratuito.

Así es como se compara con lo que Postman restringió:

El runner CLI de Apidog (apidog-cli) se integra con CI/CD de la misma manera que Newman. La estructura del comando es similar:

apidog run {project-id} --collection {collection-id} --environment {env-id}

También puedes exportar una colección de Apidog y ejecutarla sin conexión, de forma similar al enfoque de archivo local de Newman, pero sin tener que preocuparte por las restricciones basadas en la cuenta.

Configurando el runner de Apidog en tu tubería de CI

Si estás migrando una tubería basada en Newman a Apidog, así es como se ve la transición en GitHub Actions.

Antes (Newman):

- name: Install Newman
  run: npm install -g newman

- name: Run API tests
  run: newman run ./collections/api-tests.json -e ./environments/staging.json --reporters cli,json --reporter-json-export results.json

Después (Apidog CLI):

- name: Install Apidog CLI
  run: npm install -g apidog-cli

- name: Run API tests
  run: apidog run --project {project-id} --env {env-id} --output results.json
  env:
    APIDOG_ACCESS_TOKEN: ${{ secrets.APIDOG_ACCESS_TOKEN }}

Las principales diferencias son el mecanismo de autenticación (Apidog usa un token de acceso en lugar de una clave API de Postman) y la referencia basada en proyectos en lugar de una ruta de archivo local. Ambos admiten la salida JSON para informar los resultados de las pruebas.

Alternativamente, si prefieres seguir usando la interfaz familiar de Newman, puedes exportar una colección de Apidog como un JSON compatible con Postman y seguir ejecutando Newman con ella. Esto te brinda el enfoque sin conexión y sin necesidad de cuenta mientras trabajas con Apidog en el día a día.

Funciones avanzadas del runner en Apidog

Además de igualar el conjunto de características restringidas de Postman, el runner de Apidog añade algunas capacidades que vale la pena conocer.

Pruebas basadas en datos. Importa un archivo CSV o JSON en una ejecución de prueba para ejecutar la misma colección con diferentes conjuntos de datos. Cada fila se convierte en una iteración. Esto es equivalente a la función de archivo de datos de Postman, que también está detrás de un muro de pago en los niveles superiores de Postman.

Recuentos de iteraciones personalizados. Establece un número específico de iteraciones para una ejecución de prueba sin preocuparte por un contador mensual. Ejecuta tu colección 500 veces para una prueba de estrés básica si es necesario.

Integración de Smart Mock. Mientras el runner se está ejecutando, puede interactuar con el servidor de mocks incorporado de Apidog. Esto significa que puedes ejecutar pruebas contra endpoints simulados sin levantar un servidor separado, lo cual es útil al probar código de cliente contra una API que aún no está construida.

Ejecuciones programadas. Configura ejecuciones de prueba automáticas en un horario (cada hora, diario, etc.) directamente en Apidog sin necesidad de trabajos cron externos o disparadores de CI. Los resultados aparecen en el historial de pruebas de tu proyecto.

Las restricciones de Collection Runner de Postman son un obstáculo práctico para los equipos que construyeron tuberías de CI y flujos de trabajo de pruebas automatizadas en el nivel gratuito. El camino más directo a seguir es cambiar a un runner sin límites de uso. El runner de Apidog cubre todos los casos de uso que el nivel gratuito de Postman restringía, y la integración CLI funciona en las configuraciones de tuberías existentes con un pequeño cambio de configuración.