三方审批实例校验

Error: 为了更好地提升接口文档的的易理解性，我们对文档进行了升级，请尽快迁移至新版本>>

校验三方审批实例数据，用于判断服务端数据是否为最新的。用户提交实例最新更新时间，如果服务端不存在该实例，或者服务端实例更新时间不是最新的，则返回对应实例 id。

例如，用户可以每隔5分钟，将最近5分钟产生的实例使用该接口进行对比。

请求

项目	值
HTTP URL	https://www.feishu.cn/approval/openapi/v3/external/instance/check
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"

请求体

参数	类型	必须	说明
update_times	list	是	实例信息
∟instance_id	String	是	审批实例 id
∟update_time	int	是	审批实例最近更新时间
∟tasks	list	是	任务信息
∟task_id	String	是	任务 id
∟update_time	int	是	任务最近更新时间

请求体示例

{
    "update_times": [
        {
            "instance_id": "1234234234242423",
            "update_time": 1591603040000,
            "tasks": [
                {
                    "task_id": "112253",
                    "update_time": 1591603040000
                },
                {
                    "task_id": "112255",
                    "update_time": 1591603040000
                }
            ]
        }
    ]
}

响应

响应体

参数	类型	必须	说明
code	int	是	错误码，非0表示失败
msg	String	是	返回码的描述
data	map	是	返回业务信息
diff_times	list	否	实例信息
∟instance_id	String	是	审批实例 id
∟update_time	int	否	审批实例最近更新时间
∟tasks	list	否	任务信息
∟task_id	String	是	任务 id
∟update_time	int	否	任务最近更新时间

响应体示例

{
    "code":0,
    "msg": "success",
    "data":{
      "diff_times": [
              {
                  "instance_id": "1234234234242423",
                  "update_time": 1591603040000,
                  "tasks": [
                      {
                          "task_id": "112255",
                          "update_time": 0
                      }
                  ]
              }
          ]
      }
}