Tools do Jira
As 13 operações do Jira que o seu produto executa na conta do cliente pelo Connect. Todas usam o mesmo endpoint, POST /api/tools/{tool}/execute.
- Buscar issuesGETBusca issues com JQL. A consulta precisa ser delimitada, por exemplo project = KEY. Só o id da issue volta, a menos que fields liste o que incluir. Passe o nextPageToken da resposta para ler a próxima página.
- Obter issueGETRetorna uma issue pelo id ou pela chave, com todos os campos navegáveis, a menos que fields liste o que incluir.
- Criar issuePOSTCria uma issue. fields precisa ter ao menos project, issuetype e summary, e qualquer outro campo precisa existir na tela de criação do projeto, como mostra Listar campos de criação. Nesta versão da API, o campo description recebe um objeto Atlassian Document Format, não texto simples.
- Atualizar issuePUTEdita os campos de uma issue: fields define valores, e update aplica operações como adicionar ou remover um label. Um campo vai em fields ou em update, nunca nos dois. O status não muda aqui: use Fazer transição da issue. A resposta é vazia, status 204, a menos que returnIssue seja true.
- Excluir issueDELETEExclui uma issue. Uma issue com subtarefas só é excluída com deleteSubtasks definido como true, o que também exclui as subtarefas. Exige a permissão Delete issues no projeto. A resposta é vazia, status 204.
- Listar transiçõesGETLista as transições que o usuário pode fazer agora em uma issue, cada uma com o id que Fazer transição da issue recebe, seu name e o status para o qual leva em to.
- Fazer transição da issuePOSTMove uma issue para outro status executando uma de suas transições. Quando a transição tem uma tela, seus campos obrigatórios, como resolution, vão em fields ou update. A resposta é vazia, status 204.
- Listar comentáriosGETLista os comentários de uma issue, com o corpo em Atlassian Document Format. Pagine com startAt e maxResults até que startAt mais a quantidade retornada alcance total.
- Criar comentárioPOSTAdiciona um comentário a uma issue, visível para todos que podem ver a issue. O Jira notifica os observadores pelo esquema de notificação do projeto. Retorna o novo comentário.
- Listar projetosGETLista os projetos que o usuário pode ver, com a key e o id que as ferramentas de issue e o JQL recebem. Pagine com startAt e maxResults até que isLast seja true.
- Listar tipos de issueGETLista os tipos de issue que o usuário pode criar em um projeto, com o id e o name que Criar issue e Listar campos de criação recebem, e subtask true para os tipos de subtarefa.
- Listar campos de criaçãoGETLista os campos da tela de criação para um projeto e um tipo de issue: o fieldId que Criar issue recebe, se é obrigatório, seu schema e seus valores permitidos com os ids. Pagine com startAt e maxResults até total.
- Buscar usuários atribuíveisGETEncontra usuários que podem ser atribuídos a novas issues de um projeto ou a uma issue, com o accountId que o campo assignee recebe. Envie project ou issueKey. Retorna uma lista, que pode ser menor que maxResults mesmo quando existem mais usuários.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
