認證
握手用主控台建立的 API Key 認證,Key 只在建立時顯示一次。WebSocket 本身用握手回傳的短期 token 認證,永遠不用 Key。
| 憑證 | 種類 | 用途 |
|---|---|---|
lk_live_… | API Key | 作為 Bearer 標頭發給 POST /v1/realtime/connect。在主控台建立,只顯示一次。 |
token | 短期 | connect 回傳。只能開啟一條 WebSocket,用過即失效。不要把 API Key 放到 socket 上。 |
撤銷 Key 立即生效,包括正在執行中的串流。
expiresAt 約束的是建立連線的截止時間,不是連線能存活多久。一條串流最長 4 小時;連續 60 秒沒有音訊就會結束。session.ping 不會重置這 60 秒。
金鑰有效期限與 Playground
建立金鑰時可填寫名稱,選擇1天、7天、30天、180天、365天或不限制。舊金鑰保持永久有效。金鑰到期後拒絕新連線及未使用票證,並結束線上串流;已接收音訊正常結算。金鑰期限與 connect 回應的短期票證 expiresAt 不同。Playground 使用登入帳號直接扣除餘額,無需填寫 Key;複製的公開 API 範例仍需設定自己的 LECSYNC_API_KEY。