Tools do GitLab
As 13 operações do GitLab que o seu produto executa na conta do cliente pelo Connect. Todas usam o mesmo endpoint, POST /api/tools/{tool}/execute.
- Listar projetosGETLista projetos, do mais novo ao mais antigo. Envie membership true para obter só os projetos da conta: sem isso, o GitLab.com retorna todos os projetos públicos. Cada item tem id e path_with_namespace, que as outras ferramentas aceitam como project. Pagine com page e per_page: uma página com menos itens que per_page é a última.
- Listar membros do projetoGETLista os membros de um projeto, inclusive os herdados dos grupos. Cada item tem id, username e name: o id é o que assignee_ids e reviewer_ids pedem. Pagine com page e per_page.
- Listar issuesGETLista as issues de todos os projetos que a conta enxerga. Por padrão, só as issues que a conta criou: envie scope assigned_to_me ou all para as outras. Cada item tem project_id e iid, que as ferramentas de issue pedem. Pagine com page e per_page: uma página com menos itens que per_page é a última.
- Listar issues do projetoGETLista as issues de um projeto, da mais nova à mais antiga. Cada item tem iid, o número da issue no projeto, que as ferramentas de issue pedem. Pagine com page e per_page: uma página com menos itens que per_page é a última.
- Obter issueGETRetorna uma issue de um projeto, com title, description, state, labels, assignees, milestone e due date.
- Criar issuePOSTCria uma issue em um projeto e a retorna, com seu iid. Notifica os participantes.
- Atualizar issuePUTAltera uma issue e a retorna. Só os campos enviados mudam, e pelo menos um deve ser enviado. Para fechar ou reabrir, envie state_event. labels substitui todos os labels; add_labels e remove_labels mudam só os citados.
- Listar notas da issueGETLista os comentários (notes) de uma issue, do mais novo ao mais antigo por padrão, inclusive as notas que o GitLab escreve a cada mudança. Envie activity_filter only_comments para manter só o que as pessoas escreveram. Pagine com page e per_page.
- Criar nota na issuePOSTAdiciona um comentário (note) a uma issue e o retorna. Notifica os participantes.
- Listar merge requestsGETLista as merge requests de um projeto, da mais nova à mais antiga. Cada item tem iid, que as ferramentas de merge request pedem. Pagine com page e per_page: uma página com menos itens que per_page é a última.
- Obter merge requestGETRetorna uma merge request, com seus branches, sha, detailed_merge_status (mergeable é o valor que permite o merge), has_conflicts e head_pipeline.
- Criar merge requestPOSTAbre uma merge request de source_branch para target_branch e a retorna, com seu iid. Um título que começa com Draft: a abre como rascunho. Notifica os assignees e reviewers.
- Fazer merge de merge requestPUTFaz o merge de uma merge request e a retorna. Com auto_merge true, o merge acontece quando o pipeline e as verificações passarem. Responde 405 quando não pode ser mesclada, 409 quando sha não confere com o branch de origem e 422 quando o merge falha.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
