开发者文档

错误码与限流

稳定的行情管道需要正确处理鉴权、权限与配额错误,避免在波动行情时雪崩重试。

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 重连指南可配套阅读。