Obtenir une merge request avec l'API GitLab
Renvoie une merge request, avec ses branches, sha, detailed_merge_status (mergeable est la valeur qui permet de fusionner), has_conflicts et head_pipeline.
- Identifiant
- gitlab_get_merge_request
L'appel
POST https://connect.reportei.com/api/tools/gitlab_get_merge_request/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"id": "<id>",
"merge_request_iid": 1
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| id | string | Oui | The id of the project from List projects, or its path_with_namespace, such as group/project. |
| merge_request_iid | integer | Oui | The iid of the merge request from List merge requests, not its id. |
Connexions possibles
Votre client connecte son compte GitLab une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
Clé d'API
Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/gitlab, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/gitlab_get_merge_request. Il devient la définition de tool de votre agent sans conversion.
Autres tools GitLab
- Lister les projetsGETListe les projets, du plus récent au plus ancien. Envoyez membership true pour n'obtenir que les projets du compte : sans cela, GitLab.com renvoie tous les projets publics. Chaque élément a id et path_with_namespace, que les autres outils prennent comme project. Paginez avec page et per_page : une page avec moins d'éléments que per_page est la dernière.
- Lister les membres du projetGETListe les membres d'un projet, y compris ceux hérités de ses groupes. Chaque élément a id, username et name : l'id est ce que demandent assignee_ids et reviewer_ids. Paginez avec page et per_page.
- Lister les issuesGETListe les issues de tous les projets que le compte peut voir. Par défaut, seulement les issues créées par le compte : envoyez scope assigned_to_me ou all pour les autres. Chaque élément a project_id et iid, que demandent les outils d'issues. Paginez avec page et per_page : une page avec moins d'éléments que per_page est la dernière.
- Lister les issues du projetGETListe les issues d'un projet, de la plus récente à la plus ancienne. Chaque élément a iid, le numéro de l'issue dans le projet, que demandent les outils d'issues. 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 d'un projet, avec title, description, state, labels, assignees, milestone et due date.
- Créer une issuePOSTCrée une issue dans un projet et la renvoie, avec son iid. Notifie les participants.
- Mettre à jour une issuePUTModifie une issue et la renvoie. Seuls les champs envoyés changent, et au moins un doit être envoyé. Pour la fermer ou la rouvrir, envoyez state_event. labels remplace tous les labels ; add_labels et remove_labels ne changent que ceux nommés.
- Lister les notes d'une issueGETListe les commentaires (notes) d'une issue, du plus récent au plus ancien par défaut, y compris les notes que GitLab écrit à chaque changement. Envoyez activity_filter only_comments pour ne garder que ce que les gens ont écrit. Paginez avec page et per_page.
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.
