Tools de Jira
Las 13 operaciones de Jira que tu producto ejecuta en la cuenta de tu cliente con Connect. Todas usan el mismo endpoint, POST /api/tools/{tool}/execute.
- Buscar issuesGETBusca issues con JQL. La consulta debe estar acotada, por ejemplo project = KEY. Solo vuelve el id de la issue, salvo que fields liste qué incluir. Pasa el nextPageToken de la respuesta para leer la página siguiente.
- Obtener issueGETDevuelve una issue por id o clave, con todos los campos navegables, salvo que fields liste qué incluir.
- Crear issuePOSTCrea una issue. fields necesita al menos project, issuetype y summary, y cualquier otro campo debe existir en la pantalla de creación del proyecto, como muestra Listar campos de creación. En esta versión de la API, el campo description recibe un objeto Atlassian Document Format, no texto plano.
- Actualizar issuePUTEdita los campos de una issue: fields define valores, y update aplica operaciones como agregar o quitar un label. Un campo va en fields o en update, nunca en ambos. El estado no cambia aquí: usa Hacer transición de la issue. La respuesta es vacía, status 204, salvo que returnIssue sea true.
- Eliminar issueDELETEElimina una issue. Una issue con subtareas solo se elimina con deleteSubtasks en true, lo que también elimina las subtareas. Requiere el permiso Delete issues en el proyecto. La respuesta es vacía, status 204.
- Listar transicionesGETLista las transiciones que el usuario puede hacer ahora en una issue, cada una con el id que recibe Hacer transición de la issue, su name y el estado al que lleva en to.
- Hacer transición de la issuePOSTMueve una issue a otro estado ejecutando una de sus transiciones. Cuando la transición tiene una pantalla, sus campos obligatorios, como resolution, van en fields o update. La respuesta es vacía, status 204.
- Listar comentariosGETLista los comentarios de una issue, con el cuerpo en Atlassian Document Format. Pagina con startAt y maxResults hasta que startAt más la cantidad devuelta alcance total.
- Crear comentarioPOSTAgrega un comentario a una issue, visible para todos los que pueden ver la issue. Jira notifica a los observadores según el esquema de notificaciones del proyecto. Devuelve el nuevo comentario.
- Listar proyectosGETLista los proyectos que el usuario puede ver, con la key y el id que reciben las herramientas de issues y el JQL. Pagina con startAt y maxResults hasta que isLast sea true.
- Listar tipos de issueGETLista los tipos de issue que el usuario puede crear en un proyecto, con el id y el name que reciben Crear issue y Listar campos de creación, y subtask true para los tipos de subtarea.
- Listar campos de creaciónGETLista los campos de la pantalla de creación para un proyecto y un tipo de issue: el fieldId que recibe Crear issue, si es obligatorio, su schema y sus valores permitidos con sus ids. Pagina con startAt y maxResults hasta total.
- Buscar usuarios asignablesGETEncuentra usuarios que se pueden asignar a nuevas issues de un proyecto o a una issue, con el accountId que recibe el campo assignee. Envía project o issueKey. Devuelve una lista, que puede ser menor que maxResults aunque existan más usuarios.
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.
