DEV Community

Cover image for Cómo compartir colecciones de Postman sin el plan de equipo
Roobia
Roobia

Posted on • Originally published at apidog.com

Cómo compartir colecciones de Postman sin el plan de equipo

Resumen

El plan gratuito de Postman limita el uso compartido de colecciones de formas que sorprenden a muchos desarrolladores. Si necesitas colaborar con tu equipo sin pagar $19/usuario/mes, puedes usar algunas soluciones alternativas, pero todas tienen concesiones. El plan gratuito de Apidog permite compartir un espacio de trabajo con hasta 3 usuarios sin actualizar.

Prueba Apidog hoy

💡 Apidog es una plataforma gratuita todo en uno para el desarrollo de API. Cubre diseño, pruebas, mocking y documentación de API en una sola herramienta, con colaboración real integrada en el nivel gratuito. Puedes probarlo gratis, sin tarjeta de crédito.

Introducción

Postman comenzó como una extensión de Chrome para enviar solicitudes HTTP. Con los años se convirtió en una plataforma API completa, y su precio creció con ella. Hoy, los equipos que quieren compartir colecciones y colaborar en tiempo real necesitan un plan de pago.

Si diriges un equipo pequeño, una startup o un proyecto paralelo, pagar $19 por usuario al mes solo para compartir una colección puede ser difícil de justificar. Eso equivale a $228 por persona al año antes de lanzar una sola funcionalidad.

La buena noticia: todavía existen formas legítimas de compartir colecciones de Postman en el plan gratuito. No son tan fluidas como el plan Team, pero funcionan en ciertos escenarios. En esta guía verás cómo implementarlas, dónde fallan y cuándo conviene usar una alternativa gratuita con colaboración integrada.

Lo que realmente permite el plan gratuito de Postman

Antes de elegir una solución alternativa, revisa qué incluye el plan gratuito de Postman en 2024-2025:

  • 1 usuario por espacio de trabajo, sin edición compartida.
  • Hasta 3 espacios de trabajo públicos activos.
  • Espacios de trabajo personales ilimitados.
  • 1.000 llamadas a servidores mock al mes.
  • 1.000 llamadas de monitoreo al mes.
  • 25 ejecuciones de colecciones al mes en el corredor de la nube.

La limitación clave es esta: no puedes invitar compañeros de equipo a un espacio de trabajo privado en el plan gratuito. Los espacios de trabajo privados con colaboración requieren al menos el plan Básico a $19/usuario/mes.

Método 1: Exportar la colección como JSON y compartir el archivo

La alternativa más directa consiste en exportar la colección como JSON y enviarla a otra persona.

Cómo hacerlo

  1. Abre Postman.
  2. En la barra lateral izquierda, selecciona tu colección.
  3. Haz clic en el menú de tres puntos junto al nombre de la colección.
  4. Selecciona Exportar.
  5. Elige Collection v2.1.
  6. Guarda el archivo .json.
  7. Compártelo por correo, Slack, Google Drive u otra herramienta interna.

Tu compañero puede importarlo desde:

File > Import > arrastrar archivo JSON
Enter fullscreen mode Exit fullscreen mode

O desde el botón Import dentro de Postman.

Qué falla

Este flujo convierte la colección en una instantánea. Si después agregas un endpoint, corriges headers o cambias un body, la otra persona no lo verá automáticamente.

También debes exportar los entornos por separado. La colección no incluye todas las variables de entorno por defecto.

Flujo recomendado si usas este método:

1. Exportar colección
2. Exportar entorno
3. Compartir ambos archivos
4. Importar colección
5. Importar entorno
6. Validar variables antes de ejecutar requests
Enter fullscreen mode Exit fullscreen mode

El problema aparece cuando varias personas editan a la vez. No hay merge automático ni resolución de conflictos. Cada cambio debe reconciliarse manualmente.

Usa este método solo para entregas puntuales o colecciones estables.

