API Bitbucket : possibilités et usage avec des agents IA
L'API REST de Bitbucket Cloud, éditée par Atlassian, permet d'accéder aux dépôts, aux pull requests, aux commits, aux pipelines et aux permissions. Les équipes de développement qui veulent automatiser les revues, les déploiements et les rapports l'utilisent. L'accès se fait par jetons d'accès, mots de passe d'application ou OAuth.
Ce que propose l’API Bitbucket
Dépôts
Consultation et configuration des dépôts, des branches et des fichiers.
Pull requests
Création, commentaires, approbations et fusion.
Commits
Historique, différences et statut des builds.
Pipelines
Déclenchement et suivi des exécutions CI/CD.
Webhooks
Événements de push, de pull request et de pipeline.
Workspaces et permissions
Membres, groupes et accès.
Comment accéder à l’API Bitbucket
- Avec les identifiants de votre entrepriseJetons d'accès de dépôt, de projet ou de workspace, ou OAuth 2.0 avec un consommateur enregistré. Les identifiants d'application par utilisateur sont également acceptés, selon la politique actuelle d'Atlassian.
- Le code source est un actif sensible : limitez l'agent aux dépôts nécessaires.
- Des limites de débit s'appliquent par utilisateur et par endpoint.
- La fusion et le déploiement en production doivent rester soumis à une approbation humaine.
Documentation officielle: developer.atlassian.com/cloud/bitbucket
Ce qu’un agent iTeam fait avec l’API Bitbucket
Pull requests en attente
L'agent liste les PR ouvertes depuis des jours sans revue et sollicite les relecteurs dans Slack ou Teams.
Résumé de PR pour le relecteur
À l'ouverture d'une PR, l'agent commente un résumé des changements et des points qui méritent attention.
Échec de pipeline expliqué
Quand le pipeline casse, l'agent lit le journal, indique l'étape en échec et prévient l'auteur du commit.
Notes de version
Avant une livraison, l'agent rédige les notes de version à partir des PR fusionnées.
De l’identifiant à l’agent au travail, avec validation
Créez un jeton avec un périmètre
Générez un jeton d'accès sur le workspace ou le dépôt, avec les permissions de lecture et de commentaire nécessaires.
Enregistrez-le dans le coffre d'iTeam
Le jeton reste dans le coffre. La fusion et le déclenchement d'un pipeline de production restent soumis à approbation.
Activez les webhooks sur un dépôt
Commencez par un seul dépôt, ajustez le format des commentaires, puis étendez.
Équipes IA prêtes à l’emploi pour ce travail
Analyse de données
Posez une question métier dans Slack ou Teams : l'équipe écrit la requête, vérifie le résultat et vous répond avec le chiffre et sa source.
Support informatique interne
Mot de passe, accès, matériel : la demande est posée dans Slack ou Teams, l'agent répond ou ouvre un ticket Jira complet.
Questions sur l’API Bitbucket
L'API Bitbucket est-elle gratuite ?
L'API est disponible dans les offres de Bitbucket Cloud, y compris l'offre gratuite. Les minutes de pipeline et certaines fonctions dépendent de l'offre.
Faut-il savoir programmer pour utiliser l'API Bitbucket avec iTeam ?
Non. iTeam lit la documentation de l'API, et l'équipe de déploiement configure les jetons, les webhooks et les règles.
L'agent peut-il fusionner du code ?
Oui, si le jeton le permet, mais le réglage recommandé est qu'il commente et attende l'approbation humaine.
