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.available | boolean | Есть ли запись экрана для этой сессии. |
| events[].type | string | Тип события: ERROR, HTTP_ERROR, SLOW_REQUEST, NAVIGATION, CLICK, INPUT, USER_REPORT и другие. |
| events[].message | string | null | Текст ошибки или подпись события. |
| events[].stack | string | null | Стектрейс JavaScript-ошибки. |
| events[].statusCode | number | null | HTTP-код ответа для сетевых событий. |
| events[].durationMs | number | null | Длительность запроса в миллисекундах. |
| events[].reqBody | string | null | Тело запроса (пароли замаскированы на клиенте). |
| events[].resBody | string | null | Тело ответа для упавших запросов. |
Коды ответа
- 200 — успех, тело в JSON.
- 401 — ключ не передан или неверный.
- 404 — сессия не найдена или уже удалена по сроку хранения.