常见问题解答(FAQs)

获取有关我们服务和政策的快速解答。如需更多帮助,请联系我们的支持团队。

webhook的订阅模式有哪些类型?每种模式的具体配置要求和业务规则是什么?

业务问题:需要支持多种订阅模式以满足不同用户的需求 1. 支持三种订阅模式: - 全局订阅:订阅所有相关资源的事件,主账号订阅后子账号都默认自动订阅成功 - 按用户订阅:需要填写具体的object_ids即用户id - 按问卷订阅:需要填写具体的object_ids即问卷id 2. 配置规则: - 除全局订阅外,其他订阅模式都必须填写对应的object_ids - 按用户订阅创建问卷事件时不需要填写object_ids - 按问卷订阅时不能填写创建问卷事件

webhook支持哪些事件类型?每种事件的具体范围和触发条件是什么?

业务问题:需要明确支持的事件类型及其具体范围 1. 支持7种事件类型: - 创建问卷 - 修改问卷(仅题目修改,不包括问卷设置修改) - 删除问卷 - 答卷已完成 - 答卷已更新 - 答卷已删除 - 答卷无效(返回无效原因)

webhook回调接口的authorization配置有什么要求?

业务问题:需要控制authorization字段的长度以确保安全性 业务规则: - authorization字段长度限制为0-512个字符

webhook回调失败后的重试机制是怎样的?

业务问题:需要确保webhook回调的可靠性 业务规则: 1. 最多重试5次 2. 重试间隔时间: - 第1次:10秒 - 第2次:1分钟 - 第3次:5分钟 - 第4次:30分钟(发送推送失败的提醒邮件) - 第5次:1天(发送推送禁用的提醒邮件)

当webhook第5次回调失败后会发生什么?

业务问题:需要处理连续失败的情况并通知用户 业务规则: 1. 系统自动将相同URL的所有webhook设置为禁用状态 2. 发送邮件通知用户(邮件将发送给主账号) 3. 将失败记录以webhook id为key保存到单独队列(保存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. Event Time返回毫秒级时间戳 2. 推送参数包含资源访问URL

webhook的状态类型有哪些?每种状态的具体含义是什么?

业务问题:需要明确webhook的状态类型及其影响 业务规则: webhook状态分为四种: 1. 历史数据(status=0) 2. 可用的(status=1) 3. 不可用的(status=2,不推送) 4. 系统禁用(status=3,多次回调失败)