获取审批记录
接口说明: 获取审批的审批步骤记录
请求方式:POST（HTTPS）
请求地址:https://api.xinrenxinshi.com/v5/workflow/step/details
请求Header:
| key | value |
|---|---|
| access_token | 获取的access_token的实际值 |
Query参数:
| key | value |
|---|---|
| sign | 签名值 |
Body参数:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| sid | Long | Y | 审批id |
| operatorId | String | Y | 操作人员工id |
| timestamp | Long | Y | 请求时间戳（精确到毫秒） |
返回结果:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| errcode | Integer | Y | 0成功，其他失败 |
| errmsg | String | Y | 操作结果描述 |
| data | List<FlowRecordResult> | N | 处理成功时的数据结果 |
FlowRecordResult
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| time | String | Y | 时间 |
| copyTime | String | y | 抄送人抄送时间 |
| stepType | Integer | Y | 结点类型(1-开始 2-结束 3-审批人 4-审批组) |
| stepStatus | Integer | Y | 结点状态（0-审批中 1-通过 2-驳回 3-转发 6-撤销 8-等待 10-角色空终止 11-角色人过多终止） |
| passType | Integer | Y | 0是会签，1是或签 |
| ownerName | String | Y | 发起人姓名 |
| replaceName | String | N | 代替发起人名字 |
| accountName | String | N | 管理员名字（只有管理员操作了结点才会有） |
| confirmDate | String | N | 离职确认时间（管理员） |
| approveResults | List<FlowApproveResultModel> | Y | 审批人信息 |
| copyResults | List<FlowCopyResultModel> | Y | 抄送人信息 |
| comments | List<FlowCommentModel> | Y | 审批评论 |
FlowApproveResultModel
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| approveId | String | Y | 审批人员工id |
| name | String | Y | 审批人名字 |
| status | Integer | Y | 审批状态，0-审批中 1-同意 2-驳回 3-转发 8-等待 |
| roleName | String | Y | 角色名 |
| time | String | Y | 时间 |
| position | Integer | Y | 排序 |
| remark | String | N | 备注 |
| sign | String | N | 审批通过签名 |
| agentInfo | String | N | 代理人信息 |
FlowCopyResultModel
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| copyPersonId | String | Y | 抄送人员工id |
| name | String | Y | 抄送人名字 |
| roleName | String | Y | 抄送人角色名 |
| position | Integer | Y | 排序 |
| remark | String | N | 备注 |
FlowCommentModel
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| employeeName | String | Y | 员工名字 |
| comment | String | Y | 评论内容 |
| time | String | Y | 时间 |
| position | Integer | Y | 排序 |
| confirmDate | String | N | 离职确认时间（审批人） |
| images | List<String> | N | 图片 |
| files | List<Map<String,String>> | N | 附件 |
| sign | String | N | 审批签名路径 |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/workflow/step/details?sign=7omyqoNIY5QPWKCyQM3Q7Hk8mNQ=
请求Body示例:
{
"timestamp": 1606297914820,
"sid": 788833592884330497,
"operatorId": "1ac8bdd3a71f41ee964deedb61462357"
}
SDK请求示例(java):
FlowRecordListRequest request = new FlowRecordListRequest(access_token());
request.setSid(788833592884330497L);
request.setOperatorId("1ac8bdd3a71f41ee964deedb61462357");
OpenapiResponse<List<FlowRecordResult>> response = XrxsApprovalService.getFlowRecord(request);
响应示例:
{
"errcode":0,
"errmsg":"成功",
"data":[
{
"time":"05.05 18:23",
"copyTime":null,
"stepType":1,
"stepStatus":null,
"passType":null,
"ownerName":"测试",
"replaceName":null,
"accountName":null,
"confirmDate":null,
"approveResults":[
],
"copyResults":[
],
"comments":[
{
"employeeName":"测试人员",
"comment":"测试评论",
"time":"05-06 18:04",
"confirmDate":null,
"files":[
],
"images":[
],
"position":0,
"sign":null
}
]
},
{
"time":"05.06 18:04",
"copyTime":null,
"stepType":3,
"stepStatus":1,
"passType":1,
"ownerName":null,
"replaceName":null,
"accountName":null,
"confirmDate":null,
"approveResults":[
{
"approveId":"a42c11aed7b645a2be77cd0a54cc33da",
"name":"测试人员",
"status":1,
"roleName":"发起人所在部门负责人",
"time":"05.06 18:04",
"position":0,
"remark":null,
"sign":"",
"agentInfo":null
}
],
"copyResults":[
],
"comments":[
{
"employeeName":"测试人员",
"comment":"测试",
"time":"05-06 18:04",
"confirmDate":null,
"files":[
],
"images":[
],
"position":0,
"sign":null
}
]
},
{
"time":"05.06 18:04",
"copyTime":null,
"stepType":3,
"stepStatus":0,
"passType":1,
"ownerName":null,
"replaceName":null,
"accountName":"",
"confirmDate":null,
"approveResults":[
{
"approveId":"a42c11aed7b645a2be77cd0a54cc33da",
"name":"测试人员",
"status":0,
"roleName":"发起人上级部门负责人",
"time":null,
"position":0,
"remark":null,
"sign":null,
"agentInfo":null
}
],
"copyResults":[
],
"comments":[
]
},
{
"time":null,
"copyTime":null,
"stepType":2,
"stepStatus":0,
"passType":null,
"ownerName":null,
"replaceName":null,
"accountName":null,
"confirmDate":null,
"approveResults":[
],
"copyResults":[
],
"comments":[
]
}
]
}