项目工人数据
接口说明
该接口用于获取工人名册信息,接口将返回大于指定version值的增量数据,返回结果将按数据的version字段进行升序排序,每次查询最多返回200条数据。
接口地址
/dw/labor/project-workers/v2?start=12345&limit=200&projectId=100001
接口类型
Http
请求方式
GET
内容类型
application/json
鉴权策略
参见《Open-API鉴权协议》
请求参数
| 参数名称 | 说明 |
|---|---|
| start | 本次请求所要获取的增量数据的version起始值,客户端需要缓存接口返回的数据集合中最后一条数据的version值 |
| limit | 返回指定的数据条数 上限为200条 0 < limit <= 200 |
| projectId | 项目ID |
响应报文
"data": [
{
"id": 400187690217472,
"orgId": 135302756025344,
"orgName": "6项目部",
"workerId": 185458810851328,
"workerOriginalId": "2531956",
"name": "张照",
"genderKey": "male",
"gender": "男",
"nativePlace": "山东省烟台市海阳市",
"regionKey": "370000",
"region": "山东省",
"nationalityKey": "01",
"nationality": "汉族",
"birthDate": "1985-08-07T16:00:00.000Z",
"birthYear": 1985,
"birthMonth": 8,
"phoneNumber": "18663950252",
"address": "山东省海阳市二十里店镇埠峰村658号",
"cultureLevelKey": "01",
"cultureLevel": "小学",
"politicalStatusKey": "03",
"politicalStatus": "群众",
"squadId": 185141121634304,
"squadOriginalId": "109468",
"squadName": "项目管理人员",
"teamId": 400186656534528,
"teamOriginalId": "5186",
"teamName": "中建隧道建设有限公司",
"laborCompanyId": 184847230394368,
"laborCompanyOriginalId": "5186",
"laborCompanyName": "中建隧道建设有限公司",
"workTypeName": "其它",
"isSpecialWorkType": false,
"entryTime": "2018-09-26T00:36:22.000Z",
"entryTimeYear": 2018,
"entryTimeMonth": 9,
"entryTimeDay": 26,
"exitTime": "2018-09-26T00:37:18.000Z",
"exitTimeYear": 2018,
"exitTimeMonth": 9,
"exitTimeDay": 26,
"isOnSpot": false,
"originalId": "748998",
"isValid": true,
"createdAt": 1546071842845,
"updatedAt": 1546071842845,
"isRemoved": false,
"version": 400187690528769
}
]
响应状态码
| 字段名称 | 数据类型 |
|---|---|
| 200 | 成功 |
| 400 | 用户请求头中Authorization值的格式不对,错误码:InvalidArgument。 |
| 403 | AccessId不存在或被禁用 错误码:InvalidAccessId |
| 500 | 非法参数或接口执行异常 |
响应数据结构
| 字段名称 | 数据类型 | 是否可以为空 | 字段描述 |
|---|---|---|---|
| id | long | 否 | 主键 |
| orgId | long | 否 | 项目ID |
| orgName | string | 否 | 项目名称 |
| workerId | long | 是 | 工人ID |
| workerOriginalId | string | 是 | 原始工人ID |
| name | string | 是 | 姓名 |
| genderKey | string | 是 | 性别键 见附录 性别对照表 |
| gender | string | 是 | 性别 |
| nativePlace | string | 是 | 籍贯 |
| regionKey | string | 是 | 区域键 见附录 地域对照表 |
| region | string | 是 | 区域 |
| nationalityKey | string | 是 | 民族键 见附录 民族对照表 |
| nationality | string | 是 | 民族 |
| birthDate | date | 是 | 出生日期 |
| birthYear | long | 是 | 出生年 |
| birthMonth | int | 是 | 出生月 |
| phoneNumber | string | 是 | 联系电话 |
| address | stirng | 是 | 联系地址 |
| cultureLevelKey | string | 是 | 学历键 见附录 学历对照表 |
| cultureLevel | stirng | 是 | 学历 |
| politicalStatusKey | string | 是 | 政治面貌键 见附录 政治面貌对照表 |
| politicalStatus | string | 是 | 政治面貌 |
| squadId | long | 是 | 班组ID |
| squadOriginalId | string | 是 | 原始系统所属班组ID |
| squadName | string | 是 | 所属班组名称 |
| teamId | long | 是 | 所属劳务队ID |
| teamOriginalId | string | 是 | 原始系统所属劳务队ID |
| teamName | string | 是 | 所属分包商名称 |
| laborCompanyId | long | 是 | 所属分包商id |
| laborCompanyOriginalId | string | 是 | 原始所属分包商id |
| laborCompanyName | string | 是 | 所属分包商名称 |
| workTypeName | string | 是 | 工种 |
| isSpecialWorkType | boolean | 是 | 是否特殊工种 |
| entryTime | date | 是 | 进场时间 |
| entryTimeYear | long | 是 | 进场时间-年 |
| entryTimeMonth | int | 是 | 进场时间-月 |
| entryTimeDay | int | 是 | 进场时间-日 |
| exitTime | date | 是 | 退场时间 |
| exitTimeYear | long | 是 | 退场时间-年 |
| exitTimeMonth | int | 是 | 退场时间-月 |
| exitTimeDay | int | 是 | 退场时间-日 |
| isOnSpot | boolean | 是 | 是否在场 |
| originalId | string | 是 | 原始Id |
| isValid | boolean | 是 | 是否有效 |
| createdAt | long | 否 | 创建时间 |
| updatedAt | long | 否 | 修改时间 |
| isRemoved | boolean | 否 | 是否删除 |
| version | long | 否 | 当前数据版本 |