DEV Community

Cover image for Cómo recuperar colecciones de Postman si te bloquean el acceso
Roobia
Roobia

Posted on • Originally published at apidog.com

Cómo recuperar colecciones de Postman si te bloquean el acceso

En resumen

Si el cambio en el plan gratuito de Postman cortó tu acceso a colecciones compartidas, tus datos no están necesariamente perdidos. El bloqueo suele ser una restricción de acceso, no una eliminación inmediata, pero debes actuar rápido antes de que la caché local se invalide o desaparezca. Sigue esta guía en orden: caché local, exportaciones existentes, administrador del workspace, API de Postman y reconstrucción parcial.

Prueba Apidog hoy

Introducción

Después de la actualización del nivel gratuito de Postman en el primer trimestre de 2026, muchos desarrolladores que compartían workspaces con sus equipos dejaron de poder acceder a ellos. Las colecciones que estaban en espacios de trabajo de equipo, no en espacios personales, quedaron detrás de una restricción de plan.

Un desarrollador lo resumió así en Reddit:

"Llegué el lunes y todo mi espacio de trabajo de equipo había desaparecido. Tres meses de colecciones organizadas, entornos, todo. Simplemente desaparecido a menos que paguemos".

La parte importante: los datos no suelen eliminarse en ese momento. Postman mantiene los datos del workspace en el servidor; el problema es el acceso. Si tienes caché local, exportaciones previas o una API key activa, todavía puedes recuperar parte o todo el contenido.

1. Revisa primero la caché de Postman Desktop

Empieza por la aplicación de escritorio. No abras primero la versión web.

Postman Desktop puede mantener una caché local de colecciones y entornos usados recientemente. Aunque el acceso del servidor esté restringido, esa caché puede seguir disponible durante un periodo corto, normalmente desde unos días hasta una semana, según el sistema y la invalidación de caché.

Pasos

  1. Abre Postman Desktop.
  2. No uses la app web en app.getpostman.com.
  3. Revisa la pestaña History para identificar requests recientes.
  4. Comprueba si las colecciones todavía aparecen en la barra lateral izquierda.
  5. Si aparecen, expórtalas inmediatamente.

Para exportar una colección:

  1. Haz clic derecho sobre la colección o abre el menú de tres puntos.
  2. Selecciona Export.
  3. Elige Collection v2.1.
  4. Guarda el archivo .json.
  5. Repite el proceso con cada colección visible.

Si ves la colección pero falla la exportación, intenta trabajar sin conexión:

  1. Haz clic en tu avatar, arriba a la derecha.
  2. Selecciona Go Offline.
  3. Intenta exportar de nuevo.

Esto puede evitar que la aplicación intente sincronizar con el servidor y te dé acceso de lectura temporal a los datos en caché.

2. Busca exportaciones existentes

Antes de asumir que todo está perdido, busca archivos .json que ya hayan sido exportados.

Carpeta de descargas

Revisa tu carpeta Downloads o Descargas.

Las colecciones exportadas desde Postman suelen ser archivos JSON. Busca archivos con nombres similares a:

collection.json
postman_collection.json
api-name.postman_collection.json
Enter fullscreen mode Exit fullscreen mode

Puedes identificar una colección de Postman por una estructura parecida a esta:

