审批列表
接口说明: 获取公司审批列表,可以根据审批状态、审批类型、部门id、审批发起时间维度、审批结束时间维度进行筛选
列表默认排序方式:按发起时间降序排列,即:优先返回最新的审批
请求方式:POST(HTTPS)
请求地址:https://api.xinrenxinshi.com/v4/workflow/list
请求Header::
key | value |
---|---|
access_token | 获取的access_token的实际值 |
参数说明:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
pageNo | Integer | Y | 列表第几页,从0开始 |
pageSize | Integer | Y | 每页条数,1~100之间 |
flowStatus | String | N | 审批状态,多个逗号分隔 |
flowTypes | String | N | 审批类型,多个逗号分隔 |
departmentIds | String | N | 部门id,多个逗号分隔 |
addtimeStart | Integer | N | 审批发起时间维度的开始时间,addtimeStart、addtimeEnd必须联合使用,即:两者都有值或都为空 |
addtimeEnd | Integer | N | 审批发起时间维度的结束时间,addtimeStart、addtimeEnd必须联合使用,即:两者都有值或都为空 |
lastModtimeStart | Integer | N | 审批最后一次更新时间维度的开始时间,lastModtimeStart、lastModtimeEnd必须联合使用,即:两者都有值或都为空 |
lastModtimeEnd | Integer | N | 审批最后一次更新时间维度的结束时间,lastModtimeStart、lastModtimeEnd必须联合使用,即:两者都有值或都为空 |
timestamp | Long | Y | 请求时间戳(精确到毫秒) |
sign | String | Y | 请求参数签名 |
返回结果:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
errcode | Integer | Y | 0成功,其他失败 |
errmsg | String | Y | 操作结果描述 |
data | Page | N | 处理成功时的数据结果 |
Page | |||
pageNo | Integer | Y | 当前页 |
pageSize | Integer | Y | 每页显示条数 |
result | List<ProcessBasicInfo> | Y | 审批数据列表 |
ProcessBasicInfo
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
sid | Long | Y | 审批id |
ownerId | String | Y | 审批所属人的员工id |
ownerName | String | Y | 审批所属人姓名 |
sponsorName | String | Y | 发起人姓名 |
departmentId | String | Y | 部门id |
departmentName | String | Y | 部门名称 |
flowTypeId | Integer | Y | 审批类型id,详见审批类型接口 |
flowTypeName | String | Y | 审批类型名称 |
flowNumber | String | Y | 审批编号 |
remark | String | Y | 备注 |
status | Integer | Y | 审批状态: 0.审批中、 1.已通过、 2.已驳回、 3.已撤销 |
confirmDate | String | N | 离职确认时间 |
addtime | Integer | Y | 审批发起时间 |
modtime | Integer | N | 审批修改时间 |
lastStepModtime | Integer | Y | 审批最后操作时间 |
响应示例:
{
"errcode": 0,
"errmsg": "成功",
"data": {
"pageNo": 0,
"pageSize": 5,
"result": [
{
"sid": 577078451555794945,
"ownerId": "acf64885b5dd4c57b4388ad80971b2a9",
"ownerName": "员工2",
"sponsorName": "123",
"departmentId": "c82dce1baf0044eb878c45a69fe11026",
"departmentName": "部门2-1",
"flowTypeId": 1,
"flowTypeName": "转正",
"remark": null,
"status": 0,
"confirmDate": null,
"addtime": 1567482527,
"modtime": 1567482527,
"lastStepModtime": 1567482527,
"flowNumber":"202008031433000001"
},
{
"sid": 577194863846752256,
"ownerId": "e7ea779520d249afafa8421b21aafa36",
"ownerName": "员工1",
"sponsorName": "123",
"departmentId": "aee61ce9608e46e09b5d5319c237f67c",
"departmentName": "部门1-1",
"flowTypeId": 1,
"flowTypeName": "转正",
"remark": null,
"status": 0,
"confirmDate": null,
"addtime": 1567480766,
"modtime": 1567480766,
"lastStepModtime": 1567480766,
"flowNumber":"202008031433000005"
},
{
"sid": 577194863846752255,
"ownerId": "d9aec5ae99df4a2a8d70cf88eddb8b16",
"ownerName": "员工40",
"sponsorName": "员工40",
"departmentId": "43bc0857c941416998face550d89158a",
"departmentName": "部门10-4",
"flowTypeId": 1,
"flowTypeName": "转正",
"remark": null,
"status": 3,
"confirmDate": null,
"addtime": 1567673093,
"modtime": 1567673093,
"lastStepModtime": 1567673101,
"flowNumber":"202008031433000002"
},
{
"sid": 57719463846752257,
"ownerId": "d29305303c9e4817987c7d4a7f3dd628",
"ownerName": "员工5",
"sponsorName": "123",
"departmentId": "5dfafb12cdca4b4f97adfc58035ba057",
"departmentName": "部门5-1",
"flowTypeId": 3,
"flowTypeName": "调薪",
"remark": null,
"status": 0,
"confirmDate": null,
"addtime": 1567741285,
"modtime": 1567741285,
"lastStepModtime": 1567741285,
"flowNumber":"202008031433000004"
},
{
"sid": 57719463846752258,
"ownerId": "d9aec5ae99df4a2a8d70cf88eddb8b16",
"ownerName": "员工40",
"sponsorName": "123",
"departmentId": "43bc0857c941416998face550d89158a",
"departmentName": "部门10-4",
"flowTypeId": 1,
"flowTypeName": "转正",
"remark": null,
"status": 1,
"confirmDate": null,
"addtime": 1567673129,
"modtime": 1567673129,
"lastStepModtime": 1567673142,
"flowNumber":"202008031433000003"
}
]
}
}