Tema 8 · Colecciones & Carpetas

Colecciones y Carpetas: Organización Modular de Endpoints

Aprende a estructurar colecciones profesionales en Postman, organizar endpoints por módulos y aprovechar la herencia de autorización para ahorrar tiempo.

Códigos de Estado HTTP (200, 201, 400, 401, 404, 422, 500) Variables de Entorno: Conmutar entre Localhost y Producción con {{base_url}}

¿Qué es una Colección (Collection) en Postman?

Una Colección es un contenedor que agrupa de forma ordenada todas las peticiones HTTP que componen una API o un flujo de pruebas.

En lugar de tener decenas de pestañas sueltas en el historial temporal, las colecciones te permiten guardar cada endpoint con su nombre descriptivo, parámetros, ejemplos y documentación asociada.

Estructura Recomendada por Módulos y Carpetas

Para proyectos profesionales, se recomienda estructurar la colección en subcarpetas numeradas que representen los recursos del dominio:

  • 📁 01 - Autenticación & Acceso:
    • POST /api/auth/register (Registro de cuenta)
    • POST /api/auth/login (Inicio de sesión y entrega de JWT)
    • POST /api/auth/refresh (Renovación de token)
  • 📁 02 - Usuarios & Perfil:
    • GET /api/v1/usuarios/perfil (Datos del usuario autenticado)
    • PUT /api/v1/usuarios/perfil (Actualización completa)
  • 📁 03 - Catálogo de Productos:
    • GET /api/v1/productos (Listado con filtros y paginación)
    • POST /api/v1/productos (Creación de producto - Solo Admin)
    • DELETE /api/v1/productos/:id (Eliminación)

El Superpoder de la "Herencia de Autorización" (Inherit Auth)

¿Tienes 40 endpoints que requieren el mismo token Bearer? No lo configures petición por petición.

  1. Haz clic derecho sobre el nombre de la Colección y selecciona Edit.
  2. Ve a la pestaña Authorization de la colección.
  3. Selecciona Type: Bearer Token y en el campo Token escribe tu variable: {{jwt_token}}.
  4. Guarda los cambios de la colección.
  5. Ahora, en cada una de las 40 peticiones internas, ve a su pestaña Authorization y deja seleccionada la opción predeterminada:
    "Inherit auth from parent" (Heredar autorización del padre).
  6. ¡Listo! Cuando el token cambie o expire, solo se actualiza en un único lugar y las 40 peticiones quedarán autorizadas al instante.

⚡ Estructura JSON de una Colección Exportada de Postman (v2.1.0)

Fragmento del archivo exportado que define carpetas y herencia de auth:

coleccion-postman.json
Solo lectura 
{
  "info": {
    "name": "API Kilopolis E-commerce",
    "_postman_id": "c1f2e3d4-a5b6-7890-abcd-ef1234567890",
    "description": "Colección completa para pruebas de integración de la tienda.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{jwt_token}}",
        "type": "string"
      }
    ]
  },
  "item": [
    {
      "name": "01 - Autenticacion",
      "item": []
    },
    {
      "name": "02 - Productos",
      "item": []
    }
  ]
}
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Cuál es el beneficio de configurar el método de autenticación a nivel de Colección y usar "Inherit auth from parent" en sus peticiones hijas?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar Manual de Postman: Pruebas de APIs REST & Automatización y crear proyectos reales?

Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.

Conocer el Bootcamp

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de David Amador para Kilopolis Academia (Solucionáticos), estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.