API do Bitbucket: o que dá para fazer e como usar com agentes de IA
A API REST do Bitbucket Cloud, da Atlassian, permite acessar repositórios, pull requests, commits, pipelines e permissões. É usada por times de desenvolvimento que querem automatizar revisões, deploys e relatórios. O acesso é por tokens de acesso, senhas de aplicativo ou OAuth.
Os grandes recursos da API, em português claro.
Consulta e configuração de repositórios, branches e arquivos.
Criação, comentários, aprovações e merge.
Histórico, diferenças e status de build.
Disparo e acompanhamento das execuções de CI/CD.
Eventos de push, pull request e pipeline.
Membros, grupos e acessos.
Como se acessa a API do Bitbucket.
- Com credencial da sua empresaTokens de acesso de repositório, projeto ou workspace, ou OAuth 2.0 com consumidor registrado; credenciais de app por usuário também são aceitas, conforme a política atual da Atlassian.
- Documentação oficialdeveloper.atlassian.com/cloud/bitbucket
- Código-fonte é ativo sensível: limite o agente aos repositórios necessários.
- Há limites de taxa por usuário e por endpoint.
- Merge e deploy em produção devem continuar com aprovação humana.
- api bitbucket
- bitbucket rest api
- bitbucket api documentação
- bitbucket api pull request
- bitbucket webhook
- bitbucket pipelines api
O que um agente do iTeam faz com a API do Bitbucket.
O agente lista PRs abertos há dias sem revisão e chama os revisores no Slack ou Teams.
Ao abrir um PR, o agente comenta um resumo das mudanças e os pontos que merecem atenção.
Quando o pipeline quebra, o agente lê o log, aponta o passo que falhou e avisa o autor do commit.
Antes de uma entrega, o agente monta as notas de versão a partir dos PRs mesclados.
Da credencial ao agente trabalhando, com aprovação.
Crie um token com escopo
Gere um token de acesso no workspace ou repositório com as permissões de leitura e comentário necessárias.
Cadastre no cofre do iTeam
O token fica no cofre; merge e disparo de pipeline de produção ficam sob aprovação.
Ligue webhooks em um repositório
Comece com um repositório, ajuste o formato dos comentários e depois estenda.
Dúvidas sobre a API do Bitbucket.
A API do Bitbucket é gratuita?
A API está disponível nos planos do Bitbucket Cloud, inclusive o gratuito; minutos de pipeline e alguns recursos dependem do plano.
Preciso programar para usar a API do Bitbucket com o iTeam?
Não. O iTeam lê a documentação da API e o time de implantação configura tokens, webhooks e regras.
O agente pode fazer merge?
Pode, se o token permitir, mas o padrão recomendado é ele comentar e aguardar aprovação humana.