客户端处理建议
1
设置超时
为连接和响应设置合理超时，避免请求长期占用线程或连接池。
2
限制重试次数
只对适合重试的失败执行有限次数重试，避免无限循环。
3
使用指数退避
每次重试前逐步增加等待时间，降低恢复阶段的瞬时请求压力。
4
控制并发
批量任务和高并发场景应根据业务 API 的处理特性限制并发度。
建议的重试边界
以下策略可作为客户端实现起点：首次失败后等待约 1 秒，后续等待时间逐步增加，并加入随机抖动，避免大量客户端同时再次请求。重试次数和总等待时间应由调用方结合业务时效性确定。
需要记录的信息
遇到限流或平台异常时，记录请求时间、HTTP 状态、业务code、apiCode 和 requestId。日志中不要记录完整 API Key。
查看错误码
区分参数错误、认证失败、权限不足、限流和平台异常。
了解请求追踪
使用
requestId 关联业务日志与平台调用。