api-referenceGET
GET
https://analytics.flowsery.com/analytics/api/v1/issuesElenca i problemi che l'AI di Flowsery ha rilevato analizzando le registrazioni delle sessioni, deduplicati tra le sessioni e ordinati per gravità.
Bearer token (token del workspace o chiave API del sito)
I token del workspace richiedono un selettore del sito
I token API del workspace possono accedere a tutti i siti del workspace. PassawebsiteId o domain perché Flowsery sappia quale sito interrogare o modificare. Le chiavi API del sito sono già limitate a un sito, quindi puoi omettere il selettore.Selettore del sito
| Parametro | Tipo | Descrizione |
|---|---|---|
websiteId | string | ID del sito da usare con un token API del workspace. Omettilo se ti autentichi con una chiave API del sito. |
domain | string | Dominio del sito da usare con un token API del workspace quando websiteId non è indicato. Omettilo se ti autentichi con una chiave API del sito. |
I problemi sospesi sono nascosti per impostazione predefinita
L'elenco esclude i problemi sospesi, a meno che tu non li richieda esplicitamente constatus=suspended.La prova gratuita mostra i primi 10 problemi
Durante la prova gratuita l'elenco e i conteggi coprono solo i primi 10 problemi rilevati sul sito. Recuperare o aggiornare qualsiasi altro problema risponde403 Forbidden con il messaggio "Upgrade to view this issue".Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
status | string | Filtra per stato del flusso di lavoro: open, in_progress, resolved o suspended. Omettilo per ricevere tutti gli stati tranne suspended. |
severity | string | Filtra per gravità: low, medium, high o critical. |
search | string | Ricerca testuale su titoli e descrizioni dei problemi. Massimo 200 caratteri. |
sort | string | severity (predefinito) mette per primi i problemi più gravi; recency ordina per lastSeenAt, dal più recente. |
limit | number | Numero massimo di problemi da restituire (predefinito: 100, massimo: 1000). |
offset | number | Righe da saltare per la paginazione (minimo 0, predefinito: 0). |
Campi della risposta
| Parametro | Tipo | Descrizione |
|---|---|---|
id | string | Identificativo univoco del problema. Passalo come issueId agli endpoint di dettaglio e di aggiornamento. |
websiteId | string | Sito a cui appartiene il problema. |
title | string | Breve riepilogo del problema generato dall'AI. |
description | string | Spiegazione generata dall'AI di cosa non funziona e di come incide sui visitatori. |
severity | string | Valutazione dell'impatto assegnata dall'AI: low, medium, high o critical. |
status | string | Stato del flusso di lavoro: open, in_progress, resolved o suspended. |
sessionsCount | number | Quante sessioni analizzate hanno incontrato questo problema. |
firstSeenAt | string | Quando il problema è stato rilevato per la prima volta in una registrazione. |
lastSeenAt | string | Registrazione più recente in cui è comparso il problema. |
stepsToReplicate | array | Passaggi ordinati per riprodurre il problema, ricavati dalle registrazioni in cui si è verificato. |
sampleRecordingId | string | Registrazione che mostra meglio il problema. |
externalTicketProvider / externalTicketKey / externalTicketUrl | string | null | Ticket collegato in un tracker esterno, oppure null se non c'è alcun ticket collegato. |
counts | object | Totali dei problemi per stato (open, inProgress, resolved) per il sito selezionato, indipendenti dalla finestra di paginazione. |
Elenca tutti i problemi
curl --request GET \
--url https://analytics.flowsery.com/analytics/api/v1/issues \
--header 'Authorization: Bearer <api-key>'Filtra i problemi critici aperti
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
}
}