Método 2: Usar un espacio de trabajo público

Postman permite crear espacios de trabajo públicos en el plan gratuito. Cualquier persona con acceso puede ver y bifurcar la colección.

Cómo configurarlo

  1. Crea un nuevo workspace en Postman.
  2. Selecciona visibilidad Public.
  3. Agrega la colección al workspace.
  4. Copia la URL del workspace.
  5. Compártela con tu equipo.

Tus compañeros pueden bifurcar la colección a sus propios espacios de trabajo y trabajar desde allí.

Qué falla

Público significa público. Cualquiera en internet puede ver la colección si tiene la URL o si la encuentra en la red pública de APIs de Postman.

No uses este método para:

  • APIs internas.
  • Entornos de staging.
  • Endpoints con datos sensibles.
  • Ejemplos de respuesta que incluyan tokens.
  • Colecciones con credenciales incrustadas.

Además, las bifurcaciones no se sincronizan automáticamente. Si actualizas la colección original, el resto del equipo debe traer los cambios manualmente. Tampoco hay colaboración directa sobre la colección original en el plan gratuito.

Este método sirve para proyectos open source o documentación pública. No es adecuado para flujos internos de equipo.

Método 3: Usar un repositorio Git como capa de sincronización

Otra opción es tratar el JSON exportado como un artefacto de código y guardarlo en Git.

Flujo de trabajo

  1. Una persona mantiene la colección principal en Postman.
  2. Después de cada cambio relevante, exporta la colección como JSON.
  3. Sube el archivo al repositorio compartido.
  4. El resto del equipo hace pull.
  5. Cada persona importa el JSON actualizado en su Postman local.

Ejemplo de estructura:

api/
├── postman/
│   ├── collection.json
│   └── environment.json
└── README.md
Enter fullscreen mode Exit fullscreen mode

Ejemplo de comandos:

git pull origin main
# Importar postman/collection.json manualmente en Postman
Enter fullscreen mode Exit fullscreen mode

Después de modificar la colección:

git add postman/collection.json
git commit -m "Actualiza colección de API"
git push origin main
Enter fullscreen mode Exit fullscreen mode

Qué falla

La importación puede sobrescribir cambios locales. Si alguien modificó su colección y no exportó esos cambios antes, puede perder trabajo.

También exige disciplina. Alguien debe recordar exportar y subir el JSON cada vez que cambia algo. En la práctica, el repositorio suele quedarse por detrás de la versión real usada en Postman.

Git aporta historial y una fuente de verdad, pero no elimina el paso manual de exportar/importar.

Este método tiene sentido si tu equipo ya trabaja con Git y necesita versionar colecciones, pero no resuelve la colaboración en tiempo real.

Método 4: Usar una cuenta “principal” compartida

Algunos equipos pequeños intentan saltarse el límite haciendo que todos usen la misma cuenta de Postman.

No es recomendable.

Este enfoque va contra los Términos de Servicio de Postman y genera problemas prácticos:

  • La cuenta puede bloquearse si se detectan credenciales compartidas.
  • Los cambios pueden sobrescribirse por conflictos de sincronización.
  • No hay trazabilidad por usuario.
  • No puedes saber quién cambió una request, variable o entorno.
  • El control de acceso desaparece.

Se menciona porque algunos equipos lo hacen, no porque sea una buena práctica.

Cómo Apidog maneja el uso compartido en el nivel gratuito

Apidog aborda el problema desde otro ángulo: su plan gratuito incluye hasta 3 miembros en un espacio de trabajo compartido, con sincronización en tiempo real.

Eso elimina los pasos manuales de:

exportar JSON -> enviar archivo -> importar -> revisar variables -> repetir
Enter fullscreen mode Exit fullscreen mode

Cuando cambias una definición de API en Apidog, tus compañeros ven el cambio desde el mismo espacio de trabajo. Todos trabajan sobre una fuente de verdad compartida.

