Gestion de projet
Jira dans votre produit et vos agents IA, via une API
Le toolkit Jira couvre les issues, les transitions, les commentaires, les projets, les types d'issue et les champs de création : rechercher en JQL, créer et modifier des issues, les faire avancer dans leur workflow, commenter et retrouver les ids et utilisateurs assignables dont les autres appels ont besoin. Le client se connecte avec les identifiants de son site, et votre produit ou agent IA appelle chaque opération via un seul endpoint Connect.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/jira_create_issue/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"fields": {}
}
}Fonctionnement
Du client connecté au premier appel à Jira.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Jira. Vous recevez l'id de la connexion.
- 2
Votre produit appelle la tool
Un POST sur /api/tools/{tool}/execute avec l'id de la connexion et les arguments. En cas de succès, Connect conserve le statut et le corps de la réponse de l'app.
- 3
Connect s'occupe du reste
Il stocke l'identifiant chiffré, renouvelle les tokens des connexions OAuth qui le permettent et enregistre les exécutions dans un journal d'audit consultable via l'API.
Cas d'usage
Ce que votre produit fait avec Jira.
Des tickets issus des retours
Créez une issue Jira à partir d'un rapport de bug ou d'une demande de support dans votre produit, avec les champs que Lister les champs de création montre pour le projet.
Statut synchronisé avec votre app
Recherchez des issues en JQL, lisez leur statut et lancez une transition quand une tâche se termine chez vous, par exemple passer une issue à Done.
Agent IA pour le suivi de projet
Laissez un agent trouver les utilisateurs assignables, assigner du travail, commenter et lister les transitions disponibles d'une issue avant d'en lancer une.
Tools
13 tools Jira
- 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.
Identifiant et mot de passe
Votre client saisit les identifiants de l'app sur un écran de Connect, ou votre système les envoie avec POST /api/customer-toolkits, sans écran.
À la connexion, votre client indique aussi {site} : l'adresse de son compte sur l'API de l'app.
Questions sur le toolkit Jira
Dois-je intégrer l'API Jira moi-même ?
Non. Connect fournit 13 tools Jira décrites et prêtes. Votre client connecte son compte et votre système appelle chaque tool par le même endpoint, avec le même format de requête.
Comment mon client connecte-t-il son compte Jira ?
Avec le mode accepté par le toolkit : Identifiant et mot de passe. Connect stocke l'identifiant chiffré et ne le renvoie jamais à votre système.
Est-ce compatible avec les agents IA ?
Oui. L'input de chaque tool est décrit en JSON Schema, que votre agent utilise directement comme définition de tool. L'agent choisit la tool et les arguments, et votre système fait l'appel à Connect.
Mon client doit-il avoir un compte Reportei ?
Non. Votre client connecte son compte sur un écran de Connect, ou votre système envoie l'identifiant via l'API, et il continue d'utiliser uniquement votre produit.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
