订阅审批事件
Error: 为了更好地提升接口文档的的易理解性,我们对文档进行了升级,请尽快迁移至新版本>>
应用订阅 approval_code 后,该应用就可以收到该审批定义对应实例的事件通知。同一应用只需要订阅一次,无需重复订阅。
当应用不希望再收到审批事件时,可以使用取消订阅接口进行取消,取消后将不再给应用推送消息。
订阅和取消订阅都是应用维度的,多个应用可以同时订阅同一个 approval_code,每个应用都能收到审批事件。
请求
| 项目 | 值 |
|---|---|
| HTTP URL | https://www.feishu.cn/approval/openapi/v2/subscription/subscribe |
| HTTP Method | POST |
请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Authorization | string | 是 | tenant_access_token 值格式:"Bearer access_token" 示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token |
| Content-Type | string | 是 | 固定值:"application/json; charset=utf-8" |
请求体
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
| approval_code | string | 是 | 审批定义唯一标识 |
请求体示例
json
{
"approval_code":"7C468A54-8745-2245-9675-08B7C63E7A85"
}响应
响应体
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| code | int | 是 | 错误码,非0表示失败 |
| msg | string | 是 | 返回码的描述 |
响应体示例
json
{
"code":0,
"msg":"success"
}