Formación corporativa en Postman

Una vez instalado Postman, el siguiente paso es dominar la construcción de requests HTTP completos y su organización en collections, la unidad de trabajo central de la plataforma. Este módulo cubre los métodos GET, POST, PUT, PATCH, DELETE y OPTIONS, los modos de envío de body (raw JSON, form-data, x-www-form-urlencoded, binary) y la gestión avanzada de headers, incluidas cabeceras de cliente y de seguridad.

La parte de organización aborda la jerarquía colección → carpeta → request, las descripciones en Markdown que generan documentación automática, la importación de especificaciones OpenAPI 3.1 para generar collections completas a partir del spec del backend y la sincronización bidireccional entre Postman y el repositorio de la API. Terminas con una colección estructurada por dominio funcional, lista para añadir variables y scripts en los módulos siguientes.

Las variables son uno de los pilares de Postman: permiten parametrizar la URL base, los tokens, los IDs y cualquier valor que cambie entre entornos sin duplicar requests. Este módulo presenta los cuatro ámbitos disponibles -globales, de colección, de entorno y locales-, su orden de precedencia y la sintaxis {{variable}} reconocida en URL, headers, body y scripts.

La parte práctica cubre la creación de environments por entorno (local, dev, staging, prod), la conmutación rápida desde el selector superior derecho, la sincronización entre dispositivos al iniciar sesión y el uso del Postman Vault para secretos sensibles (tokens de larga duración, claves de API de producción) que no deben sincronizarse con el cloud. El módulo cierra con patrones de organización y nomenclatura que escalan a equipos B2B con múltiples clientes.

Los scripts son la pieza que transforma Postman de un cliente HTTP manual en una plataforma de testing automatizado. Este módulo profundiza en los dos puntos de extensión: pre-request scripts (se ejecutan antes de enviar la petición) y test scripts (se ejecutan al recibir la respuesta), ambos en JavaScript moderno y con acceso al objeto global pm y a un sandbox con librerías embebidas (crypto-js, moment, cheerio, ajv).

La parte de pre-request aborda la generación dinámica de tokens, IDs y firmas HMAC; la lectura de variables con pm.environment.get y la escritura con pm.environment.set. La parte de tests cubre la API pm.test con aserciones Chai BDD (expect, to.be, to.deep.equal, to.have.status, to.have.jsonBody), validación de respuestas con JSON Schema y ajv, y la ejecución data-driven desde el Collection Runner alimentado por ficheros CSV o JSON externos.

La mayoría de las APIs corporativas exigen autenticación. Postman soporta de forma nativa todos los esquemas habituales y permite configurarlos a nivel de colección, carpeta o request individual. Este módulo presenta los esquemas básicos -Basic Auth, Bearer Token, API Key, Digest y AWS Signature- y profundiza en los flujos modernos de OAuth 2.1, ya con PKCE obligatorio y restricciones sobre los flujos legacy.

La parte práctica cubre los tres flujos OAuth 2.1 más comunes en empresa: Authorization Code con PKCE (aplicaciones SPA y mobile), Client Credentials (machine-to-machine y batch) y Resource Owner Password (uso reducido a clientes legacy de confianza). Se aborda la configuración del callback https://oauth.pstmn.io/v1/callback para que Postman intercepte el código en su navegador embebido. El módulo cierra con el manejo de JWT: decodificación de los claims con jwt-decode desde un script y patrón de refresh token automático en pre-request.

Lo que hace que Postman trascienda al cliente manual es la posibilidad de ejecutar las collections en CI/CD de forma reproducible. Este módulo presenta las dos CLIs oficiales -Newman (la histórica, sobre Node.js, open source) y Postman CLI (la moderna, basada en Newman, con login y governance integrados)- y enseña a integrarlas en pipelines profesionales.

La parte de Newman cubre la instalación con npm install -g newman, la ejecución con newman run, las opciones de iteraciones, environment, globals y datos externos, y la generación de reportes con newman-reporter-htmlextra y newman-reporter-junitxml. La parte de Postman CLI aborda el postman login --with-api-key, la ejecución de collections, la verificación de specs OpenAPI con postman api lint y la publicación de monitors. El módulo cierra con un workflow completo de GitHub Actions que cachea node_modules, lee la API Key como secreto y publica reportes HTML como artefactos.

Postman incorpora tres servicios cloud que extienden la herramienta más allá del cliente: Mock Servers, Monitors y Postman Flows. Este módulo profundiza en cada uno y muestra cuándo conviene usarlos en lugar de soluciones externas como WireMock, Datadog Synthetics o n8n.

La parte de mocks cubre la creación de un Mock Server a partir de una colección con respuestas guardadas (Save Example), la URL pública generada y los códigos de estado simulados (200, 4xx, 5xx, latencia). La parte de monitors aborda los Monitors programados (cada 5 minutos, hora, día) para validar uptime y SLAs, las regiones donde se ejecutan, las notificaciones a Slack o email y los límites del plan gratuito frente a planes de pago. El módulo cierra con Postman Flows, en GA desde 2025: editor visual de workflows que encadena requests, transformaciones (Filter, Map, Reduce) y condicionales sin código, ideal para integraciones ligeras y demos a stakeholders.

Postman es, ante todo, una plataforma de colaboración. Este módulo final aborda los patrones que escalan el uso de la herramienta a equipos grandes y a contextos B2B con múltiples clientes: workspaces (personales, de equipo y públicos), fork y pull request interno para versionar collections, y la publicación selectiva en la Postman Public API Network.

La parte de workspaces cubre los roles viewer, editor y admin, la diferencia entre workspace personal y de equipo, la invitación por email o por enlace, y la gestión de permisos por colección o environment. La parte de versionado aborda el flujo fork → editar → pull request → review → merge, equivalente al modelo de GitHub aplicado a collections, y los patrones de revisión de cambios en workspaces de gran tamaño. El módulo cierra con la Postman Public API Network, donde compañías como Stripe, Twilio o GitHub publican sus APIs oficiales, y con buenas prácticas para equipos que mantienen catálogos B2B con tags por cliente.