# 获取单个审批实例详情

通过接口查询Boss Hi审批系统中符合条件的审批(不支持查询第三方审批)。

# 请求

基本
HTTP URL https://hi-gw.weizhipin.com/open-apis/approval/v2/instances/:instance_id
HTTP Method GET
支持的应用类型 自建应用
权限要求 查询审批列表

# 请求头

名称 类型 必填 描述
Authorization string tenant_access_token
值格式:"Bearer access_token"
示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560"

# 路径参数(url中冒号标识的参数,如":xxxx"请连同:整体替换成对应值)

名称 类型 描述
instance_id string 审批实例Id

# 查询参数

名称 类型 必填 描述
approval_code string 审批定义Code
status String 审批实例状态
示例值:"PENDING"
可选值有
* PENDING:审批中
* APPROVED:审批流程结束,结果为同意
* REJECTED:审批流程结束,结果为拒绝
* CANCELED:审批发起人撤回
user_id_type String 用户 ID 类型示例值:"open_id"
可选值有:
open_id:用户的 open id
union_id:用户的 union id
user_id:用户的 user id
默认值:open_id
当值为 user_id,字段权限要求:
获取用户 user ID

# 响应

# 响应体

名称 类型 描述
code int 错误码,非 0 表示失败
msg string 错误描述
data - -
 ∟instance_id string 审批实例id
 ∟user_id string 审批发起人userId。
 ∟start_time string 审批发起时间。
示例值:"2022-01-01 00:00:00"
 ∟end_time string 审批结束时间
示例值:"2022-01-01 00:00:00"
 ∟status string 审批实例状态
示例值:"PENDING"
可选值有
* PENDING:审批中
* APPROVED:审批流程结束,结果为同意
* REJECTED:审批流程结束,结果为拒绝
* CANCELED:审批发起人撤回
* DELETED:审批被删除
 ∟form string 审批表单内容
 ∟comment_list Instance_comment[] 评论列表
   ∟user_id string 评论用户编号
   ∟user_name string 用户名称
   ∟comment string 评论内容
   ∟create_time string 评论时间
示例值:"2022-01-01 00:00:00"
 ∟tasks task[] 审批进度
   ∟user_id string 操作人编号
   ∟user_name string 操作人名称
   ∟status string
可选值有
* LAUNCH: 发起
* PENDING:待审批
* APPROVED:任务同意
* REJECTED: 任务拒绝
   ∟start_time string 任务开始时间
示例值:"2022-01-01 00:00:00"
   ∟end_time string 任务结束时间
示例值:"2022-01-01 00:00:00"
   ∟reason string 通过/拒绝时填写的备注信息

# 响应体示例

{
  "code": 0,
  "traceId": "_Ao59UOIBLPCeAAu",
  "success": true,
  "data": {
    "instance_id": "202208231000000000",
    "user_id": "10001",
    "start_time": "2022-08-23 19:37:34",
    "end_time": "2022-08-26 13:45:50",
    "status": "APPROVED",
    "form": "[{\"dataCode\":\"1001\",\"code\":\"field_1001_1661222207252\",\"name\":\"审批原因\",\"value\":\"收拾收拾\"},{\"dataCode\":\"1002\",\"code\":\"field_1002_1661222249103\",\"name\":\"具体原因\",\"value\":\"撒不撒\"},{\"dataCode\":\"2001\",\"code\":\"field_2001_1661222277703\",\"name\":\"数字输入框\",\"value\":\"2\"},{\"dataCode\":\"3001\",\"code\":\"field_3001_1661222302619\",\"name\":\"单选框\",\"value\":\"2\"}]",
    "comment_list": [
      {
        "user_id": "10002",
        "user_name": "xxx",
        "comment": "今天晚上8点",
        "create_time": "2022-08-23 19:38"
      },
      {
        "user_id": "10003",
        "user_name": "xxxx",
        "comment": " ​@xxxx⁠ 小说看看看",
        "create_time": "2022-08-23 19:38"
      }
    ],
    "tasks": [{
        "userId": "10004",
        "userName": "XXX",
        "status": "PENDING",
        "startTime": "2022-09-27 21:35:24",
        "endTime": "2022-09-27 21:36:52",
        "reason": "咔咔咔咔打"
      }]
  },
  "msg": "操作成功"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
最后更新于 : 3/4/2024, 3:29:16 PM