出差状态同步
接口说明: 同步员工的出差打卡记录
请求方式:POST(HTTPS)
请求地址:https://api.xinrenxinshi.com/v5/attendance/travel/v2
请求Header:
key | value |
---|---|
access_token | 获取的access_token的实际值 |
Query参数:
key | value |
---|---|
sign | 签名值 |
Body参数:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
employeeId | String | Y | 员工id |
startDate | String | Y | 出差开始日期,日期格式:yyyy-MM-dd HH:mm:ss,开始日期与结束日期的时间范围不能超过31天 |
startTime | String | N | 按天时必传 出差开始时间,AM:上半天、PM:下半天 |
endDate | String | Y | 出差结束日期,日期格式:yyyy-MM-dd HH:mm:ss |
endTime | String | N | 按天时必传 出差结束时间,AM:上半天、PM:下半天 |
timeUnit | Integer | Y | 时间单位,0-按天,1-按小时 |
timestamp | Long | Y | 请求时间戳(精确到毫秒) |
返回结果:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
errcode | Integer | Y | 0成功,其他失败 |
errmsg | String | Y | 结果描述 |
data | String | N | 处理成功时,返回的出差记录ID |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/attendance/travel/v2?sign=231SDSFDFWdewd
请求Body示例:
{
"employeeId": "45c8eed05a1c4a2594731940a1fd1b0d",
"startTime": "AM",
"endTime": "PM",
"endDate": "2020-11-27 09:00:00",
"startDate": "2020-11-27 18:00:00",
"timeUnit": 0,
"timestamp": 1606725321852
}
SDK请求示例(java):
AttendanceTravelV2Request request = new AttendanceTravelV2Request(access_token());
request.setEmployeeId("805f8c65825b4c2fae96f64ffb7d6901");
request.setStartDate("2020-11-27 09:00:00");
request.setStartTime("AM");
request.setEndDate("2020-11-27 18:00:00");
request.setEndTime("PM");
request.setTimeUnit(0);
OpenapiResponse<String> travel = XrxsAttendanceService.travelV2(request);
响应示例:
{
"errcode": 0,
"errmsg": "成功",
"data": {
"data": "4279346"
}
}