常見問題解答(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,多次回調失敗)