{
  "info": {
    "name": "Mi API",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "item": []
}
Enter fullscreen mode Exit fullscreen mode

Repositorio Git del proyecto

Busca archivos JSON en tu repositorio:

find . -name "*.json" | grep -i postman
Enter fullscreen mode Exit fullscreen mode

También revisa el historial:

git log --all --name-only -- '*.json' | grep -i postman
Enter fullscreen mode Exit fullscreen mode

Algunos equipos guardan colecciones junto al código base para usarlas en pruebas, documentación o pipelines.

Correo electrónico

Busca adjuntos .json enviados por compañeros. Prueba búsquedas como:

postman collection
postman_collection
.json
collection export
Enter fullscreen mode Exit fullscreen mode

Unidades compartidas

Revisa Google Drive, Dropbox, OneDrive u otras carpetas compartidas del equipo. Es común que alguien haya guardado una copia sin documentarlo.

Pipelines CI/CD

Si usabas Newman en Jenkins, GitHub Actions, CircleCI u otro pipeline, la colección puede estar en el repositorio o como artefacto.

Busca referencias en archivos de configuración:

grep -R "newman" .
grep -R "postman" .
grep -R "collection" .github workflows Jenkinsfile package.json
Enter fullscreen mode Exit fullscreen mode

Ejemplo típico:

- name: Run Postman tests
  run: newman run ./tests/api.postman_collection.json
Enter fullscreen mode Exit fullscreen mode

Si encuentras esa ruta, copia el archivo de colección cuanto antes.

3. Contacta al propietario o administrador del workspace

Si el workspace pertenece a otra persona, el propietario puede seguir teniendo acceso completo, especialmente si es el único usuario de la cuenta o si actualizó a un plan de pago.

Pídele que haga lo siguiente:

  1. Iniciar sesión en Postman.
  2. Abrir el workspace afectado.
  3. Exportar cada colección desde el menú de tres puntos.
  4. Exportar también los entornos necesarios.
  5. Enviarte los archivos .json.

Si el propietario tampoco puede acceder, pregunta al resto del equipo si alguien tiene Postman Desktop instalado y las colecciones en caché. Esa persona puede seguir los pasos de la sección anterior.

4. Usa la API de Postman si tienes una API key activa

Si todavía tienes una API key válida, puedes intentar extraer tus colecciones y entornos directamente desde la API de Postman.

Primero lista las colecciones:

GET https://api.getpostman.com/collections
x-api-key: YOUR_POSTMAN_API_KEY
Enter fullscreen mode Exit fullscreen mode

Con curl:

curl --request GET "https://api.getpostman.com/collections" \
  --header "x-api-key: YOUR_POSTMAN_API_KEY"
Enter fullscreen mode Exit fullscreen mode

La respuesta incluye IDs de colección. Luego descarga cada colección:

GET https://api.getpostman.com/collections/{collection_id}
x-api-key: YOUR_POSTMAN_API_KEY
Enter fullscreen mode Exit fullscreen mode

Ejemplo:

curl --request GET "https://api.getpostman.com/collections/COLLECTION_ID" \
  --header "x-api-key: YOUR_POSTMAN_API_KEY" \
  --output collection.json
Enter fullscreen mode Exit fullscreen mode

Para entornos:

GET https://api.getpostman.com/environments
x-api-key: YOUR_POSTMAN_API_KEY
Enter fullscreen mode Exit fullscreen mode

Y luego:

GET https://api.getpostman.com/environments/{environment_id}
x-api-key: YOUR_POSTMAN_API_KEY
Enter fullscreen mode Exit fullscreen mode

Ejemplo:

curl --request GET "https://api.getpostman.com/environments/ENVIRONMENT_ID" \
  --header "x-api-key: YOUR_POSTMAN_API_KEY" \
  --output environment.json
Enter fullscreen mode Exit fullscreen mode

Este método solo funciona mientras la API key siga activa. No asumas que durará mucho.

Si no recuerdas dónde guardaste la clave, revisa:

  • Archivos .env.
  • Variables de entorno en CI/CD.
  • Gestores de contraseñas.
  • Configuraciones locales de scripts.
  • Historial de comandos, si aplica.

Ejemplo:

grep -R "POSTMAN_API_KEY" .
grep -R "api.getpostman.com" .
Enter fullscreen mode Exit fullscreen mode

5. Reconstruye desde logs si no tienes exportaciones

Si no hay caché, exportaciones ni API key, todavía puedes reconstruir parte de la colección desde fuentes externas.

Registros de red del navegador

Si usaste la app web de Postman recientemente, el navegador puede tener respuestas en caché.

En Chrome:

  1. Abre DevTools con F12.
  2. Ve a Application.
  3. Abre Cache Storage.
  4. Busca respuestas relacionadas con Postman.

Esto difícilmente recuperará una colección completa, pero puede ayudarte a identificar endpoints, métodos y payloads parciales.

Logs del servidor

Si tu equipo controla la API probada desde Postman, revisa logs de acceso.

Puedes recuperar información como:

  • Método HTTP.
  • Ruta.
  • Query params.
  • Algunos headers.
  • Códigos de respuesta.

Ejemplo de búsqueda:

grep "POST /api" access.log
grep "GET /v1" access.log
Enter fullscreen mode Exit fullscreen mode

Esto no recupera scripts de test ni bodies completos, pero ayuda a reconstruir la estructura base.

Especificaciones OpenAPI o Swagger

Si tu API tiene una especificación openapi.yaml, openapi.json o swagger.json, úsala para recrear endpoints documentados.

Puedes importar esa especificación en Apidog u otra herramienta compatible y recuperar:

  • Rutas.
  • Métodos.
  • Parámetros.
  • Schemas.
  • Respuestas documentadas.

6. Importa las colecciones recuperadas a Apidog

Cuando tengas tus archivos JSON, puedes importarlos en Apidog.

Pasos:

  1. Descarga e instala la aplicación de escritorio de Apidog o abre la versión web.
  2. Crea un nuevo proyecto.
  3. En el proyecto, haz clic en Importar.
  4. Selecciona Postman como fuente.
  5. Sube el archivo JSON de la colección.
  6. Repite el proceso para cada colección.

Para importar entornos:

  1. Abre el mismo flujo de Importar.
  2. Selecciona Postman Environment como tipo de origen.
  3. Sube el archivo JSON del entorno.
  4. Valida las variables importadas.

Después de importar, revisa:

  • Que las rutas estén agrupadas correctamente.
  • Que las variables de entorno existan.
  • Que los headers comunes sigan configurados.
  • Que los cuerpos de request se hayan importado bien.
  • Que los scripts o pruebas críticas sigan presentes cuando corresponda.

Luego invita a tu equipo. En el plan gratuito de Apidog, hasta 3 usuarios pueden compartir un workspace. Las colecciones se sincronizan entre los miembros del equipo sin tarifas por usuario.

7. Evita que vuelva a ocurrir

El problema de fondo es depender de un workspace remoto sin tener una copia exportable y versionada. Independientemente de la herramienta que uses, define una rutina de respaldo.

Checklist recomendado

Al final de cada sprint:

  1. Exporta las colecciones como JSON.
  2. Exporta los entornos sin secretos.
  3. Sube los archivos al repositorio.
  4. Documenta cómo importarlos.
  5. Verifica que alguien del equipo pueda restaurarlos.

Ejemplo de estructura en Git:

docs/
  api/
    collections/
      users.postman_collection.json
      billing.postman_collection.json
    environments/
      local.postman_environment.json
      staging.postman_environment.json
Enter fullscreen mode Exit fullscreen mode

No subas secretos. Para variables sensibles, usa placeholders:

{
  "key": "API_TOKEN",
  "value": "REPLACE_ME",
  "type": "secret"
}
Enter fullscreen mode Exit fullscreen mode

Apidog almacena colecciones localmente por defecto. La sincronización en la nube es opcional. Si en el futuro cambia el precio de una herramienta, tener tus datos en tu máquina y exportados en Git reduce el riesgo de bloqueo.

Conclusión

Perder acceso a un workspace compartido es frustrante, pero no siempre significa perder los datos. Revisa primero Postman Desktop, luego exportaciones existentes, repositorios, administradores del workspace y la API de Postman. Si no hay recuperación directa, reconstruye desde logs o especificaciones OpenAPI.

Cuando recuperes tus colecciones, impórtalas, respáldalas y versiónalas. Ese hábito simple evita que un cambio de plan vuelva a bloquear el trabajo de tu equipo.

Top comments (0)