员工考勤状态信息
接口说明: 获取员工考勤状态信息
注意事项:
- 未排班的员工的状态可能为空，休息日状态为空,空状态不返回。
- 类似旷工、早退、迟到这些非申请的状态是不返回的。
- 未来日期非申请状态也不返回。
请求方式: POST(HTTPS)
请求路径:https://api.xinrenxinshi.com/v5/attendance/employee/status
请求header:
| key | value |
|---|---|
| access_token | 获取的access_token的实际值 |
Query参数:
| key | value |
|---|---|
| sign | 签名值 |
Body参数:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| employeeId | String | Y | 员工id |
| startDate | String | Y | 开始时间，格式:yyyy-MM-dd |
| endDate | String | Y | 结束时间，格式:yyyy-MM-dd |
| timestamp | Long | Y | 请求时间戳（精确到毫秒） |
返回结果:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| errcode | Integer | Y | 0成功，其他失败 |
| errmsg | String | Y | 结果描述 |
| data | List<AttendanceStatusRangeResult> | N | 员工考勤状态信息 |
AttendanceStatusRangeResult
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| startDate | String | Y | 开始时间，格式:yyyy-MM-dd |
| endDate | String | Y | 结束时间，格式:yyyy-MM-dd |
| status | Integer | Y | 状态,0-正常，1-外勤，2-出差，3-外出，4-请假，5-居家办公 |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/attendance/employee/status?sign=0IMp6jFPjptcZu0rFcjqsLSK3F4%3D
请求Body示例:
{
"employeeId": "a42c11aed7b645a2be77cd0a54cc33da",
"startDate": "2023-02-01",
"endDate": "2023-02-16",
"timestamp": 1606706970446
}
SDK请求示例(java):
AttendanceStatusRequest request = new AttendanceStatusRequest(access_token());
request.setEmployeeId("a42c11aed7b645a2be77cd0a54cc33da");
request.setStartDate("2023-02-01");
request.setEndDate("2023-02-16");
OpenapiResponse<List<AttendanceStatusRangeResult>> response = XrxsAttendanceService.getEmployeeStatus(request);
响应示例:
{
"errcode":0,
"errmsg":"成功",
"data":[
{
"startDate":"2023-02-03",
"endDate":"2023-02-03",
"status":0
},
{
"startDate":"2023-02-06",
"endDate":"2023-02-06",
"status":1
},
{
"startDate":"2023-02-07",
"endDate":"2023-02-07",
"status":2
},
{
"startDate":"2023-02-10",
"endDate":"2023-02-10",
"status":0
},
{
"startDate":"2023-02-13",
"endDate":"2023-02-16",
"status":2
}
]
}