Heartbeat клиентской сессии

Heartbeat обновляет время последней активности и длительность клиентской сессии. Запись сессии создаётся при входе, отдельный запрос для её начала не нужен.

Вернуться к схеме интеграции.

Обновление активности клиентской сессии

Метод: POST
URL: https://api.gigma.ru/api/counterparty/session/heartbeat
Авторизация: App Token + Bearer token
Headers: Token: {application_token}; Authorization: Bearer {counterparty_token}
Успешный ответ: 200

Запрос

Тело запроса не требуется.

POST /api/counterparty/session/heartbeat HTTP/1.1
Host: api.gigma.ru
Token: <application_token>
Authorization: Bearer <counterparty_token>
Accept: application/json

Ответ

{
    "session": {
        "id": 154,
        "status": "active",
        "started_at": "2026-07-30T03:00:00+00:00",
        "last_seen_at": "2026-07-30T03:02:00+00:00",
        "duration_seconds": 120
    },
    "server_time": "2026-07-30T03:02:00+00:00",
    "next_heartbeat_in_seconds": 60
}

Поля ответа

session.id — идентификатор сессии.
session.status — состояние сессии; успешный heartbeat возвращает active.
session.started_at — время начала сессии в ISO 8601.
session.last_seen_at — время последней активности в ISO 8601.
session.duration_seconds — активное время в секундах.
server_time — время сервера в ISO 8601.
next_heartbeat_in_seconds — рекомендуемая задержка до следующего запроса.

Отправляйте heartbeat через интервал из next_heartbeat_in_seconds, но не чаще шести раз в минуту для одного Bearer.

За один интервал учитывается не больше 180 секунд. После перерыва в 300 секунд Gigma закрывает прежнюю сессию и начинает новую.

Ошибки