Документация публичного API

Публичное HTTP-API отдаёт то же, что вы видите в панели: сессии посетителей сайта и все их события — ошибки JavaScript со стектрейсом, упавшие и медленные запросы с телом и заголовками, переходы, клики и обращения из формы «Сообщить об ошибке». Методы только на чтение, ответ всегда JSON.

Авторизация

Каждый проект имеет свой ключ — он выпускается автоматически и лежит в панели на вкладке «API». Ключ передаётся заголовком, любым из двух способов:

Authorization: Bearer $LOGSY_API_KEY
# или
X-Api-Key: $LOGSY_API_KEY

Ключ открывает доступ ко всем логам сайта, поэтому запросы делаются с сервера или из локального окружения — в браузер его отдавать нельзя. Базовый адрес:

https://logsy.ru/api/v1

Методы

GET/api/v1/sessions

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

Пользовательские сессии сайта со счётчиками ошибок и медленных запросов.

GET/api/v1/sessions/{id}

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

Полная лента сессии: ошибки со стектрейсом, запросы с телом и заголовками, шаги пользователя.

Для ИИ-агентов и генераторов клиентов

Спецификация и карта сервиса открыты — агенту достаточно дать ссылку и ключ проекта, обвязку писать не нужно.

/api/v1/openapi.json — OpenAPI 3.1
/llms.txt — краткая карта сервиса для языковых моделей
Как подключить Logsy к Claude Code и Cursor

Лимиты и хранение

Данные доступны в пределах срока хранения логов по тарифу проекта — всё, что старше, удаляется и через API не вернётся.
Список сессий отдаёт до 200 записей за запрос, дальше — через offset.
Чанки записи экрана через API не отдаются: приходит только признак наличия записи и их количество.

Нужен ключ

Заведите сайт в Logsy — ключ появится на вкладке «API» вместе с одной строкой скрипта для подключения логирования.

Подключить сайт