API de Bitbucket: qué puedes hacer y cómo usarla con agentes de IA
La API REST de Bitbucket Cloud, de Atlassian, permite acceder a repositorios, pull requests, commits, pipelines y permisos. La usan equipos de desarrollo que quieren automatizar revisiones, despliegues e informes. El acceso se hace con tokens de acceso, contraseñas de aplicación u OAuth.
Qué ofrece la API de Bitbucket
Repositorios
Consulta y configuración de repositorios, ramas y archivos.
Pull requests
Creación, comentarios, aprobaciones y merge.
Commits
Historial, diferencias y estado de los builds.
Pipelines
Lanzamiento y seguimiento de las ejecuciones de CI/CD.
Webhooks
Eventos de push, pull request y pipeline.
Workspaces y permisos
Miembros, grupos y accesos.
Cómo acceder a la API de Bitbucket
- Con las credenciales de tu empresaTokens de acceso de repositorio, proyecto o workspace, u OAuth 2.0 con un consumidor registrado. También se aceptan credenciales de app por usuario, según la política vigente de Atlassian.
- El código fuente es un activo sensible: limita el agente a los repositorios necesarios.
- Hay límites de tasa por usuario y por endpoint.
- El merge y el despliegue a producción deben seguir con aprobación humana.
Documentación oficial: developer.atlassian.com/cloud/bitbucket
Qué hace un agente de iTeam con la API de Bitbucket
Pull requests detenidos
El agente lista los PR abiertos desde hace días sin revisión y avisa a los revisores en Slack o Teams.
Resumen del PR para el revisor
Al abrirse un PR, el agente comenta un resumen de los cambios y de los puntos que merecen atención.
Fallo de pipeline explicado
Cuando el pipeline falla, el agente lee el log, señala el paso que falló y avisa a quien hizo el commit.
Notas de versión
Antes de una entrega, el agente arma las notas de versión a partir de los PR integrados.
De la credencial al agente trabajando, con aprobación
Crea un token con alcance limitado
Genera un token de acceso en el workspace o en el repositorio con los permisos de lectura y de comentario necesarios.
Regístralo en la bóveda de iTeam
El token queda en la bóveda. El merge y el lanzamiento de pipelines de producción quedan bajo aprobación.
Activa los webhooks en un repositorio
Empieza con un repositorio, ajusta el formato de los comentarios y después amplía.
Equipos de IA listos para este trabajo
Preguntas sobre la API de Bitbucket
¿La API de Bitbucket es gratuita?
La API está disponible en los planes de Bitbucket Cloud, incluido el gratuito. Los minutos de pipeline y algunas funciones dependen del plan.
¿Necesito programar para usar la API de Bitbucket con iTeam?
No. iTeam lee la documentación de la API y el equipo de implantación configura los tokens, los webhooks y las reglas.
¿El agente puede hacer merge?
Puede, si el token lo permite, pero lo recomendado es que comente y espere la aprobación humana.
