# 三方审批实例校验
校验三方审批实例数据,用于判断服务端数据是否为最新的。用户提交实例最新更新时间,如果服务端不存在该实例,或者服务端实例更新时间不是最新的,则返回对应实例 id。
例如,用户可以每隔5分钟,将最近5分钟产生的实例使用该接口进行对比。
# 请求
基本 | |
---|---|
HTTP URL | https://hi-qa.weizhipin.com/open-apis/approval/external_instances/check |
HTTP Method | POST |
支持的应用类型 | 自建应用 商店应用 |
权限要求 | 访问审批应用 |
# 请求头
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
Authorization | string | 是 | tenant_access_token 值格式:"Bearer access_token "示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" |
Content-Type | string | 是 | 固定值:"application/json; charset=utf-8" |
# 请求体
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
instances | exteranl_instance_check[] | 是 | 校验的实例信息 |
∟instance_id | string | 是 | 审批实例 id 示例值:"1234234234242423" |
∟update_time | string | 是 | 审批实例最近更新时间 示例值:"2022-01-01 00:00:00" |
∟tasks | external_instance_task[] | 是 | 任务信息 |
∟task_id | string | 是 | 任务 id 示例值:"112253" |
∟update_time | string | 是 | 任务最近更新时间 示例值:"2022-01-01 00:00:00" |
# 请求体示例
{
"instances": [
{
"instance_id": "1234234234242423",
"update_time": "2022-01-01 00:00:00",
"tasks": [
{
"task_id": "112253",
"update_time": "2022-01-01 00:00:00"
}
]
}
]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
2
3
4
5
6
7
8
9
10
11
12
13
14
# 响应
# 响应体
名称 | 类型 | 描述 |
---|---|---|
code | int | 错误码,非 0 表示失败 |
msg | string | 错误描述 |
data | - | - |
∟instance_id | string | 审批实例 id |
∟update_time | string | 任务最近更新时间 |
∟tasks | external_instance_task[] | 任务信息 |
∟task_id | string | 任务 id |
∟update_time | string | 任务最近更新时间 |
# 响应体示例
{
"code": 0,
"traceId": "_Ao59UOIBLPCeAAu",
"success": true,
"msg": "操作成功",
"data": [
{
"instance_id": "1234234234242423",
"update_time": "2022-01-01 00:00:00",
"tasks": [
{
"task_id": "112253",
"update_time": "2022-01-01 00:00:00"
}
]
}
]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18