Tools Jira
Les 13 opérations Jira que votre produit exécute sur le compte de votre client via Connect. Elles utilisent toutes le même endpoint, POST /api/tools/{tool}/execute.
- Rechercher des issuesGETRecherche des issues avec JQL. La requête doit être bornée, par exemple project = KEY. Seul l'id de l'issue revient, sauf si fields liste ce qu'il faut inclure. Passez le nextPageToken de la réponse pour lire la page suivante.
- Obtenir une issueGETRenvoie une issue par id ou clé, avec tous les champs navigables, sauf si fields liste ce qu'il faut inclure.
- Créer une issuePOSTCrée une issue. fields doit contenir au moins project, issuetype et summary, et tout autre champ doit exister sur l'écran de création du projet, comme le montre Lister les champs de création. Dans cette version de l'API, le champ description prend un objet Atlassian Document Format, pas du texte brut.
- Modifier une issuePUTModifie les champs d'une issue : fields définit des valeurs, et update applique des opérations comme ajouter ou retirer un label. Un champ va dans fields ou dans update, jamais dans les deux. Le statut ne change pas ici : utilisez Faire une transition d'issue. La réponse est vide, status 204, sauf si returnIssue vaut true.
- Supprimer une issueDELETESupprime une issue. Une issue avec des sous-tâches n'est supprimée qu'avec deleteSubtasks à true, ce qui supprime aussi les sous-tâches. Exige la permission Delete issues dans le projet. La réponse est vide, status 204.
- Lister les transitionsGETListe les transitions que l'utilisateur peut effectuer maintenant sur une issue, chacune avec l'id que prend Faire une transition d'issue, son name et le statut vers lequel elle mène dans to.
- Faire une transition d'issuePOSTFait passer une issue à un autre statut en exécutant l'une de ses transitions. Quand la transition a un écran, ses champs obligatoires, comme resolution, vont dans fields ou update. La réponse est vide, status 204.
- Lister les commentairesGETListe les commentaires d'une issue, avec le corps en Atlassian Document Format. Paginez avec startAt et maxResults jusqu'à ce que startAt plus le nombre renvoyé atteigne total.
- Créer un commentairePOSTAjoute un commentaire à une issue, visible par tous ceux qui peuvent voir l'issue. Jira notifie les observateurs selon le schéma de notification du projet. Renvoie le nouveau commentaire.
- Lister les projetsGETListe les projets que l'utilisateur peut voir, avec la key et l'id que prennent les outils d'issues et le JQL. Paginez avec startAt et maxResults jusqu'à ce que isLast vaille true.
- Lister les types d'issueGETListe les types d'issue que l'utilisateur peut créer dans un projet, avec l'id et le name que prennent Créer une issue et Lister les champs de création, et subtask true pour les types de sous-tâche.
- Lister les champs de créationGETListe les champs de l'écran de création pour un projet et un type d'issue : le fieldId que prend Créer une issue, s'il est obligatoire, son schema et ses valeurs autorisées avec leurs ids. Paginez avec startAt et maxResults jusqu'à total.
- Rechercher des utilisateurs assignablesGETTrouve les utilisateurs qui peuvent être assignés aux nouvelles issues d'un projet ou à une issue, avec l'accountId que prend le champ assignee. Envoyez project ou issueKey. Renvoie une liste, qui peut être plus courte que maxResults même s'il existe d'autres utilisateurs.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
