Outils pour développeurs
Sentry dans votre produit et vos agents IA, via une API
Le toolkit Sentry couvre les organisations, projets, issues et événements d'erreur avec stack trace, tags et contexte. Votre client se connecte une fois avec une API key, et votre produit ou agent IA appelle chaque opération via Connect, qui stocke l'identifiant et journalise chaque exécution.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/sentry_list_organizations/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"query": "<query>"
}
}Fonctionnement
Du client connecté au premier appel à Sentry.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Sentry. 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 Sentry.
Afficher les erreurs dans votre produit
Listez les issues non résolues d'un client avec le nombre d'événements et d'utilisateurs pour que votre SaaS montre ce qui casse, à côté de l'app surveillée.
Boucler depuis votre outil de tickets
Résolvez, archivez ou assignez une issue Sentry quand le ticket correspondant change d'état dans votre produit.
Tri avec un agent IA
Laissez un agent lire une issue, récupérer l'événement le plus récent avec la stack trace et les valeurs de tag principales, et proposer qui doit s'en occuper.
Tools
11 tools Sentry
- Lister les organisationsGETListe les organisations accessibles avec le jeton dans cet emplacement de stockage de données, chacune avec id, slug et name. Le slug est l'organization_id_or_slug que demandent les autres outils. Renvoie jusqu'à 100.
- Lister les projetsGETListe les projets d'une organisation, chacun avec id, slug, name et platform. Le slug est le project_id_or_slug que demandent les outils de projet. Renvoie jusqu'à 100 ; affinez avec query.
- Obtenir un projetGETRenvoie un projet avec name, platform, équipes, statut et paramètres.
- Lister les issuesGETListe les issues d'une organisation, par défaut les non résolues triées par dernière occurrence. Chaque issue contient id, shortId, title, status, level, nombre d'événements, nombre d'utilisateurs, première et dernière occurrence et projet. Renvoie jusqu'à 100 ; affinez avec query, project et statsPeriod.
- Obtenir une issueGETRenvoie une issue avec title, culprit, status, level, assigné, compteurs, première et dernière occurrence, release et principaux tags.
- Mettre à jour une issuePUTRésout, archive, rouvre, assigne ou change la priorité d'une issue. Seuls les champs envoyés changent. Pour archiver, envoyez status ignored avec un substatus, et la condition dans statusDetails quand c'est archived_until_condition_met.
- Lister les événements d'une issueGETListe les événements d'une issue, 100 par page. Avec full true chaque événement contient la stack trace, et la page tombe à 10.
- Obtenir un événement d'une issueGETRenvoie un événement d'une issue avec stack trace, tags, contexte, breadcrumbs et request. Utilisez latest, oldest ou recommended comme event_id quand vous n'avez pas d'id d'événement.
- Obtenir un tag d'une issueGETRenvoie les valeurs les plus fréquentes d'un tag parmi les événements d'une issue, avec le compte de chacune, comme les navigateurs ou releases concernés.
- Lister les événements d'un projetGETListe les événements d'erreur d'un projet, 100 par page. Avec full true chaque événement contient la stack trace, et la page tombe à 10.
Clé d'API
Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.
À la connexion, votre client indique aussi {region} : l'adresse de son compte sur l'API de l'app.
Questions sur le toolkit Sentry
Dois-je intégrer l'API Sentry moi-même ?
Non. Connect fournit 11 tools Sentry 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 Sentry ?
Avec le mode accepté par le toolkit : Clé d'API. 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.
Toolkits de la même catégorie
Voir les 100 toolkitsVoyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
