API de Postman: qué se puede hacer y cómo usarla con agentes de IA
Postman es la herramienta más usada para probar y documentar APIs, y también tiene una API propia para gestionar colecciones, entornos, workspaces, mocks y monitores. La usan los equipos de desarrollo y QA que quieren automatizar el mantenimiento de esos recursos. El acceso se hace con una clave de API generada en la cuenta.
Qué ofrece la API de Postman
Colecciones
Lectura, creación y actualización de colecciones de solicitudes.
Entornos
Gestión de variables de entorno, como las URL de pruebas y de producción.
Workspaces
Organización de colecciones y entornos por equipo o proyecto.
Mocks
Servidores simulados para probar integraciones antes de que la API real esté lista.
Monitores
Ejecuciones programadas de colecciones para seguir la salud de las APIs.
Especificaciones de API
Gestión de definiciones como OpenAPI dentro de Postman.
Cómo acceder a la API de Postman
- Con las credenciales de tu empresaUsa una clave de API generada en la configuración de la cuenta de Postman, enviada en el encabezado de cada solicitud.
- Las variables de entorno pueden contener secretos: restringe el acceso del agente.
- Hay límites de uso de la API según el plan de Postman.
- Evita los permisos de eliminación de colecciones y workspaces.
Documentación oficial: learning.postman.com/docs/developer/postman-api/intro-api
Qué hace un agente de iTeam con la API de Postman
La colección como documentación para el agente
El agente usa la colección del equipo como fuente de verdad de los endpoints internos y solo llama a lo que está descrito allí.
Seguimiento de monitores
El agente lee los resultados de los monitores y abre un ticket con la solicitud que falló y la respuesta recibida.
Actualización de entornos
Cuando cambia la URL de pruebas, el agente actualiza la variable en los entornos correctos y avisa al equipo.
Revisión de colecciones desactualizadas
El agente compara la colección con la especificación OpenAPI y señala los endpoints sin ejemplo o eliminados.
De la credencial al agente trabajando, con aprobación
Generar la clave de API
En la cuenta de Postman, crea una clave de API de una cuenta técnica con acceso solo a los workspaces necesarios.
Guardar en la bóveda de iTeam
Registra la clave y define si el agente solo lee colecciones y monitores o si también puede editar entornos.
Empezar en modo lectura
Ejecuta primero en modo lectura y habilita las ediciones cuando el equipo valide los informes del agente.
Equipos de IA listos para este trabajo
Preguntas sobre la API de Postman
¿La API de Postman es gratuita?
La API también está disponible en los planes gratuitos, con límites de uso. Los planes de pago amplían esos límites y los recursos de equipo.
¿Necesito programar para usar la API de Postman con iTeam?
No necesariamente. El equipo de implementación configura el acceso, y el agente puede incluso usar las colecciones existentes para aprender tus APIs.
¿iTeam importa una colección de Postman como herramienta?
Una colección bien documentada es una excelente base para que la herramienta HTTP de iTeam aprenda los endpoints de un sistema interno.
