术语

API 限流与错误码

生产系统必须正确处理鉴权失败与限流,否则会在行情剧烈波动时最先崩溃。

常见状态码

401 密钥无效或缺失;403 无市场权限;429 超出配额,应读取 Retry-After 并指数退避。

限流策略

按套餐每日/每分钟配额计费。批量拉取历史时控制并发,WebSocket 按订阅标的数规划连接。

排查建议

记录 request_id、端点与响应头;控制台可查看用量与请求日志,便于定位异常峰值。

客户端策略

对 429 做指数退避;对 401/403 停止盲重试并告警;日志保留 X-Request-Id 与端点。

文档

完整错误专题见 /docs/errors;鉴权见 /docs/auth。