Skip to content

取消订阅审批事件

调用订阅审批事件接口订阅审批定义 Code 后,如果不再需要接收该审批定义下的事件订阅通知,可以调用本接口取消订阅审批定义 Code,取消后应用无法再收到该审批定义对应实例的事件通知。

请求

项目
HTTP URLhttps://open.feishu.cn/open-apis/approval/v4/approvals/:approval_code/unsubscribe
HTTP MethodPOST
接口频率限制100 次/分钟
支持的应用类型custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可approval:approval 查看、创建、更新、删除审批应用相关信息 approval:definition 查看、创建、更新、删除原生审批定义相关信息

请求头

名称类型必填描述
Authorizationstringtenant_access_token 值格式:"Bearer access_token" 示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token

路径参数

名称类型描述
approval_codestring审批定义 Code。获取方式:
- 调用创建审批定义接口后,从响应参数 approval_code 获取。 - 登录审批管理后台,在指定审批定义的 URL 中获取,具体操作参见什么是 Approval Code
示例值:"7C468A54-8745-2245-9675-08B7C63E7A85"

响应

响应体

名称类型描述
codeint错误码,非 0 表示失败
msgstring错误描述
data\--

响应体示例

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

错误码

HTTP状态码错误码描述排查建议
4001390001param is invalid参数错误。排查方案: - 根据接口文档的参数说明,检查请求时传入的参数是否正确。 - 如果传入的有表单参数(form),则需要检查该参数内传入的表单控件数据是否正确。如果报错信息内包含控件 ID(如 控件= widget17261088448220001),可以调用查看指定审批定义或者获取单个审批实例详情接口,获取响应参数 form 值,检索有问题的控件 ID,然后检查该控件的配置是否正确。
4001390002approval code not found找不到审批定义 Code,检查传入的审批定义 Code 是否正确。 审批定义 Code 获取方式: - 调用创建审批定义接口后,从响应参数 approval_code 获取。 - 登录审批管理后台,在指定审批定义的 URL 中获取,具体操作参见什么是 Approval Code
4001390007subscription existed当前审批定义已完成订阅或已取消订阅,无需重复操作。
4001395001There have been some errors. Please try again later服务出现错误。排查方案: 1. 参考接口文档的参数说明,检查请求时传入的参数是否正确。如果传入的有表单参数(form),则需要检查传入的表单控件数据是否正确。 2. 降低请求频率,并重试。如果重试仍然报错,请联系技术支持

更多错误码信息,参见通用错误码

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