# 获取单个审批实例详情
通过接口查询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
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