Tools GitHub
Les 12 opérations GitHub que votre produit exécute sur le compte de votre client via Connect. Elles utilisent toutes le même endpoint, POST /api/tools/{tool}/execute.
- Lister les dépôtsGETListe les dépôts accessibles au compte : les siens, ceux où il est collaborateur et ceux de ses organisations. Chaque élément a owner.login et name, qui sont l'owner et le repo que demandent les autres outils. Paginez avec page et per_page : une page avec moins d'éléments que per_page est la dernière.
- Rechercher des issuesGETRecherche des issues et des pull requests dans tous les dépôts que voit le compte, avec la syntaxe de recherche de GitHub dans q. Renvoie total_count et items, jusqu'à 1 000 résultats par recherche ; paginez avec page et per_page. Chaque élément a number, et repository_url se termine par l'owner et le repo de l'élément.
- Lister les issuesGETListe les issues d'un dépôt, de la plus récente à la plus ancienne. Les pull requests figurent aussi dans la liste, marquées par la clé pull_request. Paginez avec page et per_page : une page avec moins d'éléments que per_page est la dernière.
- Obtenir une issueGETRenvoie une issue, avec title, body, state, labels, assignees et milestone. Une issue déplacée vers un autre dépôt répond 301 avec sa nouvelle adresse.
- Créer une issuePOSTCrée une issue dans un dépôt et la renvoie, avec son number. Labels, assignees, milestone et type sont ignorés sans erreur quand le compte n'a pas l'accès push au dépôt. Notifie les personnes qui suivent le dépôt.
- Modifier une issuePATCHModifie une issue et la renvoie. Seuls les champs envoyés changent. Pour la fermer, envoyez state closed avec un state_reason. Labels et assignees remplacent les valeurs actuelles, et une liste vide les efface.
- Lister les commentaires d'une issueGETListe les commentaires d'une issue ou d'une pull request, du plus ancien au plus récent. Les commentaires de revue sur le code d'une pull request ne sont pas inclus. Paginez avec page et per_page : une page avec moins d'éléments que per_page est la dernière.
- Créer un commentaire d'issuePOSTAjoute un commentaire à une issue ou à une pull request et le renvoie. Notifie les participants.
- Lister les pull requestsGETListe les pull requests d'un dépôt, de la plus récente à la plus ancienne. Paginez avec page et per_page : une page avec moins d'éléments que per_page est la dernière.
- Obtenir une pull requestGETRenvoie une pull request, avec ses branches, head.sha, mergeable et mergeable_state, le nombre de commits et de fichiers modifiés et si elle a été fusionnée. mergeable peut être null pendant que GitHub le calcule : rappelez après quelques secondes.
- Créer une pull requestPOSTOuvre une pull request de la branche head vers la branche base et la renvoie, avec son number. Envoyez title, ou issue pour transformer une issue existante en pull request. Notifie les personnes qui suivent le dépôt.
- Fusionner une pull requestPUTFusionne une pull request dans sa branche base et renvoie merged et le sha du nouveau commit. Répond 405 quand la pull request ne peut pas être fusionnée, et 409 quand le sha ne correspond plus à son head. Les dépôts qui fusionnent via une merge queue ne l'acceptent pas.
Toolkits de la même catégorie
Voir les 100 toolkitsVoyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
