Открыть оглавление

Аутентификация

Рукопожатие аутентифицируется API-ключом, созданным в панели; ключ показывается один раз при создании. Сам WebSocket аутентифицируется краткоживущим токеном из ответа рукопожатия, но не ключом.

http
Authorization: Bearer lk_live_xxxxxxxx
Учётные данныеВидДля чего
lk_live_…API-ключЗаголовок Bearer на POST /v1/realtime/connect. Создаётся в панели и показывается один раз.
tokenКраткоживущийВозвращает connect. Открывает ровно один WebSocket и после этого тратится. Не отправляйте API-ключ по сокету.
js
// Ключ открывает поток. Токен открывает сокет.const { token } = await connect();
new WebSocket(wsUrl, ['lecsync.realtime.v1', token]);

Отзыв ключа действует немедленно, в том числе для уже запущенных потоков.

expiresAt — это крайний срок установления соединения, а не ограничение на его длительность. Поток заканчивается через 4 часа или после 60 секунд без аудио. session.ping этот таймер не сбрасывает.

Срок действия ключа и Playground

При создании укажите имя и срок: 1, 7, 30, 180, 365 дней или без ограничений. Существующие ключи бессрочны. По истечении срока новые подключения и неиспользованные билеты отклоняются, активные потоки завершаются; принятый звук оплачивается как обычно. Срок ключа отличается от expiresAt временного билета connect. Playground списывает средства только из отдельного кошелька API текущего аккаунта без ключа. Скопированные примеры публичного API требуют ваш LECSYNC_API_KEY.