api-referenceGET
GEThttps://analytics.flowsery.com/analytics/api/v1/issues

Toon 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. Geef websiteId 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

ParameterTypeBeschrijving
websiteIdstringWebsite-ID om te gebruiken met een werkruimte-API-token. Laat weg als je authenticeert met een website-API-sleutel.
domainstringWebsitedomein 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 met status=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 geeft 403 Forbidden met het bericht "Upgrade to view this issue".

Optionele parameters

ParameterTypeBeschrijving
statusstringFilter op workflowstatus: open, in_progress, resolved of suspended. Laat weg om elke status behalve suspended te krijgen.
severitystringFilter op ernst: low, medium, high of critical.
searchstringZoekterm die wordt vergeleken met titels en beschrijvingen van problemen. Maximaal 200 tekens.
sortstringseverity (standaard) zet de ernstigste problemen bovenaan; recency sorteert op lastSeenAt, nieuwste eerst.
limitnumberMaximaal aantal problemen om terug te geven (standaard: 100, max.: 1000).
offsetnumberAantal rijen om over te slaan voor paginering (min. 0, standaard: 0).

Velden in het antwoord

ParameterTypeBeschrijving
idstringUnieke ID van het probleem. Geef hem mee als issueId aan de detail- en update-endpoints.
websiteIdstringWebsite waar het probleem bij hoort.
titlestringKorte, door AI gegenereerde samenvatting van het probleem.
descriptionstringDoor AI gegenereerde uitleg van wat er misgaat en hoe het bezoekers raakt.
severitystringDoor AI toegekende impact: low, medium, high of critical.
statusstringWorkflowstatus: open, in_progress, resolved of suspended.
sessionsCountnumberHoeveel geanalyseerde sessies dit probleem tegenkwamen.
firstSeenAtstringWanneer het probleem voor het eerst in een opname werd gevonden.
lastSeenAtstringMeest recente opname waarin het probleem voorkwam.
stepsToReplicatearrayGeordende reproductiestappen, afgeleid uit de opnames waarin het probleem optrad.
sampleRecordingIdstringOpname die het probleem het best laat zien.
externalTicketProvider / externalTicketKey / externalTicketUrlstring | nullGekoppeld ticket in een externe tracker, of null als er geen ticket is gekoppeld.
countsobjectTotaal 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
  }
}