外出状态同步
接口说明: 同步员工的外出打卡记录
请求方式:POST(HTTPS)
请求地址:https://api.xinrenxinshi.com/v5/attendance/leaveout
请求Header:
key | value |
---|---|
access_token | 获取的access_token的实际值 |
Query参数:
key | value |
---|---|
sign | 签名值 |
Body参数:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
employeeId | String | Y | 员工id |
timeUnit | Integer | Y | 外出时间类型 0--按天外出,1–按小时外出 |
startDate | String | Y | 外出开始日期,日期格式:yyyy-MM-dd HH:mm:ss |
startTime | Integer | N | 如果是按天申请外出的话 则必填 其中0:表示上半天 1:表示下半天 |
endDate | String | Y | 外出结束日期,日期格式:yyyy-MM-dd HH:mm:ss |
endTime | Integer | N | 如果是按天申请外出的话 则必填 其中0:表示上半天 1:表示下半天 |
reason | String | N | 申请原因 |
timestamp | Long | Y | 请求时间戳(精确到毫秒) |
返回结果:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
errcode | Integer | Y | 0成功,其他失败 |
errmsg | String | Y | 结果描述 |
data | AttendanceLeaveOutResult | N | 处理成功时返回 |
AttendanceLeaveOutResult
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
approvalId | String | Y | 返回的外出记录ID 销外出的时候需要用到 |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/attendance/leaveout?sign=231SDSFDFWdewd
请求Body示例:
- 按天申请
{ "endDate":"2021-05-21 12:00:01", "employeeId":"805f8c65825b4c2fae96f64ffb7d6901", "startTime":0, "endTime":1, "startDate":"2021-05-20 13:22:00", "timeUnit":0, "timestamp":1629862969555 }
- 按小时申请
{ "employeeId":"805f8c65825b4c2fae96f64ffb7d6901", "endDate":"2021-05-21 12:00:00", "startDate":"2021-05-20 13:00:00", "timeUnit":1, "timestamp":1629862969555 }
SDK请求示例(java):
AttendanceLeaveOutRequest request = new AttendanceLeaveOutRequest(access_token());
request.setEmployeeId("805f8c65825b4c2fae96f64ffb7d6901");
request.setStartDate("2021-05-20 00:00:00");
request.setTimeUnit(0);
request.setStartTime(0);
request.setEndDate("2021-05-21 12:00:00");
request.setEndTime(1);
OpenapiResponse<String> leaveOut = XrxsAttendanceService.leaveOut(request);
响应示例:
{
"errcode": 0,
"errmsg": "成功",
"data": {
"approvalId": "9330567"
}
}