常見問題解答(FAQ)
獲取有關我們服務和政策的快速解答。如需更多幫助,請聯繫我們的支持團隊。
webhook 支援哪些訂閱模式?各模式的具體配置要求和業務規則是什麼?
業務需求:需要支援多種訂閱模式,以滿足不同使用者的需求
1. 支援三種訂閱模式:
- 全域訂閱:訂閱所有相關資源的事件。主帳號訂閱後,所有子帳號預設自動訂閱
- 按使用者訂閱:必須提供特定的 object_ids,即使用者 ID
- 按問卷訂閱:必須提供特定的 object_ids,即問卷 ID
2. 配置規則:
- 除全域訂閱外,其他所有訂閱模式都必須包含對應的 object_ids
- 按使用者訂閱時,建立問卷事件不需要 object_ids
- 按問卷訂閱時,不能包含建立問卷事件
webhook 支援哪些事件類型?每個事件的具體範圍和觸發條件是什麼?
業務問題:需要明確支援的事件類型及其具體範圍
1. 支援 7 種事件類型:
- 建立問卷
- 修改問卷(僅問題編輯,不包含問卷設定變更)
- 刪除問卷
- 回應完成
- 回應更新
- 回應刪除
- 回應無效(返回無效原因)
設定 webhook 回調介面的授權需要哪些要求?
業務問題:需要控制授權欄位的長度以確保安全性
業務規則:
- 授權欄位長度限制為 0-512 個字元
Webhook 回調失敗後的重試機制是什麼?
業務問題:需要確保 webhook 回調的可靠性
業務規則:
1. 最多重試 5 次
2. 重試間隔:
- 第 1 次重試:10 秒
- 第 2 次重試:1 分鐘
- 第 3 次重試:5 分鐘
- 第 4 次重試:30 分鐘(發送一封提醒郵件,告知推送失敗)
- 第 5 次重試:1 天(發送一封提醒郵件,告知推送已停用)
第 5 次 webhook 回調失敗後會發生什麼事?
業務問題:您需要處理連續失敗並通知使用者
業務規則:
1. 系統會自動將所有相同 URL 的 webhook 設為停用
2. 向使用者發送電子郵件通知(郵件將發送至主帳號)
3. 將失敗記錄以 webhook id 為鍵儲存到獨立佇列中(保留 7 天)
4. 允許使用者在 7 天內回補資料
Webhook 停用後,事件會如何處理?
業務問題:Webhook 停用期間需要處理事件
1. 停用後 7 天內的事件記錄會儲存在獨立佇列中
2. 如果停用次數超過 1 次,請聯絡技術支援
3. 重新啟用後,佇列中的資料將主動推送
Webhook 記錄的要求是什麼?
業務問題:需要記錄 webhook 呼叫日誌以便排查問題
業務規則:
- 回調需要以 JSON 格式包含阿里雲日誌記錄
設定 Webhook 時有哪些唯一性限制?
業務問題:必須防止重複的 Webhook 設定
業務規則:
1. 以下欄位組合必須唯一:
- subscription_model(訂閱模式)
- event_type(事件類型)
- object_ids(物件 ID)
- url_subscription(訂閱 URL)
2. 例外:對於不同事件使用相同的 url_subscription 不受限制
Webhook 通知中的時間格式和資源存取連結有什麼要求?
業務問題:需要統一的時間格式,以及資源存取連結。
業務規則:
1. 事件時間回傳毫秒級時間戳。
2. 推送參數中包含資源存取 URL。
Webhook 的狀態類型有哪些?每種狀態具體代表什麼意思?
業務問題:需要明確 webhook 的狀態類型及其影響
業務規則:
webhook 狀態分為四種類型:
1. 歷史資料(status=0)
2. 可用(status=1)
3. 不可用(status=2,不推送)
4. 系統停用(status=3,多次回調失敗)
—— 您可能還會喜歡 ——
立即開始
無論是員工調查、客戶調查、產品調查、客戶旅程還是經典調查,我們都能為您提供全面的服務。立即開始,免費建立您的第一份問卷。
免費註冊
永久免費 · 無須信用卡 · 問卷、題目和回覆數量無限制
