# 三方审批实例校验

校验三方审批实例数据,用于判断服务端数据是否为最新的。用户提交实例最新更新时间,如果服务端不存在该实例,或者服务端实例更新时间不是最新的,则返回对应实例 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

# 响应

# 响应体

名称 类型 描述
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
最后更新于 : 8/21/2023, 4:57:10 PM