Skip to content

订阅审批事件 ​

Error: 为了更好地提升接口文档的的易理解性,我们对文档进行了升级,请尽快迁移至新版本>>

应用订阅 approval_code 后,该应用就可以收到该审批定义对应实例的事件通知。同一应用只需要订阅一次,无需重复订阅。

当应用不希望再收到审批事件时,可以使用取消订阅接口进行取消,取消后将不再给应用推送消息。

订阅和取消订阅都是应用维度的,多个应用可以同时订阅同一个 approval_code,每个应用都能收到审批事件。

请求 ​

项目值
HTTP URLhttps://www.feishu.cn/approval/openapi/v2/subscription/subscribe
HTTP MethodPOST

请求头 ​

名称类型必填描述
Authorizationstring是tenant_access_token 值格式:"Bearer access_token" 示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token
Content-Typestring是固定值:"application/json; charset=utf-8"

请求体 ​

名称类型必须说明
approval_codestring是审批定义唯一标识

请求体示例 ​

json
{
	"approval_code":"7C468A54-8745-2245-9675-08B7C63E7A85"
}

响应 ​

响应体 ​

参数类型必须说明
codeint是错误码,非0表示失败
msgstring是返回码的描述

响应体示例 ​

json
{
    "code":0,
    "msg":"success"
}

内容来源:飞书开放平台 · 自动爬取整理