Frequently Asked Questions (FAQs)

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

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

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

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

业务问题：需要处理连续失败的情况并通知用户 业务规则： 1. 系统自动将相同URL的所有webhook设置为禁用状态 2. 发送邮件通知用户（邮件将发送给主账号） 3. 将失败记录以webhook id为key保存到单独队列（保存7天） 4. 允许用户在7天内进行数据补推

业务问题：需要处理webhook禁用期间的事件 1. 禁用后7天内的事件记录到单独队列 2. 禁用次数超过1次需要联系技术支持 3. 恢复可用后主动推送队列数据

业务问题：需要记录webhook的调用日志以便追踪问题 业务规则： - 回调需要添加JSON格式的阿里云日志记录

业务问题：需要防止重复配置webhook 业务规则： 1. 以下字段组合必须唯一： - subscription_model（订阅模式） - event_type（事件类型） - object_ids（对象ID） - url_subscription（订阅URL） 2. 例外：不同事件使用相同的url_subscription时不受限制

业务问题：需要统一时间格式并提供资源访问链接 业务规则： 1. Event Time返回毫秒级时间戳 2. 推送参数包含资源访问URL

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