审批实例撤回
Error: 为了更好地提升接口文档的的易理解性,我们对文档进行了升级,请尽快迁移至新版本>>
对于状态为“审批中”的单个审批实例进行撤销操作,撤销后审批流程结束
请求
| 项目 | 值 |
|---|---|
| HTTP URL | https://www.feishu.cn/approval/openapi/v2/instance/cancel |
| HTTP Method | POST |
| 支持的应用类型 | custom,isv |
| 权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 | approval:approval:readonly 访问审批应用 |
请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Authorization | string | 是 | tenant_access_token 值格式:"Bearer access_token" 示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token |
| Content-Type | string | 是 | 固定值:"application/json; charset=utf-8" |
请求体
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| approval_code | String | 是 | 审批定义Code |
| instance_code | String | 是 | 审批实例Code |
| user_id | String | 是 | 操作用户 |
| open_id | String | 是 | 某个应用下用户的唯一标识,根据userID、openID、TenantId获得Lark用户。 |
请求体示例
json
{
"approval_code": "7C468A54-8745-2245-9675-08B7C63E7A85",
"instance_code": "81D31358-93AF-92D6-7425-01A5D67C4E71",
"open_id": "ou_123456",
"user_id": "f7cb567e"
}响应
响应体
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| code | int | 是 | 错误码,非0表示失败 |
| msg | String | 是 | 返回码的描述 |
响应体示例
json
{
"code": 0,
"msg": "success"
}