Tools de GitLab
Las 13 operaciones de GitLab que tu producto ejecuta en la cuenta de tu cliente con Connect. Todas usan el mismo endpoint, POST /api/tools/{tool}/execute.
- Listar proyectosGETLista proyectos, del más nuevo al más antiguo. Envía membership true para obtener solo los proyectos de la cuenta: sin eso, GitLab.com devuelve todos los proyectos públicos. Cada elemento tiene id y path_with_namespace, que las demás herramientas aceptan como project. Pagina con page y per_page: una página con menos elementos que per_page es la última.
- Listar miembros del proyectoGETLista los miembros de un proyecto, incluidos los heredados de sus grupos. Cada elemento tiene id, username y name: el id es lo que piden assignee_ids y reviewer_ids. Pagina con page y per_page.
- Listar issuesGETLista las issues de todos los proyectos que la cuenta puede ver. Por defecto, solo las issues que creó la cuenta: envía scope assigned_to_me o all para las demás. Cada elemento tiene project_id e iid, que piden las herramientas de issues. Pagina con page y per_page: una página con menos elementos que per_page es la última.
- Listar issues del proyectoGETLista las issues de un proyecto, de la más nueva a la más antigua. Cada elemento tiene iid, el número de la issue en el proyecto, que piden las herramientas de issues. Pagina con page y per_page: una página con menos elementos que per_page es la última.
- Obtener issueGETDevuelve una issue de un proyecto, con title, description, state, labels, assignees, milestone y due date.
- Crear issuePOSTCrea una issue en un proyecto y la devuelve, con su iid. Notifica a los participantes.
- Actualizar issuePUTModifica una issue y la devuelve. Solo cambian los campos enviados, y debe enviarse al menos uno. Para cerrarla o reabrirla, envía state_event. labels reemplaza todas las etiquetas; add_labels y remove_labels cambian solo las nombradas.
- Listar notas de la issueGETLista los comentarios (notes) de una issue, del más nuevo al más antiguo por defecto, incluidas las notas que GitLab escribe en cada cambio. Envía activity_filter only_comments para quedarte solo con lo que escribieron las personas. Pagina con page y per_page.
- Crear nota en la issuePOSTAgrega un comentario (note) a una issue y lo devuelve. Notifica a los participantes.
- Listar merge requestsGETLista las merge requests de un proyecto, de la más nueva a la más antigua. Cada elemento tiene iid, que piden las herramientas de merge requests. Pagina con page y per_page: una página con menos elementos que per_page es la última.
- Obtener merge requestGETDevuelve una merge request, con sus ramas, sha, detailed_merge_status (mergeable es el valor que permite fusionar), has_conflicts y head_pipeline.
- Crear merge requestPOSTAbre una merge request de source_branch a target_branch y la devuelve, con su iid. Un título que empieza con Draft: la abre como borrador. Notifica a los assignees y reviewers.
- Fusionar merge requestPUTFusiona una merge request y la devuelve. Con auto_merge true, se fusiona cuando el pipeline y las comprobaciones pasen. Responde 405 cuando no se puede fusionar, 409 cuando sha no coincide con la rama de origen y 422 cuando la fusión falla.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
