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

Zwraca problemy wykryte przez AI Flowsery podczas analizy nagrań sesji, bez duplikatów między sesjami i uporządkowane według ważności.

Bearer Token (token obszaru roboczego lub klucz API witryny)

Tokeny obszaru roboczego wymagają wskazania witryny

Tokeny API obszaru roboczego mają dostęp do wszystkich witryn w obszarze. Należy przekazać websiteId lub domain, aby Flowsery wiedziało, której witryny dotyczy zapytanie lub zmiana. Klucze API witryn są już przypisane do jednej witryny, więc można to pominąć.

Wskazanie witryny

ParametrTypOpis
websiteIdstringID witryny używane z tokenem API obszaru roboczego. Należy pominąć przy uwierzytelnianiu kluczem API witryny.
domainstringDomena witryny używana z tokenem API obszaru roboczego, gdy nie podano websiteId. Należy pominąć przy uwierzytelnianiu kluczem API witryny.

Zawieszone problemy są domyślnie ukryte

Lista pomija zawieszone problemy, chyba że zażąda się ich wprost przez status=suspended.

Okres próbny pokazuje 10 pierwszych problemów

W okresie próbnym lista i liczniki obejmują tylko 10 pierwszych problemów wykrytych w witrynie. Pobranie lub aktualizacja każdego innego zwraca 403 Forbidden z komunikatem "Upgrade to view this issue".

Parametry opcjonalne

ParametrTypOpis
statusstringFiltr według statusu: open, in_progress, resolved lub suspended. Po pominięciu zwraca wszystkie statusy poza suspended.
severitystringFiltr według ważności: low, medium, high lub critical.
searchstringWyszukiwanie tekstowe w tytułach i opisach problemów. Maksymalnie 200 znaków.
sortstringseverity (domyślnie) stawia najpoważniejsze problemy na początku; recency sortuje według lastSeenAt, od najnowszych.
limitnumberMaksymalna liczba zwracanych problemów (domyślnie: 100, maks.: 1000).
offsetnumberLiczba wierszy do pominięcia przy paginacji (min. 0, domyślnie: 0).

Pola odpowiedzi

ParametrTypOpis
idstringUnikalny identyfikator problemu. Przekazywany jako issueId do punktów końcowych szczegółów i aktualizacji.
websiteIdstringWitryna, do której należy problem.
titlestringKrótkie streszczenie problemu wygenerowane przez AI.
descriptionstringWygenerowane przez AI wyjaśnienie, co działa źle i jak wpływa na odwiedzających.
severitystringOcena wpływu nadana przez AI: low, medium, high lub critical.
statusstringStatus: open, in_progress, resolved lub suspended.
sessionsCountnumberLiczba analizowanych sesji dotkniętych tym problemem.
firstSeenAtstringKiedy problem wykryto po raz pierwszy w nagraniu.
lastSeenAtstringNajnowsze nagranie, w którym wystąpił problem.
stepsToReplicatearrayUporządkowane kroki odtworzenia wyprowadzone z nagrań, w których wystąpił problem.
sampleRecordingIdstringNagranie najlepiej pokazujące problem.
externalTicketProvider / externalTicketKey / externalTicketUrlstring | nullPowiązane zgłoszenie w zewnętrznym narzędziu lub null, jeśli go nie ma.
countsobjectLiczba problemów według statusu (open, inProgress, resolved) dla wybranej witryny, niezależnie od paginacji.
Lista wszystkich problemów
curl --request GET \
  --url https://analytics.flowsery.com/analytics/api/v1/issues \
  --header 'Authorization: Bearer <api-key>'
Filtrowanie otwartych problemów krytycznych
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
  }
}