Si ya usas Postman, puedes importar colecciones existentes. Apidog admite el formato Postman Collection v2.1, por lo que puedes migrar tus requests sin convertir todo manualmente.

Flujo básico:

1. Exporta tu colección desde Postman como Collection v2.1
2. Abre Apidog
3. Usa Importar
4. Selecciona el archivo JSON
5. Revisa requests, headers y variables
6. Invita hasta 3 miembros al workspace gratuito
Enter fullscreen mode Exit fullscreen mode

El plan gratuito también incluye:

  • Editor de diseño de API compatible con OpenAPI 3.0 y Swagger.
  • Smart Mock para generar respuestas realistas.
  • Ejecutor de pruebas sin límites mensuales de ejecución.
  • Documentación de API generada automáticamente desde tus definiciones.
  • Enfoque local-first, para que tus datos permanezcan en tu máquina salvo que elijas sincronizar.

Para equipos de 2 o 3 personas, el plan gratuito de Apidog puede cubrir el caso de colaboración que en Postman requiere un plan de pago.

Elegir el método correcto para tu situación

Usa esta tabla como guía rápida:

Situación Mejor enfoque
Entrega única, colección estable Exportar JSON y compartir el archivo
Proyecto de código abierto, sin datos sensibles Espacio de trabajo público de Postman
Equipo de desarrolladores, desarrollo activo Plan gratuito de Apidog
Ya en Git, quieres historial de versiones Flujo de trabajo de Git + exportación JSON

Si tu equipo está construyendo APIs activamente, las soluciones con JSON y Git resuelven el problema inmediato, pero añaden fricción continua. Cada exportación, importación y sincronización manual aumenta el riesgo de trabajar con una versión desactualizada.

Preguntas frecuentes

¿Puedo compartir una colección de Postman sin una cuenta?

Sí. Exporta la colección como archivo JSON y envíalo directamente. El destinatario puede importarlo sin una cuenta de Postman si usa un cliente de API compatible con el formato Postman Collection v2.1, incluido Apidog.

¿El plan Básico de Postman permite compartir en equipo?

Sí. El plan Básico a $19/usuario/mes permite colaboración en espacios de trabajo privados con múltiples usuarios. El plan gratuito no.

¿Qué es un espacio de trabajo público de Postman?

Es un workspace visible para cualquier persona en internet. Los visitantes pueden ver y bifurcar colecciones, pero no editar las originales. En el plan gratuito puedes crear hasta 3 espacios de trabajo públicos.

¿Se exportan mis variables de entorno con la colección?

No. Las variables de entorno se exportan por separado.

Pasos:

1. Ve a Environments
2. Abre el menú de tres puntos del entorno
3. Selecciona Export
4. Guarda el JSON
5. Comparte colección + entorno
Enter fullscreen mode Exit fullscreen mode

Si olvidas el entorno, las requests pueden fallar por variables faltantes.

¿Cuántos usuarios pueden compartir un espacio de trabajo en el plan gratuito de Apidog?

El plan gratuito de Apidog admite hasta 3 usuarios en un espacio de trabajo compartido con sincronización en tiempo real, sin necesidad de tarjeta de crédito.

¿Puedo importar mis colecciones existentes de Postman a Apidog?

Sí. Apidog admite la importación directa de archivos JSON de Postman Collection v2.1. Ve a Importar, selecciona el archivo y revisa la colección importada con sus solicitudes, headers y variables de entorno.

Conclusión

Las limitaciones de uso compartido del plan gratuito de Postman son reales. Puedes usar exportaciones JSON, workspaces públicos o Git, pero cada opción introduce trabajo manual o riesgos de sincronización.

Para equipos de hasta 3 personas que necesitan colaboración real, usar una herramienta con uso compartido incluido en el nivel gratuito suele ser más limpio que mantener un flujo basado en exportar e importar archivos constantemente.

Top comments (0)