開發者
速率限制與安全重試
速率限制與安全重試
介面可能按路由、賬號或資源限流。以實際返回的狀態和響應頭為準,不要把文件示例裡的固定數字當成所有介面的承諾。可用時讀取 X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset 和 Retry-After。
收到 429 後暫停,按有效的 Retry-After 等待;否則採用有上限的指數退避並加入少量隨機抖動。限制重試次數,設定超時,最後把失敗明確報告給呼叫方。
只讀請求可在合適條件下重試。備份、發命令、電源和刪除等操作不能因超時就盲目重複;先核對操作是否已生效。快取非實時資料、降低輪詢頻率,不要依賴未提供的 Webhook 功能來替代輪詢。