Naar hoofdinhoud gaan
De Public API (V2) is een REST API voor het lezen van ruwe applicatiegegevens: metrics, traces, logs, Kubernetes-metrics en deploy-statistieken. Het vormt een aanvulling op de GraphQL API, die modellen beheert zoals apps, incidenten, dashboards en alerts. Als vuistregel: gebruik de REST API om gegevens te lezen en de GraphQL API om configuratie te beheren.
Bent u een AI-agent of -assistent aan het bouwen, dan stelt AppSignal MCP deze gegevens rechtstreeks beschikbaar voor agents — u hoeft deze API mogelijk niet zelf aan te roepen.

​
Basis-URL

Alle eindpunten worden geserveerd onder /api/v2 op het domein appsignal.com: 
https://appsignal.com/api/v2

​
Authenticatie

Verzoeken worden geauthenticeerd met uw persoonlijke API-token, meegestuurd als bearer-token of als query-parameter. U vindt uw token in het scherm met persoonlijke instellingen. 
curl -H "Authorization: Bearer YOUR-PERSONAL-API-TOKEN" \
  https://appsignal.com/api/v2/metrics/names/YOUR-SITE-ID
Uw token geeft toegang tot dezelfde sites en organisaties die u in AppSignal kunt zien. De meeste verzoeken zijn beperkt tot één site_id; tracing-eindpunten gebruiken een site_ids-array zodat ze over meerdere sites kunnen zoeken. De API controleert of uw token toegang heeft tot elke opgevraagde site voordat er gegevens worden geretourneerd. Om een token zelf te verifiëren, roept u GET /api/v2/auth aan. Uw site_id is de ID in de URL van uw app: https://appsignal.com/<organization>/sites/<SITE_ID>. Voor logqueries heeft u ook een log source-ID nodig — zie uw site- en bron-ID’s vinden.

​
Een token verifiëren

GET /api/v2/auth
Retourneert een JSON-object met een message die het geauthenticeerde gebruikers-ID bevestigt.

​
Verzoeken en responses

De meeste eindpunten gebruiken POST met een JSON-body en retourneren JSON. Alleen-lezen-opzoekingen (zoals het opsommen van metric-namen) gebruiken GET met padparameters. Stel Content-Type: application/json in op verzoeken met een body. Tijden zijn ISO 8601-strings. De meeste querybodies nemen een from- en to-tijdsbereik plus ofwel een site_id of, voor tracing-eindpunten, een site_ids-array. Voor een volledige, automatisch gegenereerde referentie van elk eindpunt, verzoek en responstype, zie de REST API-referentie.

​
Foutresponses

Elk eindpunt kan deze niet-2xx-responses retourneren:
StatusBetekenisBody
401Ontbrekende of ongeldige token{ "error": "Unauthorized" }
404Route of resource niet gevonden{ "error": "Not found" }
422Verzoek geparsed maar kan niet worden verwerktFoutenvelop (zie de volgende sectie)
500Onafgehandelde server-side fout{ "error": "<message>" }

​
422-envelop

Elke 422-response gebruikt dezelfde envelop, zodat u ze op één plek kunt afhandelen: 
{
  "error": "<stable_slug>",
  "message": "<human-readable message>",
  "details": {}
}
  • error: een stabiele, machineleesbare slug. Vertak hierop in uw code.
  • message: een menselijk leesbare boodschap, veilig om weer te geven.
  • details: een optioneel object waarvan de vorm afhangt van error.
Eén slug die u kunt tegenkomen is legacy_log_query_syntax, geretourneerd wanneer een logs- query gebruikmaakt van de verouderde syntax attributes.<name>_<type>. Zie logs opvragen voor de huidige querytaal.

​
Eindpunten

​
Metrics

MethodePadBeschrijving
POST/api/v2/metrics/timeseriesMetricgegevens opvragen als timeseries
POST/api/v2/metrics/listGeaggregeerde metricgegevens opvragen als lijst met groepering
GET/api/v2/metrics/names/{site_id}Alle metric-namen voor een site opsommen
GET/api/v2/metrics/type_and_tags/{site_id}/{metric_name}Type en beschikbare tags van een metric ophalen
Zie de metrics-referentie.

​
Tracing

MethodePadBeschrijving
POST/api/v2/tracing/locatorEen trace lokaliseren over sites op trace-ID
POST/api/v2/tracing/traceAlle spans voor een trace ophalen
POST/api/v2/tracing/trace/performanceSpans voor een performance-trace ophalen
POST/api/v2/tracing/trace/errorSpans voor een error-trace ophalen
POST/api/v2/tracing/traces/performancePerformance-traces opsommen
POST/api/v2/tracing/traces/errorsError-traces opsommen
POST/api/v2/tracing/actionsPerformance-acties met geaggregeerde metrics opsommen
POST/api/v2/tracing/action_edgesUpstream- en downstream-edges voor een actie opsommen
POST/api/v2/tracing/site_edgesEdges voor service-afhankelijkheden voor een site opsommen
POST/api/v2/tracing/slow_eventsTrage events met geaggregeerde stats opsommen
POST/api/v2/tracing/slow_events/actionsActies gerelateerd aan een traag event opsommen
Zie de tracing-referentie.

​
Logs

MethodePadBeschrijving
POST/api/v2/logs/linesLogregels doorzoeken
Zie de logs-referentie.

​
Kubernetes

MethodePadBeschrijving
POST/api/v2/kubernetes/nodesNode-metrics opvragen
POST/api/v2/kubernetes/podsPod-metrics opvragen
POST/api/v2/kubernetes/pods/overviewPod-overzicht met labels en status opvragen
Zie de Kubernetes-referentie.

​
Deploys

MethodePadBeschrijving
POST/api/v2/deploys/statsDeploy-statistieken voor een revisie ophalen
Zie de deploys-referentie.

​
Check-ins

MethodePadBeschrijving
POST/api/v2/check_ins/test_cronEen cron-schema-expressie testen en valideren
Zie de check-ins-referentie.

​
Opgeslagen visuals

MethodePadBeschrijving
GET/api/v2/saved_visuals/{id}Een opgeslagen visual ophalen als JSON
GET/api/v2/saved_visuals/{id}/csvEen opgeslagen visual downloaden als CSV
Eindpunten voor opgeslagen visuals vereisen geen authenticatie. Zie de opgeslagen visuals- referentie.

​
Systeem

MethodePadBeschrijving
GET/api/v2/authVerifiëren of een token geldig is