api-referenceGET
GET
https://analytics.flowsery.com/analytics/api/v1/issuesZwraca 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
| Parametr | Typ | Opis |
|---|---|---|
websiteId | string | ID witryny używane z tokenem API obszaru roboczego. Należy pominąć przy uwierzytelnianiu kluczem API witryny. |
domain | string | Domena 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 przezstatus=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 zwraca403 Forbidden z komunikatem "Upgrade to view this issue".Parametry opcjonalne
| Parametr | Typ | Opis |
|---|---|---|
status | string | Filtr według statusu: open, in_progress, resolved lub suspended. Po pominięciu zwraca wszystkie statusy poza suspended. |
severity | string | Filtr według ważności: low, medium, high lub critical. |
search | string | Wyszukiwanie tekstowe w tytułach i opisach problemów. Maksymalnie 200 znaków. |
sort | string | severity (domyślnie) stawia najpoważniejsze problemy na początku; recency sortuje według lastSeenAt, od najnowszych. |
limit | number | Maksymalna liczba zwracanych problemów (domyślnie: 100, maks.: 1000). |
offset | number | Liczba wierszy do pominięcia przy paginacji (min. 0, domyślnie: 0). |
Pola odpowiedzi
| Parametr | Typ | Opis |
|---|---|---|
id | string | Unikalny identyfikator problemu. Przekazywany jako issueId do punktów końcowych szczegółów i aktualizacji. |
websiteId | string | Witryna, do której należy problem. |
title | string | Krótkie streszczenie problemu wygenerowane przez AI. |
description | string | Wygenerowane przez AI wyjaśnienie, co działa źle i jak wpływa na odwiedzających. |
severity | string | Ocena wpływu nadana przez AI: low, medium, high lub critical. |
status | string | Status: open, in_progress, resolved lub suspended. |
sessionsCount | number | Liczba analizowanych sesji dotkniętych tym problemem. |
firstSeenAt | string | Kiedy problem wykryto po raz pierwszy w nagraniu. |
lastSeenAt | string | Najnowsze nagranie, w którym wystąpił problem. |
stepsToReplicate | array | Uporządkowane kroki odtworzenia wyprowadzone z nagrań, w których wystąpił problem. |
sampleRecordingId | string | Nagranie najlepiej pokazujące problem. |
externalTicketProvider / externalTicketKey / externalTicketUrl | string | null | Powiązane zgłoszenie w zewnętrznym narzędziu lub null, jeśli go nie ma. |
counts | object | Liczba 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
}
}