api-referenceGET
GET
https://analytics.flowsery.com/analytics/api/v1/realtime/mapPobiera 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
| 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. |
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
}
]
}