审批节点信息
接口说明: 获取审批节点的信息。接口数据中包含当前审批的节点状态，节点类型，审批人列表以及抄送人列表等信息。
特殊说明:只能获取已办和当前待办的审批节点信息。无法获取到未激活的审批节点的审批人信息。
请求方式:POST（HTTPS）
请求地址:https://api.xinrenxinshi.com/v5/workflow/node/list
请求Header:
| key | value |
|---|---|
| access_token | 获取的access_token的实际值 |
Query参数:
| key | value |
|---|---|
| sign | 签名值 |
Body参数:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| sid | Long | Y | 审批id |
| timestamp | Long | Y | 请求时间戳（精确到毫秒） |
返回结果:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| errcode | Integer | Y | 0成功，其他失败 |
| errmsg | String | Y | 操作结果描述 |
| data | ProcessStepAndCopyInfo | N | 处理成功时的数据结果 |
ProcessStepAndCopyInfo
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| ProcessBasicInfo | ProcessBasicInfo | Y | 审批基础数据，详见:审批列表接口 |
| stepNodeInfos | List<StepNodeInfo> | Y | 节点数据列表。列表顺序为节点顺序 |
StepNodeInfo
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| sid | Long | Y | 审批id |
| nodeId | String | Y | 节点id |
| stepType | Integer | Y | 审批人类型，0:员工 1:管理员 3:系统 |
| operatorType | Integer | N | 操作人类型，0:员工 1:管理员 3:系统 |
| status | Integer | Y | 节点状态 0:审批中 1:通过 2:驳回 3:转发 4:离职删除 5:跳过 6:撤销 8: 等待 9 :废弃 10:审批人不存在 12:退回 13:加签 14:重新提交 15:抄送 |
| nodeType | Integer | Y | 节点类型，0审批节点，1开始节点，2结束节点 |
| group | boolean | Y | 审批节点类型，false:单个审批，true:审批组 |
| groupType | Integer | N | 审批组类型，1、会签（节点需所有审批人同意）；2、或签（节点只需一个审批人同意） |
| addtime | Integer | Y | 节点创建时间戳（精确到秒） |
| approveInfos | List<StepApproveInfo> | N | 审批人列表 |
| copyInfos | List<StepCopyInfo> | N | 抄送人列表 |
StepApproveInfo
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| sid | Long | Y | 审批id |
| nodeId | String | Y | 节点id |
| approverId | String | Y | 审批人id |
| approveStatus | Integer | Y | 审批人操作状态，0开始 1 通过 2驳回 3转发 4删除 8 审批未激活时的状态 特殊说明:审批人状态4表示删除，如下场景的审批人会有这个状态。 1、或签审批组，其中一个审批人审批通过，其他审批人状态就是4。 2、会签审批组，其中一个审批人驳回审批了，其他审批人状态就是4 3、有审批人的节点，如果是管理员处理了审批，审批人状态就是4 |
| remark | String | N | 审批备注 |
| modtime | Integer | Y | 审批操作时间戳（精确到秒） |
StepCopyInfo
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| sid | Long | Y | 审批id |
| nodeId | String | Y | 节点id |
| notifierId | String | Y | 抄送人id |
| isRead | Integer | Y | 状态 0:未读 1:已读 |
| modtime | Integer | N | 操作时间 |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/workflow/node/list?sign=yAirpr8IVGaTIqloMgwR9PO3yXc%3D
请求Body示例:
{
"sid": 597874017516650500,
"timestamp": 1606299114610
}
SDK请求示例(java):
ApprovalNodeInfoRequest request = new ApprovalNodeInfoRequest(access_token);
request.setSid(597874017516650496L);
OpenapiResponse<ProcessStepAndCopyInfo> nodeInfo = XrxsApprovalService.getNodeInfo(request);
响应示例:
{
"errcode": 0,
"errmsg": "成功",
"data": {
"processBasicInfo": {
"sid": 597874017516650500,
"ownerId": "b1139f3def6b462a8f45116b8bbb8338",
"ownerName": "11111",
"sponsorId":"f0a5d7aaeddd40b08006be8ae229f7a7",
"sponsorType":1,
"sponsorName": "小薪",
"sponsorMobile": "19400009090",
"departmentId": null,
"departmentName": "",
"flowTypeId": 2,
"flowTypeName": "调岗",
"remark": null,
"status": 0,
"confirmDate": null,
"addtime": 1606217873,
"modtime": 1606217873,
"lastStepModtime": 1606217873,
"flowNumber": "202011241937000001",
"setting":{
"remarkRequired":0
}
},
"stepNodeInfos": [
{
"sid": 597874017516650500,
"nodeId": "f0a5d7aaeddd40b08006be8ae229f7a7",
"operatorType": null,
"stepType": null,
"status": 8,
"nodeType": 1,
"group": false,
"groupType": null,
"addtime": null,
"approveInfos": [],
"copyInfos": []
},
{
"sid": 597874017516650500,
"nodeId": "13a3ff29da594c979c40446b6d51074e",
"operatorType": null,
"stepType": null,
"status": 0,
"nodeType": 0,
"group": false,
"groupType": 1,
"addtime": 1606217873,
"approveInfos": [
{
"sid": 597874017516650500,
"nodeId": "13a3ff29da594c979c40446b6d51074e",
"approverId": "784e852a38fd44a0bfff96af7d804a43",
"approveStatus": 0,
"remark": null,
"addtime": 1606217873,
"modtime": 1606217873
}
],
"copyInfos": []
},
{
"sid": 597874017516650500,
"nodeId": "cbebe0c9f54d4184af0c5cc87e5e13ca",
"operatorType": null,
"stepType": null,
"status": 8,
"nodeType": 2,
"group": false,
"groupType": null,
"addtime": null,
"approveInfos": [],
"copyInfos": []
}
]
}
}