私人測試版。 新組織預設已啟用。組織管理員仍須在 Brightalk 設定中建立具權限範圍的 API 金鑰,請求才能通過驗證。可用範圍與限制以本文件和 OpenAPI 契約為準。
Idempotency-Key,並將它與同一個邏輯請求一併保存。
必要操作
只有以下四個操作強制要求此標頭:
省略標頭會傳回
400 idempotency_key_required。
選用操作
狀態機控制可選用此標頭;加入標頭後,即可重播已完成的結果:適用範圍與保留期間
冪等性宣告會保留 24 小時,其適用範圍由組織、API 金鑰類別、API 版本、HTTP 方法與正規化路徑共同決定。從一把bt_live_ 金鑰輪替到另一把金鑰,不會重設相同金鑰類別的宣告;輪替後重試同一邏輯請求時,請沿用原本的冪等性金鑰。
每個邏輯動作都應使用不重複且不透明的值。此金鑰不是驗證金鑰,不得包含電話號碼、聯絡人資料或其他敏感資訊。
結果重播與衝突行為
請等待
Retry-After 指定的時間後,再重試處理中的請求。驗證失敗不會儲存成已完成的冪等結果。