Webhook说明

编写人：刘洋

订阅方：总部前台显示屏

系统：行政协同平台

日期：0000-00-00

状态：预发已通，生产未开

一、说明目的

访客被前台核销为已到达时，行政协同平台向总部前台显示屏推送一条事件，屏上弹出姓名和接待人。员工网页不依赖这条推送。目前只定义一种事件 visitor.arrived。预发已对 3 楼前台样机投递成功 8 次。生产开关关闭，要等显示屏账号和地址由周敏装完 12 间里的前台这一台后再开。

二、事件内容

手机号和证件号不放进事件。显示屏只用来认人，联系方式仍在前台网页。eventId 在重试时保持不变，屏上按它去重。

三、投递规则

1. 地址由周敏配置为前台屏的内网 URL，保存后 30 秒生效。
2. 请求在 3 秒内需要收到对方的成功码。超时或失败按回调重试的间隔再送。
3. 签名放在请求头，算法和密钥别名由陈静保管，屏上只存别名对应的材料，文档里不写密钥明文。
4. 同一 eventId 屏上只展示一次。9月19日预发重试了 2 次的那条，屏上仍只弹了 1 次。

四、预发结果

9月19日 10:00 至 11:00，周敏核销 8 位培训访客。8 条事件都在 2 秒内到达样机，姓名和接待人与访客单一致。其中 1 条因样机重启失败了第一次，40 秒后重试成功。生产开关的当前值是关闭。张伟要求样机再稳定 5 个工作日，才把地址改到生产前台屏。这 5 天从 9月20日算起，每日至少核销 3 位访客。若有一次 eventId 在屏上出现两次，开关继续保持关闭，刘洋先查去重。周敏已把样机地址写在预发配置，生产配置栏仍是空的。样机这 8 次的 eventId 从 EV-0000-018 到 EV-0000-025，屏上弹窗次数也是 8，去重后没有多出一条。