錯誤碼
HTTP 錯誤回傳帶 code 欄位的 JSON。只重試標記為 retryable 的。
HTTP 錯誤
| 錯誤碼 | HTTP | 含義 |
|---|---|---|
UNAUTHORIZED | 401 | API Key 缺失、格式不對,或已撤銷。 |
INVALID_INPUT | 400 | 請求內容格式不對。 |
INSUFFICIENT_BALANCE | 402 | 餘額不夠,開不了新串流。 |
CONCURRENCY_LIMIT | 429 | 達到帳號總並發(所有 Key 共用)、全域上限,或某個區域池的份額。沒有按 Key 單獨限額。 |
NOT_FOUND | 404 | 這個使用者下沒有這條錄音或串流。 |
ADMISSION_DISABLED | 503 | 這個部署關掉了 API 准入。 |
REGION_UNAVAILABLE | 503 | 請求的區域沒有健康節點。未指定 region 時,表示所有區都不可用。 |
WebSocket 關閉碼
所有可重試的關閉碼對應同一個動作:重新呼叫 connect,開一條新流。不存在保留原流的續連路徑。
| 關閉碼 | 含義 | 怎麼處理 |
|---|---|---|
4001 | Token 無效或已過期 | 重新呼叫 connect,換一張新 token。 |
4003 | sessionId 對不上 | 不要重試。先改用戶端。 |
4004 | 這場不在這台節點上 | 重新呼叫 connect,換一個新位址。 |
4010 | 餘額用完 | 先儲值,再重新呼叫 connect。 |
4011 | 並發已滿 | 等一下再重新呼叫 connect。 |
1003 | 協定錯誤 | 不要重試。先改用戶端。 |
1012 | 閘道正在重新啟動 | 重新呼叫 connect,換一個新位址。 |
4012 | 達到最長時長(4 小時) | 重新呼叫 connect,開一條新串流。 |
4013 | 閒置逾時:連續 60 秒沒有音訊。Ping 不會重置它。 | 繼續送音訊,或重新呼叫 connect。 |
4014 | 計費沒有確認 | 等帳號可以扣費後,再重新呼叫 connect。 |
4015 | API Key 已撤銷 | 新建一把 Key,再重新呼叫 connect。 |
4016 | 用戶端讀得太慢 | 重新呼叫 connect,開一條新串流。 |
每條會話結束時,按有效音訊時長向上取整到整分鐘;斷線重開分別計費,沒有有效音訊不收費。