GET/api/v1/sessions

Список сессий проекта

Возвращает сессии посетителей от самой свежей активности к старой: кто пришёл (IP, страна, User-Agent, метки перехода) и сколько в сессии событий, ошибок и медленных запросов. Ответ постраничный — по нему удобно искать сессии, в которых что-то сломалось, и уже потом запрашивать их детально.

Зачем нужен

→Найти сессии, в которых были ошибки, за вчерашний день
→Выгрузить визиты с конкретной рекламной кампании по метке utm_source
→Посчитать, сколько посетителей столкнулось с медленной загрузкой

Параметры

Параметр	Тип	Описание
date	YYYY-MM-DD	Сессии, начавшиеся в указанные сутки (UTC). Короткая замена пары from/to: если передан, перекрывает их.
from	ISO-8601	Начало периода по времени старта сессии, включительно.
to	ISO-8601	Конец периода по времени старта сессии, не включая границу.
limit	1…200	Сколько сессий вернуть. По умолчанию 50.
offset	≥ 0	Сколько сессий пропустить — постраничный обход. По умолчанию 0.

Пример запроса

Ключ проекта лежит в панели на вкладке «API»; в примере он берётся из переменной окружения LOGSY_API_KEY.

curl -H "Authorization: Bearer $LOGSY_API_KEY" \
  "https://logsy.ru/api/v1/sessions?date=2026-08-18&limit=50"

Пример ответа

{
  "project": { "id": "clx…", "name": "Мой сайт", "domain": "example.ru" },
  "total": 128,
  "limit": 50,
  "offset": 0,
  "sessions": [
    {
      "id": "clx8f2k0a0001qw",
      "sessionKey": "s-1755500000-9f3a",
      "startedAt": "2026-08-18T09:14:02.331Z",
      "lastSeenAt": "2026-08-18T09:21:47.902Z",
      "ip": "203.0.113.17",
      "country": "RU",
      "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X)…",
      "utm": { "utm_source": "yandex", "utm_medium": "cpc" },
      "events": { "total": 42, "errors": 3, "slow": 5 }
    }
  ]
}

Поля ответа

Поле	Тип	Что значит
total	number	Сколько сессий попало под фильтр целиком, без учёта limit.
sessions[].id	string	Идентификатор сессии — им запрашиваются события.
sessions[].startedAt	ISO-8601	Когда сессия началась.
sessions[].country	string \| null	Страна посетителя по IP, ISO-3166 alpha-2.
sessions[].utm	object \| null	Метки перехода: utm_source, utm_medium, yclid и прочие.
sessions[].events.errors	number	Сколько ошибок в сессии — по этому полю ищут сломанные визиты.
sessions[].events.slow	number	Сколько медленных запросов и ресурсов в сессии.

Коды ответа

200 — успех, тело в JSON.
401 — ключ не передан или неверный.