開發者文檔

錯誤碼與限流

穩定的行情管道需要正確處理鑑權、權限與配額錯誤,避免在波動行情時雪崩重試。

HTTP 狀態碼

401 未授權;403 無該市場/權限;404 路徑或標的不存在;429 超出配額或 RPM;5xx 應退避重試並保留 X-Request-Id。

429 與 Retry-After

收到 429 時讀取 Retry-After(若有),採用指數退避 + 抖動。批量歷史拉取控制併發與分頁,勿對同一窗口打滿。

日誌與排查

日誌記錄 request_id、端點、狀態碼與響應摘要。控制檯可查用量;生產告警應對 401/403/429 分類處理。

業務錯誤外殼

JSON 外殼含 succ/data/msg/code。HTTP 2xx 仍可能 succ=false,客戶端應同時檢查外殼與狀態碼。

相關文檔

字段表見各 /docs/api/* 頁;鑑權專題與 WebSocket 重連指南可配套閱讀。