增量查询员工定期区间

接口描述

此接口为增量接口，用于按照员工最后变更日期查询员工的定期区间。

接口权限

本接口需要集团权限

请求URI

/api/openapi/users/contactRoutes

请求方式

GET

请求参数示例

/api/openapi/users/contactRoutes?startTime=2023-02-01 00:00:00&endTime=2023-02-22 00:00:00&page=1&size=20

请求参数说明

参数名	类型	是否必填	说明
startTime	String	是	查询开始时间。格式: yyyy-MM-dd HH:mm:ss
endTime	String	是	查询结束时间。格式: yyyy-MM-dd HH:mm:ss
page	int	是	页码, 第一页的page为1
size	int	是	每页结果数。最大50

接口返回示例

{
    "total": 1,
    "current": 1,
    "pageSize": 10,
    "pages": 1,
    "hasPrevious": false,
    "hasNext": false,
    "data": [
        {
         "employeeId": "EMP-001",
         "employeeName": "従業員００１",
         "detailRoute": "大手町(東京都):東京メトロ東西線:Down:茅場町:東京メトロ日比谷線:Down:日比谷",
         "detailRouteNoDirection": "",
         "displayRoute": "大手町(東京都)--東京メトロ東西線--茅場町--東京メトロ日比谷線--日比谷",
         "oneMonthPrice": 6950,
         "threeMonthPrice": 19810,
         "sixMonthPrice": 37530
        },
        {
         "employeeId": "EMP-002",
         "employeeName": "従業員００2",
         "detailRoute": "大手町(東京都):東京メトロ東西線:Down:茅場町:東京メトロ日比谷線:Down:日比谷",
         "detailRouteNoDirection": "",
         "displayRoute": "大手町(東京都)--東京メトロ東西線--茅場町--東京メトロ日比谷線--日比谷",
         "oneMonthPrice": 6950,
         "threeMonthPrice": 19810,
         "sixMonthPrice": 37530
        }
    ]
}

接口返回字段

PageResposne

参数名	类型	说明
total	int	查询结果总个数
current	int	当前页数
pageSize	int	每页结果计
pages	int	查询结果总分页数
hasPrevious	boolean	是否有上一页
hasNext	boolean	是否有下一页

contactRoute

字段名	类型	规则	说明
employeeId	String	最大长度 32	员工工号
employeeName	String	最大长度 100	员工姓名
detailRoute	String	最大长度 999	路线详情
detailRouteNoDirection	String	最大长度 999	路线详情(无方向)
displayRoute	String	最大长度 999	路线展示
oneMonthPrice	Long	最大长度 10	1个月定期券
threeMonthPrice	Long	最大长度 10	3个月定期券
sixMonthPrice	Long	最大长度 10	6个月定期券

失败示例

{
    "message": "当前操作需要租户权限",
    "errorCode": "120001"
}

字段说明

字段名称	类型	说明
message	String	返回信息说明
errorCode	String	返回错误码

错误代码

errorCode	message	说明
120001	当前操作需要租户权限
4003	时间格式为:{0}

← 同步员工定期区间信息