事件订阅功能可实现飞连内多种事件的实时监测与信息推送,与企业其他系统关联后可实现业务的自动化处理。
飞连的事件订阅功能提供了部门新建、新员工入职以及角色新建等各类事件。企业通过订阅事件,可以将飞连内的数据变化通知到企业业务系统,在多系统之间实现业务自动化处理、实时同步业务变化。例如:
如需使用事件订阅功能,您需要先在飞连管理后台添加事件订阅,配置需要订阅的事件和接收事件的服务器地址。成功添加事件订阅后,触发事件时飞连系统会向目标服务器发送 HTTP 请求,请求内包含事件数据。
具体操作介绍请参见:
飞连使用无序事件的形式推送事件,该形式的特点:
订阅的事件发生时,飞连会通过 HTTP POST 请求发送 JSON 格式的事件数据到目标服务器。目标服务器接收到包含事件数据的请求后,需要在 3 秒内以 HTTP 200 状态码响应该请求,否则飞连系统认为本次推送失败,并以 15 秒、5 分钟、1 小时、6 小时的间隔重新推送事件,最多重试 4 次。
综上,事件重推的最长时间窗口约为 7.1 小时,在该时间段内恢复网络通信,系统不会实时重推,而是需要等到下次重推时间才会再次推送事件。
事件通用结构体如下表,不同事件的结构体包含的参数不同,具体请参考各个事件文档说明,例如部门新建。
参数 | 类型 | 描述 |
---|---|---|
schema | string | 事件消息格式版本。当前固定为 1.0。 |
header | object | 消息头,包含事件的基础信息。 |
└ event_id | string | 事件 ID,每个消息的事件 ID 唯一。 |
└ token | string | 验证 token,取值与飞连事件订阅的加密策略内设置的 Verification Token 一致,通过验证该值可以确保消息来自飞连。 |
└ create_time | string | 事件发送时间,Unix 时间戳(单位毫秒)。 |
└ event_type | string | 事件类型,不同事件的事件类型不同且唯一。 |
└ app_id | string | 事件回调配置 ID。 |
data | object | 事件数据。 |
└ events | object[] | 事件详细数据列表。 |