开发者
速率限制与安全重试
速率限制与安全重试
接口可能按路由、账号或资源限流。以实际返回的状态和响应头为准,不要把文档示例里的固定数字当成所有接口的承诺。可用时读取 X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset 和 Retry-After。
收到 429 后暂停,按有效的 Retry-After 等待;否则采用有上限的指数退避并加入少量随机抖动。限制重试次数,设置超时,最后把失败明确报告给调用方。
只读请求可在合适条件下重试。备份、发命令、电源和删除等操作不能因超时就盲目重复;先核对操作是否已生效。缓存非实时数据、降低轮询频率,不要依赖未提供的 Webhook 功能来替代轮询。