術語

API 限流與錯誤碼

生產系統必須正確處理鑑權失敗與限流,否則會在行情劇烈波動時最先崩潰。

常見狀態碼

401 密鑰無效或缺失;403 無市場權限;429 超出配額,應讀取 Retry-After 並指數退避。

限流策略

按套餐每日/每分鐘配額計費。批量拉取歷史時控制併發,WebSocket 按訂閱標的數規劃連接。

排查建議

記錄 request_id、端點與響應頭;控制檯可查看用量與請求日誌,便於定位異常峰值。

客戶端策略

對 429 做指數退避;對 401/403 停止盲重試並告警;日誌保留 X-Request-Id 與端點。

文檔

完整錯誤專題見 /docs/errors;鑑權見 /docs/auth。