api-referenceGET
GET
https://analytics.flowsery.com/analytics/api/v1/issuesToon de problemen die de AI van Flowsery vond bij het analyseren van sessieopnames, ontdubbeld over sessies en gerangschikt op ernst.
Bearer-token (werkruimtetoken of website-API-sleutel)
Werkruimtetokens hebben een websiteselector nodig
Werkruimte-API-tokens hebben toegang tot elke website in de werkruimte. GeefwebsiteId of domain mee, zodat Flowsery weet welke website je wilt opvragen of wijzigen. Website-API-sleutels horen al bij één website, dus daar kun je de selector weglaten.Websiteselector
| Parameter | Type | Beschrijving |
|---|---|---|
websiteId | string | Website-ID om te gebruiken met een werkruimte-API-token. Laat weg als je authenticeert met een website-API-sleutel. |
domain | string | Websitedomein om te gebruiken met een werkruimte-API-token als er geen websiteId is opgegeven. Laat weg als je authenticeert met een website-API-sleutel. |
Opgeschorte problemen zijn standaard verborgen
De lijst laat opgeschorte problemen weg, tenzij je ze expliciet opvraagt metstatus=suspended.Gratis proefperiode toont de eerste 10 problemen
Tijdens de gratis proefperiode bevatten de lijst en de tellingen alleen de eerste 10 problemen die op de website zijn gevonden. Elk ander probleem ophalen of bijwerken geeft403 Forbidden met het bericht "Upgrade to view this issue".Optionele parameters
| Parameter | Type | Beschrijving |
|---|---|---|
status | string | Filter op workflowstatus: open, in_progress, resolved of suspended. Laat weg om elke status behalve suspended te krijgen. |
severity | string | Filter op ernst: low, medium, high of critical. |
search | string | Zoekterm die wordt vergeleken met titels en beschrijvingen van problemen. Maximaal 200 tekens. |
sort | string | severity (standaard) zet de ernstigste problemen bovenaan; recency sorteert op lastSeenAt, nieuwste eerst. |
limit | number | Maximaal aantal problemen om terug te geven (standaard: 100, max.: 1000). |
offset | number | Aantal rijen om over te slaan voor paginering (min. 0, standaard: 0). |
Velden in het antwoord
| Parameter | Type | Beschrijving |
|---|---|---|
id | string | Unieke ID van het probleem. Geef hem mee als issueId aan de detail- en update-endpoints. |
websiteId | string | Website waar het probleem bij hoort. |
title | string | Korte, door AI gegenereerde samenvatting van het probleem. |
description | string | Door AI gegenereerde uitleg van wat er misgaat en hoe het bezoekers raakt. |
severity | string | Door AI toegekende impact: low, medium, high of critical. |
status | string | Workflowstatus: open, in_progress, resolved of suspended. |
sessionsCount | number | Hoeveel geanalyseerde sessies dit probleem tegenkwamen. |
firstSeenAt | string | Wanneer het probleem voor het eerst in een opname werd gevonden. |
lastSeenAt | string | Meest recente opname waarin het probleem voorkwam. |
stepsToReplicate | array | Geordende reproductiestappen, afgeleid uit de opnames waarin het probleem optrad. |
sampleRecordingId | string | Opname die het probleem het best laat zien. |
externalTicketProvider / externalTicketKey / externalTicketUrl | string | null | Gekoppeld ticket in een externe tracker, of null als er geen ticket is gekoppeld. |
counts | object | Totaal aantal problemen per status (open, inProgress, resolved) voor de geselecteerde website, los van het pagineringsvenster. |
Alle problemen tonen
curl --request GET \
--url https://analytics.flowsery.com/analytics/api/v1/issues \
--header 'Authorization: Bearer <api-key>'Filteren op open, kritieke problemen
curl --request GET \
--url "https://analytics.flowsery.com/analytics/api/v1/issues?status=open&severity=critical&search=checkout&sort=recency" \
--header 'Authorization: Bearer <api-key>'200
{
"status": "success",
"data": [
{
"id": "iss_64f1c2a9e8b4d90012ab34cd",
"websiteId": "cm8abc123",
"title": "Checkout button unresponsive on mobile Safari",
"description": "Tapping the checkout button produces no navigation or feedback. Visitors tap repeatedly and abandon the cart.",
"severity": "critical",
"status": "open",
"sessionsCount": 14,
"firstSeenAt": "2026-08-02T09:14:31.000Z",
"lastSeenAt": "2026-08-27T18:40:05.000Z",
"stepsToReplicate": [
"Open the store on an iPhone in Safari",
"Add any product to the cart",
"Tap the checkout button on the cart page"
],
"sampleRecordingId": "rec_9f8e7d6c5b4a",
"externalTicketProvider": "linear",
"externalTicketKey": "SHOP-142",
"externalTicketUrl": "https://linear.app/acme/issue/SHOP-142"
},
{
"id": "iss_64f1c2a9e8b4d90012ab34ce",
"websiteId": "cm8abc123",
"title": "Pricing table overflows on narrow viewports",
"description": "The pricing table renders outside the viewport below 375px, hiding the yearly plan column.",
"severity": "medium",
"status": "in_progress",
"sessionsCount": 6,
"firstSeenAt": "2026-08-10T12:03:12.000Z",
"lastSeenAt": "2026-08-25T07:55:48.000Z",
"stepsToReplicate": [
"Open /pricing on a viewport narrower than 375px",
"Scroll horizontally inside the pricing table"
],
"sampleRecordingId": "rec_1a2b3c4d5e6f",
"externalTicketProvider": null,
"externalTicketKey": null,
"externalTicketUrl": null
}
],
"counts": {
"open": 5,
"inProgress": 2,
"resolved": 11
},
"pagination": {
"limit": 100,
"offset": 0,
"total": 7
}
}