跳轉到主要內容
私人測試版。 新組織預設已啟用。組織管理員仍須在 Brightalk 設定中建立具權限範圍的 API 金鑰,請求才能通過驗證。可用範圍與限制以本文件和 OpenAPI 契約為準。
Brightalk 會對每個組織套用速率限制,也可能對個別金鑰套用更嚴格的限制。有效限制是目前請求所適用的較低配額。

速率限制配額群組

每個操作會使用三個獨立配額群組的其中一個。目前請求以回應標頭為準。 取消及暫停操作使用 write,不是 execution。已接受的執行請求所啟動的電話工作,不會再使用另一筆 HTTP 請求配額。

讀取標頭

請使用這些值,不要假設每個組織或金鑰都採用相同配額。

處理 429 回應

配額用盡時會傳回 429 rate_limit_exceeded。請至少等待數字 Retry-After 指定的時間、加入隨機延遲,並僅在操作可安全重試時重送。重試同一個具冪等性的邏輯動作時,應保留相同的 Idempotency-Key

區分容量與 HTTP 速率限制

電話並行容量是另一種控制。容量暫時已滿時,已接受的工作會保持 queued;不會變成 429,也不會遭丟棄。請查詢 API 資源,並將排隊視為生命週期狀態,而非請求節流訊號。