api-referenceGET
GEThttps://analytics.flowsery.com/analytics/api/v1/realtime/map

Pobiera odwiedzających aktywnych w witrynie w ciągu ostatnich 5 minut wraz z lokalizacją i szczegółami sesji, gotowych do naniesienia na mapę.

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.

Uwagi

Zwraca do 1000 odwiedzających aktywnych w ciągu ostatnich 5 minut, od najnowszych. Odpytywać można najwyżej raz na 5 sekund. Pola o nieznanej wartości są pomijane w obiekcie odwiedzającego. name i email pochodzą z zarejestrowanych płatności, więc pojawiają się tylko dla odwiedzających, którzy zapłacili; należy traktować je jako dane osobowe. Filtry zakresu dat nie są obsługiwane; do danych geograficznych z zakresu dat służą /countries lub /cities.
Przykładowe żądanie (Curl)
curl --request GET \
  --url https://analytics.flowsery.com/analytics/api/v1/realtime/map \
  --header 'Authorization: Bearer <api-key>'
200
{
  "status": "success",
  "data": [
    {
      "visitorId": "vis_9f2c1a7e",
      "visitorUid": "user_4821",
      "country": "United States",
      "countryCode": "US",
      "region": "California",
      "city": "San Francisco",
      "latitude": 37.7749,
      "longitude": -122.4194,
      "browser": "Chrome",
      "os": "Mac OS",
      "deviceType": "Desktop",
      "currentUrl": "https://example.com/pricing",
      "referrer": "https://www.google.com/",
      "referrerSource": "Google",
      "referrerIconUrl": "https://icons.duckduckgo.com/ip3/google.com.ico",
      "sessionStartTime": "2026-04-14T08:27:12.000Z",
      "pageviews": 4,
      "totalRevenue": 129,
      "isCustomer": true,
      "name": "Jane Doe",
      "email": "jane@example.com"
    },
    {
      "visitorId": "vis_b81d40c3",
      "country": "Germany",
      "countryCode": "DE",
      "city": "Berlin",
      "latitude": 52.52,
      "longitude": 13.405,
      "browser": "Safari",
      "os": "iOS",
      "deviceType": "Mobile",
      "currentUrl": "https://example.com/",
      "sessionStartTime": "2026-04-14T08:29:45.000Z",
      "pageviews": 1,
      "totalRevenue": 0,
      "isCustomer": false
    }
  ]
}