{"openapi":"3.1.0","info":{"title":"Logsy API","version":"1.0.0","description":"Публичное HTTP-API проекта Logsy: пользовательские сессии сайта и их события — ошибки JavaScript, упавшие и медленные запросы, действия посетителя. Авторизация ключом проекта.","contact":{"url":"https://logsy.ru/docs/api"}},"servers":[{"url":"https://logsy.ru"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Ключ проекта из панели Logsy"},"apiKeyHeader":{"type":"apiKey","in":"header","name":"X-Api-Key"}},"schemas":{"Session":{"type":"object","properties":{"id":{"type":"string"},"sessionKey":{"type":"string"},"startedAt":{"type":"string","format":"date-time"},"lastSeenAt":{"type":"string","format":"date-time"},"ip":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"userAgent":{"type":"string","nullable":true},"utm":{"type":"object","nullable":true,"additionalProperties":{"type":"string"}},"events":{"type":"object","properties":{"total":{"type":"integer"},"errors":{"type":"integer"},"slow":{"type":"integer"}}}}}}},"security":[{"bearerAuth":[]},{"apiKeyHeader":[]}],"paths":{"/api/v1/sessions":{"get":{"operationId":"listSessions","summary":"Пользовательские сессии сайта со счётчиками ошибок и медленных запросов.","description":"Возвращает сессии посетителей от самой свежей активности к старой: кто пришёл (IP, страна, User-Agent, метки перехода) и сколько в сессии событий, ошибок и медленных запросов. Ответ постраничный — по нему удобно искать сессии, в которых что-то сломалось, и уже потом запрашивать их детально.","parameters":[{"name":"date","in":"query","required":false,"description":"Сессии, начавшиеся в указанные сутки (UTC). Короткая замена пары from/to: если передан, перекрывает их.","schema":{"type":"string"}},{"name":"from","in":"query","required":false,"description":"Начало периода по времени старта сессии, включительно.","schema":{"type":"string"}},{"name":"to","in":"query","required":false,"description":"Конец периода по времени старта сессии, не включая границу.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Сколько сессий вернуть. По умолчанию 50.","schema":{"type":"integer"}},{"name":"offset","in":"query","required":false,"description":"Сколько сессий пропустить — постраничный обход. По умолчанию 0.","schema":{"type":"integer"}}],"responses":{"200":{"description":"Список сессий","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"sessions":{"type":"array","items":{"$ref":"#/components/schemas/Session"}}}}}}},"401":{"description":"Неверный или отсутствующий ключ API"}}}},"/api/v1/sessions/{id}":{"get":{"operationId":"getSession","summary":"Полная лента сессии: ошибки со стектрейсом, запросы с телом и заголовками, шаги пользователя.","description":"Возвращает одну сессию и все её события по порядку: переходы, клики, ввод, ошибки JavaScript со стектрейсом, упавшие и медленные сетевые запросы с кодом, временем и телом. Это и есть материал для разбора сбоя — по нему видно, что пользователь делал и что именно сломалось. Отдельно приходит признак наличия записи экрана.","parameters":[{"name":"id","in":"path","required":true,"description":"Идентификатор сессии","schema":{"type":"string"}}],"responses":{"200":{"description":"Сессия и её события"},"401":{"description":"Неверный или отсутствующий ключ API"},"404":{"description":"Сессия не найдена"}}}}}}