Passer au contenu principal
L’API publique (V2) est une API REST permettant de lire les données brutes des applications : métriques, traces, journaux, métriques Kubernetes et statistiques de déploiement. Elle complète l’API GraphQL, qui gère les modèles tels que les apps, les incidents, les tableaux de bord et les alertes. En règle générale, utilisez l’API REST pour lire les données et l’API GraphQL pour gérer la configuration.
Si vous créez un agent ou un assistant IA, AppSignal MCP expose ces données directement aux agents — vous n’avez peut-être pas besoin d’appeler cette API vous-même.

​
URL de base

Tous les points de terminaison sont servis sous /api/v2 sur le domaine appsignal.com : 
https://appsignal.com/api/v2

​
Authentification

Les requêtes sont authentifiées avec votre jeton d’API personnel, transmis soit en tant que jeton bearer, soit en tant que paramètre de requête. Vous pouvez trouver votre jeton dans l’écran des paramètres personnels. 
curl -H "Authorization: Bearer YOUR-PERSONAL-API-TOKEN" \
  https://appsignal.com/api/v2/metrics/names/YOUR-SITE-ID
Votre jeton donne accès aux mêmes sites et organisations que ceux que vous pouvez voir dans AppSignal. La plupart des requêtes sont limitées à un seul site_id ; les points de terminaison de traçage utilisent un tableau site_ids afin de pouvoir effectuer des recherches sur plusieurs sites. L’API vérifie que votre jeton a accès à chaque site demandé avant de renvoyer les données. Pour vérifier un jeton lui-même, appelez GET /api/v2/auth. Votre site_id est l’ID figurant dans l’URL de votre app : https://appsignal.com/<organization>/sites/<SITE_ID>. Pour les requêtes de journaux, vous avez également besoin d’un ID de source de journal — voir trouver vos IDs de site et de source.

​
Vérifier un jeton

GET /api/v2/auth
Renvoie un objet JSON avec un message confirmant l’ID de l’utilisateur authentifié.

​
Requêtes et réponses

La plupart des points de terminaison utilisent POST avec un corps JSON et renvoient du JSON. Les recherches en lecture seule (telles que la liste des noms de métriques) utilisent GET avec des paramètres de chemin. Définissez Content-Type: application/json sur les requêtes comportant un corps. Les heures sont des chaînes ISO 8601. La plupart des corps de requête prennent une plage temporelle from et to plus soit un site_id, soit, pour les points de terminaison de traçage, un tableau site_ids. Pour une référence complète et générée automatiquement de chaque point de terminaison, requête et type de réponse, consultez la référence de l’API REST.

​
Réponses d’erreur

Tout point de terminaison peut renvoyer ces réponses non-2xx :
StatutSignificationCorps
401Jeton manquant ou invalide{ "error": "Unauthorized" }
404Route ou ressource introuvable{ "error": "Not found" }
422Requête analysée mais impossible à traiterEnveloppe d’erreur (voir la section suivante)
500Échec côté serveur non géré{ "error": "<message>" }

​
Enveloppe 422

Chaque réponse 422 utilise la même enveloppe, vous pouvez donc les gérer en un seul endroit : 
{
  "error": "<stable_slug>",
  "message": "<human-readable message>",
  "details": {}
}
  • error : un slug stable et lisible par machine. Branchez-vous dessus dans votre code.
  • message : un message lisible par l’humain, sûr à afficher.
  • details : un objet optionnel dont la forme dépend de error.
Un slug que vous pourrez rencontrer est legacy_log_query_syntax, renvoyé lorsqu’une requête de journaux utilise l’ancienne syntaxe attributes.<name>_<type>. Voir requêtes de journaux pour le langage de requête actuel.

​
Points de terminaison

​
Métriques

MéthodeCheminDescription
POST/api/v2/metrics/timeseriesInterroger les données de métriques sous forme de série temporelle
POST/api/v2/metrics/listInterroger les données de métriques agrégées sous forme de liste avec regroupement
GET/api/v2/metrics/names/{site_id}Lister tous les noms de métriques pour un site
GET/api/v2/metrics/type_and_tags/{site_id}/{metric_name}Obtenir le type d’une métrique et les tags disponibles
Voir la référence des métriques.

​
Traçage

MéthodeCheminDescription
POST/api/v2/tracing/locatorLocaliser une trace à travers les sites par ID de trace
POST/api/v2/tracing/traceObtenir tous les spans d’une trace
POST/api/v2/tracing/trace/performanceObtenir les spans d’une trace de performance
POST/api/v2/tracing/trace/errorObtenir les spans d’une trace d’erreur
POST/api/v2/tracing/traces/performanceLister les traces de performance
POST/api/v2/tracing/traces/errorsLister les traces d’erreur
POST/api/v2/tracing/actionsLister les actions de performance avec métriques agrégées
POST/api/v2/tracing/action_edgesLister les arêtes amont et aval pour une action
POST/api/v2/tracing/site_edgesLister les arêtes de dépendances de services pour un site
POST/api/v2/tracing/slow_eventsLister les événements lents avec statistiques agrégées
POST/api/v2/tracing/slow_events/actionsLister les actions liées à un événement lent
Voir la référence de traçage.

​
Journaux

MéthodeCheminDescription
POST/api/v2/logs/linesRechercher des lignes de journal
Voir la référence des journaux.

​
Kubernetes

MéthodeCheminDescription
POST/api/v2/kubernetes/nodesInterroger les métriques de nœud
POST/api/v2/kubernetes/podsInterroger les métriques de pod
POST/api/v2/kubernetes/pods/overviewInterroger la vue d’ensemble des pods avec labels et statut
Voir la référence Kubernetes.

​
Déploiements

MéthodeCheminDescription
POST/api/v2/deploys/statsObtenir les statistiques de déploiement pour une révision
Voir la référence des déploiements.

​
Check-ins

MéthodeCheminDescription
POST/api/v2/check_ins/test_cronTester et valider une expression de planification cron
Voir la référence des check-ins.

​
Visuels enregistrés

MéthodeCheminDescription
GET/api/v2/saved_visuals/{id}Récupérer un visuel enregistré au format JSON
GET/api/v2/saved_visuals/{id}/csvTélécharger un visuel enregistré au format CSV
Les points de terminaison des visuels enregistrés ne nécessitent pas d’authentification. Voir la référence des visuels enregistrés.

​
Système

MéthodeCheminDescription
GET/api/v2/authVérifier qu’un jeton est valide