常见问题解答(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,多次回调失败)
1
2
—— 您可能还会喜欢 ——
立即开始
无论是员工调查、客户调查、产品调查、客户旅程还是经典调查,我们都能为您提供全面的服务。立即开始,免费创建您的第一份问卷。
免费注册
永久免费 · 无需信用卡 · 问卷、题目和答卷数量无限制
