錯誤碼

WebSocket 交易推送涉及通道錯誤碼，由 WebSocket 通道層返回，發生在鑑權或底層請求處理階段。碼值為 4xxx / 5xxx 的整數。

通道錯誤碼

通道錯誤發生在請求到達業務邏輯之前，由 WebSocket 網關或鑑權服務返回。

json

{
  "id": "req-001",
  "code": 4002,
  "msg": "auth_failed"
}

code	含義	常見原因	處理建議
`4000`	請求格式錯誤	發送的幀結構不符合協議，如 JSON 格式有誤、`action` 字段為空。	檢查請求幀格式，修復後重新發送。
`4001`	尚未完成鑑權	在鑑權成功之前發送了業務請求。	先完成 Auth 鑑權，收到 `session_id` 後再發送業務請求。
`4002`	鑑權失敗	`credential_id` 不存在、簽名驗證不通過、Bearer Token 已過期或無效。	檢查憑證和簽名邏輯；OAuth2 場景需先刷新 Token 再重新建立連接。
`4003`	權限不足	當前憑證的授權範圍（scope）不包含所請求的接口權限。	確認所用憑證是否已授權該接口；如使用 OAuth2，檢查授權時申請的 scope。
`4004`	接口不存在	`action` 填寫有誤，或請求了服務端未開放的接口。	核對接口文檔，確認 `action` 名稱拼寫正確。
`5000`	服務內部錯誤	服務端處理請求時發生意外異常。	可聯繫服務端排查；不建議自動重試。
`5002`	網關錯誤	服務端網絡異常，請求未能送達後端。	稍後重試；持續出現請檢查網絡環境或聯繫服務端。
`5003`	服務暫時不可用	服務端負載過高，暫時無法處理新請求。	等待片刻後重試，建議加退避策略。
`5004`	請求超時	服務端處理超時，未能在規定時間內返回結果。	稍後重試；持續超時請聯繫服務端排查。