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.
As senhas de aplicativo do Bitbucket ainda funcionam para um agente de IA?
A Atlassian anunciou a substituição das senhas de aplicativo por tokens de API, com desativação definitiva em 2026, e fontes divergem entre junho e julho. Portanto, use tokens de API ou de acesso. Confirme a situação atual no changelog oficial do Bitbucket Cloud antes de planejar, porque integrações antigas podem já ter parado.
Que tipo de token do Bitbucket é melhor para um agente?
O token de acesso de repositório, de projeto ou de workspace, com escopos explícitos, porque pertence ao recurso e não a uma pessoa. Também há OAuth 2.0 com consumidor registrado e tokens de API vinculados a um usuário. Para um agente que só revisa um repositório, o token de repositório com leitura é o mais seguro.
O agente consegue revisar pull requests no Bitbucket?
Consegue ler o diff, os comentários e o estado dos pull requests pela API e postar comentários com pontos de atenção. O merge fica com uma pessoa. O agente é útil para resumir mudanças longas, lembrar revisões pendentes e apontar ausência de testes. A decisão de aprovar continua com o revisor humano.
O agente pode disparar o Bitbucket Pipelines?
Pode, pela API de pipelines, mas disparar um deploy em produção deve continuar com aprovação humana. Pipelines de teste ou de ambientes de desenvolvimento podem ser liberados. Variáveis de pipeline podem guardar segredos, e o agente não deve exibi-las nem repassá-las em mensagens.
Existe sandbox no Bitbucket para testar um agente?
Não há um sandbox da API, mas um workspace de teste com um repositório de exemplo cumpre o papel. Crie nele o token do agente, teste leitura e comentários e só depois estenda a permissão aos repositórios reais. Em equipes grandes, vale ter o workspace de teste separado do principal.
Quais limites de uso do Bitbucket um agente precisa respeitar?
A API do Bitbucket Cloud impõe limites de taxa por usuário e por endpoint, e excedê-los devolve erro. O agente deve paginar com cuidado, usar webhooks para eventos e evitar listar todos os repositórios a cada pergunta. Confira na documentação oficial os valores vigentes, pois a Atlassian os ajusta.
O agente deve ter acesso de escrita aos repositórios do Bitbucket?
Só de forma delimitada, como criar branches e abrir pull requests em um repositório específico. O código-fonte é um ativo sensível, e escrita ampla aumenta o risco de um erro do agente chegar à produção. Comece só com leitura, ganhe confiança e depois estenda a permissão, repositório a repositório.
Webhooks do Bitbucket evitam que o agente consulte a API toda hora?
Evitam: os webhooks avisam sobre push, pull request criado ou comentado e conclusão de pipeline, e o agente reage ao evento. Isso economiza limite de requisições e dá resposta mais rápida. Configure um segredo para validar a origem da chamada e trate eventos repetidos com idempotência.
