审批列表

接口说明: 获取公司审批列表，可以根据审批状态、审批类型、部门id、审批发起时间维度、审批结束时间维度进行筛选

列表默认排序方式:按发起时间降序排列，即:优先返回最新的审批

请求方式:POST（HTTPS）
请求地址:https://api.xinrenxinshi.com/v5/workflow/list

请求Header:

key	value
access_token	获取的access_token的实际值

Query参数:

key	value
sign	签名值

Body参数:

参数	类型	必传(Y/N)	说明
pageNo	Integer	Y	列表第几页,从0开始
pageSize	Integer	Y	每页条数，1～100之间
flowStatus	List<Integer>	N	审批状态: 0.审批中、 1.已通过、 2.已驳回、 3.已撤销、 4.离职交接审批中、 5.离职交接完成
flowTypes	List<Integer>	N	审批类型,详见审批类型接口
departmentIds	List<String>	N	部门id
ownerIds	List<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	请求时间戳（精确到毫秒）

返回结果:

参数	类型	必传(Y/N)	说明
errcode	Integer	Y	0成功，其他失败
errmsg	String	Y	操作结果描述
data	PageResult	Y	审批列表

PageResult

参数	类型	必传(Y/N)	说明
totalPageSize	Long	Y	总页数
pageNo	Integer	Y	当前页
pageSize	Integer	Y	每页显示条数
hasMore	boolean	Y	是否有下一页 true-有，false-没有
result	List<ProcessBasicInfo>	Y	审批数据列表

ProcessBasicInfo

参数	类型	必传(Y/N)	说明
sid	Long	Y	审批id
ownerId	String	Y	审批所属人的员工id
ownerName	String	Y	审批所属人姓名
sponsorType	Integer	Y	发起人类型:0.员工、1.管理员
sponsorId	String	Y	发起人id，如果发起人类型是管理员，则对应的是管理员的账号id，如果发起人类型是员工，则对应的是员工id
sponsorMobile	String	N	发起人手机号
sponsorJobNumber	String	N	发起人的工号
sponsorEmployeeId	String	N	如果发起人类型是管理员的话，则是管理员所对应的员工身份的员工id
sponsorName	String	Y	发起人姓名
departmentId	String	Y	部门id
departmentName	String	Y	部门名称
departmentCode	String	Y	部门编码
jobId	String	N	岗位id
jobName	String	N	岗位名称
jobCode	String	N	岗位编码
flowTypeId	Integer	Y	审批类型id，详见审批类型接口
flowTypeName	String	Y	审批类型名称
flowNumber	String	Y	审批编号
remark	String	Y	备注
status	Integer	Y	审批状态: 0.审批中、 1.已通过、 2.已驳回、 3.已撤销、 4.离职交接审批中、 5.离职交接完成
confirmDate	String	N	离职确认时间
addtime	Integer	Y	审批发起时间
modtime	Integer	N	审批修改时间
lastStepModtime	Integer	Y	审批最后操作时间
setting	FlowSettingInfo	N	审批的高级设置

FlowSettingInfo

参数	类型	必传(Y/N)	说明
remarkRequired	Integer	Y	审批意见是否必填开关 0:关 1:开

请求示例(HTTPS):

https://api.xinrenxinshi.com/v5/workflow/list?sign=qiS6p5nHDlz%2FeJlyDrdI5PAoicw%3D

请求Body示例:

{
  "pageNo": 0,
  "pageSize": 10,
  "timestamp": 1606296359253
}

SDK请求示例(java):

ApprovalListRequest request = new ApprovalListRequest(access_token);
request.setPageNo(0);
request.setPageSize(10);
 OpenapiResponse<PageResult<ProcessBasicInfo>> flowList = XrxsApprovalService.getFlowList(request);

响应示例:

{
  "errcode": 0,
  "errmsg": "成功",
  "data": {
    "totalPageSize": 1,
    "pageNo": 0,
    "pageSize": 10,
    "result": [
      {
        "sid": 597874017516650500,
        "ownerId": "b1139f3def6b462a8f45116b8bbb8338",
        "ownerName": "11111",
        "sponsorId":"67af7ee7546b459099ffe36ad2b173f9",
        "sponsorType":1,
        "sponsorName": "小薪",
        "sponsorMobile": "",
        "departmentId": null,
        "departmentName": "",
        "flowTypeId": 2,
        "flowTypeName": "调岗",
        "remark": null,
        "status": 0,
        "confirmDate": null,
        "addtime": 1606217873,
        "modtime": 1606217873,
        "lastStepModtime": 1606217873,
        "flowNumber": "202011241937000001",
        "setting":null
      },
      {
        "sid": 597873626267779100,
        "ownerId": "cf42ab8047944ad6af5d5345bd875eee",
        "ownerName": "测试员工",
        "sponsorId":"cf42ab8047944ad6af5d5345bd875eee",
        "sponsorType":0,
        "sponsorName": "测试员工",
        "sponsorMobile": "",
        "departmentId": "a7b77dbd849d4f11942a0244e5d4652b",
        "departmentName": "最高级部门",
        "flowTypeId": 2,
        "flowTypeName": "调岗",
        "remark": null,
        "status": 0,
        "confirmDate": null,
        "addtime": 1606217780,
        "modtime": 1606217780,
        "lastStepModtime": 1606217780,
        "flowNumber": "202011241936000001",
        "setting":null
      }
    ],
    "hasMore": true
  }
}

审批列表

审批列表

results matching ""

No results matching ""