GET/api/v1/sessions/{id}

Сессия со всеми событиями

Возвращает одну сессию и все её события по порядку: переходы, клики, ввод, ошибки JavaScript со стектрейсом, упавшие и медленные сетевые запросы с кодом, временем и телом. Это и есть материал для разбора сбоя — по нему видно, что пользователь делал и что именно сломалось. Отдельно приходит признак наличия записи экрана.

Зачем нужен

  • Понять, что именно сломалось у конкретного пользователя, и передать это агенту
  • Достать тело упавшего запроса, чтобы воспроизвести ошибку локально
  • Собрать шаги воспроизведения бага из ленты действий

Параметры

ПараметрТипОписание
id*stringИдентификатор сессии из метода списка (часть пути, не query-параметр).

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

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

curl -H "Authorization: Bearer $LOGSY_API_KEY" \
  "https://logsy.ru/api/v1/sessions/clx8f2k0a0001qw"

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

{
  "project": { "id": "clx…", "name": "Мой сайт", "domain": "example.ru" },
  "session": {
    "id": "clx8f2k0a0001qw",
    "startedAt": "2026-08-18T09:14:02.331Z",
    "country": "RU",
    "events": { "total": 42, "errors": 3, "slow": 5 },
    "recording": { "available": true, "chunks": 12 }
  },
  "events": [
    { "id": "e1", "type": "NAVIGATION", "url": "https://example.ru/checkout", "createdAt": "2026-08-18T09:14:03.100Z" },
    {
      "id": "e2",
      "type": "HTTP_ERROR",
      "method": "POST",
      "url": "https://example.ru/api/pay",
      "statusCode": 502,
      "durationMs": 8421,
      "reqBody": "{\"orderId\":\"A-1024\"}",
      "resBody": "<html>502 Bad Gateway</html>",
      "createdAt": "2026-08-18T09:14:12.884Z"
    },
    {
      "id": "e3",
      "type": "ERROR",
      "message": "Uncaught TypeError: Cannot read properties of undefined (reading 'id')",
      "stack": "at pay (checkout.js:118:24)…",
      "createdAt": "2026-08-18T09:14:13.002Z"
    }
  ]
}

Поля ответа

ПолеТипЧто значит
session.recording.availablebooleanЕсть ли запись экрана для этой сессии.
events[].typestringТип события: ERROR, HTTP_ERROR, SLOW_REQUEST, NAVIGATION, CLICK, INPUT, USER_REPORT и другие.
events[].messagestring | nullТекст ошибки или подпись события.
events[].stackstring | nullСтектрейс JavaScript-ошибки.
events[].statusCodenumber | nullHTTP-код ответа для сетевых событий.
events[].durationMsnumber | nullДлительность запроса в миллисекундах.
events[].reqBodystring | nullТело запроса (пароли замаскированы на клиенте).
events[].resBodystring | nullТело ответа для упавших запросов.

Коды ответа

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