API GitHub : ce qu'on peut faire et comment l'utiliser avec des agents IA
L'API GitHub expose presque tout ce que l'on fait dans l'interface : dépôts, issues, pull requests, revues, Actions, releases et organisation. Elle sert aux équipes d'ingénierie, au DevOps et aux outils d'automatisation. Il existe une API REST et une API GraphQL, avec un accès par jeton personnel, GitHub App ou OAuth.
Ce que propose l’API GitHub
Dépôts et contenu
Lecture des fichiers, branches, commits et comparaison entre versions.
Issues
Création, étiquettes, responsables, jalons et commentaires.
Pull requests et revues
Ouverture, commentaires de revue, statuts et merge.
GitHub Actions
Exécutions de workflows, journaux, artefacts et déclenchement manuel.
Releases
Publication de versions avec notes et pièces jointes.
Organisations et équipes
Membres, équipes et droits sur les dépôts.
Webhooks
Événements de push, de PR, d'issue et de workflow envoyés à votre point d'entrée.
Comment accéder à l’API GitHub
- API publiqueJeton d'accès personnel (de préférence fine-grained), GitHub App installée dans l'organisation, ou OAuth. Pour des agents, une GitHub App avec des droits par dépôt est en général la plus sûre.
- Des limites de requêtes par heure s'appliquent ; les GitHub Apps en ont de plus larges que les jetons personnels.
- Ne donnez jamais à un agent le droit d'administration d'un dépôt.
- Attention aux secrets dans les journaux et le code : l'agent ne doit pas les recopier dans des messages.
Documentation officielle: docs.github.com/rest
Ce qu’un agent iTeam fait avec l’API GitHub
Tri des issues
L'agent lit chaque nouvelle issue, demande les informations manquantes, applique les étiquettes de domaine et de priorité et suggère un responsable d'après l'historique du code.
Résumé de PR pour le relecteur
À l'ouverture d'une pull request, l'agent commente le résumé des changements, les fichiers les plus risqués et ce qu'il faut tester.
Workflow en échec
Quand la CI casse sur main, l'agent lit le journal d'Actions, identifie l'étape et le commit probable et prévient l'équipe dans Slack avec le lien.
Notes de release
Au moment de publier, l'agent rassemble les PR fusionnées depuis la dernière version et rédige les notes pour validation.
De l’identifiant à l’agent au travail, avec validation
Créer une GitHub App ou un jeton fine-grained
La DSI définit sur quels dépôts et avec quels droits, par exemple issues en écriture et contenu en lecture seule.
Enregistrer dans le coffre d'iTeam
L'identifiant est conservé dans le coffre et chaque agent ne reçoit que les actions autorisées ; l'agent de tri ne fait pas de merge.
Tester avec validation
Commentaires et étiquettes peuvent s'exécuter directement ; merges, releases et déclenchements de workflows passent par une validation humaine.
É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 GitHub
L'API GitHub est-elle gratuite ?
En général, oui : l'API est disponible dans toutes les offres, avec des limites d'usage. Des fonctions comme Actions consomment des minutes selon l'offre.
Faut-il programmer pour utiliser l'API GitHub avec iTeam ?
Pas nécessairement. GitHub dispose d'un connecteur prêt à l'emploi dans le catalogue, et l'équipe de déploiement configure les flux avec vous.
REST ou GraphQL ?
Les deux existent. REST est plus simple pour des actions ponctuelles ; GraphQL permet de récupérer beaucoup de données liées en un seul appel.
