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

Elenca 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. Passa websiteId 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

ParametroTipoDescrizione
websiteIdstringID del sito da usare con un token API del workspace. Omettilo se ti autentichi con una chiave API del sito.
domainstringDominio 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 con status=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 risponde 403 Forbidden con il messaggio "Upgrade to view this issue".

Parametri facoltativi

ParametroTipoDescrizione
statusstringFiltra per stato del flusso di lavoro: open, in_progress, resolved o suspended. Omettilo per ricevere tutti gli stati tranne suspended.
severitystringFiltra per gravità: low, medium, high o critical.
searchstringRicerca testuale su titoli e descrizioni dei problemi. Massimo 200 caratteri.
sortstringseverity (predefinito) mette per primi i problemi più gravi; recency ordina per lastSeenAt, dal più recente.
limitnumberNumero massimo di problemi da restituire (predefinito: 100, massimo: 1000).
offsetnumberRighe da saltare per la paginazione (minimo 0, predefinito: 0).

Campi della risposta

ParametroTipoDescrizione
idstringIdentificativo univoco del problema. Passalo come issueId agli endpoint di dettaglio e di aggiornamento.
websiteIdstringSito a cui appartiene il problema.
titlestringBreve riepilogo del problema generato dall'AI.
descriptionstringSpiegazione generata dall'AI di cosa non funziona e di come incide sui visitatori.
severitystringValutazione dell'impatto assegnata dall'AI: low, medium, high o critical.
statusstringStato del flusso di lavoro: open, in_progress, resolved o suspended.
sessionsCountnumberQuante sessioni analizzate hanno incontrato questo problema.
firstSeenAtstringQuando il problema è stato rilevato per la prima volta in una registrazione.
lastSeenAtstringRegistrazione più recente in cui è comparso il problema.
stepsToReplicatearrayPassaggi ordinati per riprodurre il problema, ricavati dalle registrazioni in cui si è verificato.
sampleRecordingIdstringRegistrazione che mostra meglio il problema.
externalTicketProvider / externalTicketKey / externalTicketUrlstring | nullTicket collegato in un tracker esterno, oppure null se non c'è alcun ticket collegato.
countsobjectTotali 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
  }
}