功能介绍

为什么要监听审批事件

开发者通过审批开放接口创建审批实例后，在一个审批单的生命周期中，有很多信息可能是需要关注的，开发者可以通过回调的方式，监听审批单的状态变化信息。

避免了不断轮询审批详情接口获取最新状态，既增加开发复杂度，又造成了不必要的接口查询消耗。

审批事件包含共用审批事件和特殊审批事件。共用审批事件包括：审批实例状态变更、审批任务状态变更、审批抄送事件。特殊事件一般是和审批做过特殊交互的应用使用，常规情况下，我们开发者不需要去关注。

事件的推送路径

开发者在「开发者后台」-「开发配置」-「事件订阅」中注册请求回调地址。

审批在审批单据（一个单据为一个审批实例）状态发生变化时，例如单据的创建或者流转、产生新的任务、抄送的时候，会向开放平台发送变化的消息。

开放平台会先将该消息存储，然后再向开发者注册的回调地址按照响应的格式推送消息。

用户服务器接口接收到该消息，可以先将消息存储，然后再进行业务逻辑处理，避免响应超时。

消息可能会重复，开发者需要根据回调请求中的 event_id 或者 uuid 做幂等，不同的事件类型幂等key不一样，请根据具体事件的结构体来确定，也可以根据自己的业务做幂等。

事件的推送周期和频次

详细信息请查看：接收并处理事件

订阅的事件发生时，飞书将会通过 HTTP POST 请求发送 JSON 格式的事件数据到预先配置的请求地址。

应用收到 HTTP POST 请求后，需要在 1 秒内以 HTTP 200 状态码响应该请求。否则飞书开放平台认为本次推送失败，并以 15s、5m、1h、6h 的间隔重新推送事件，最多重试 4 次。

从上述描述可以看出，事件重发的最长时间窗口约为 7.5 小时，请检查和处理在 7.5 小时内的重复事件。可以使用如下方式判断事件唯一性：对于 1.0 版本的事件，通过事件结构中的 uuid 字段判断事件唯一性。对于 2.0 版本的事件，通过事件结构中的 event_id 字段判断事件唯一性。下面对事件结构进行了详细介绍。

为什么要监听审批事件#

事件的推送路径#

事件的推送周期和频次#

为什么要监听审批事件

事件的推送路径

事件的推送周期和频次