调用 API 返回 429 表示触发限流,返回 503 表示 API 服务临时关闭维护。两者含义与处理方式不同,需区别对待。
返回 429 限流
大鹏云 API 限流策略为:单个密钥与单个 IP 各 10 次/秒,任一维度超限即返回 429。
处理方式
- 统计程序的请求频率,确认是否多线程/多进程并发导致超限。
- 加入限速与退避重试机制,收到 429 后等待再重试:
# 伪代码示例
if status == 429:
sleep(1 + random(0, 1))
retry()
- 批量操作尽量合并请求,使用批量接口而非循环单条调用。
- 缓存不常变化的查询结果,减少重复请求。
返回 503 服务关闭
- API 服务正在维护或临时关闭,通常伴随公告;
- 稍后重试即可,建议实现指数退避重试,不要高频重试造成叠加压力;
- 持续长时间 503 且无公告时,再提交工单核实。
提示:正常业务应把请求速率控制在限制以内,频繁触发限流说明客户端实现需要优化。
仍未解决
请通过「支持服务 → 工单」反馈,附上:返回状态码与完整响应体、请求频率说明、发生时间段、使用的 AccessKey(可部分隐去),客服将核查限流与服务状态记录。