获取岗位信息
接口说明: 获取公司全部的岗位信息。包含岗位id，岗位名称以及岗位编码。
departmentId 为空时，获取公司全部的岗位详细信息
departmentId 不为空时，获取适用部门下的岗位信息
请求方式:POST（HTTPS）
请求地址:https://api.xinrenxinshi.com/v5/department/jobdictionary/list
请求Header:
| key | value |
|---|---|
| access_token | 获取的access_token的实际值 |
Query参数:
| key | value |
|---|---|
| sign | 签名值 |
Body参数:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| timestamp | Long | Y | 请求时间戳（精确到毫秒） |
| departmentId | String | N | 部门id，不传时，默认返回公司所有的岗位详细信息，有值时返回指定部门下的岗位列表 |
返回结果:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| errcode | Integer | Y | 0成功，其他失败 |
| errmsg | String | Y | 结果描述 |
| data | List<JobHeaderModel> | Y | 岗位信息列表 |
JobHeaderModel
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| jobId | String | Y | 岗位id |
| jobName | String | Y | 岗位名称 |
| enName | String | Y | 岗位英文名称 |
| jobCode | String | Y | 岗位编码 |
| departmentIds | List<String> | N | 岗位的适用部门id |
| addtime | Integer | Y | 添加时间 |
| modtime | Integer | Y | 更新时间 |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/department/jobdictionary/list?sign=LBTdxC91dr0LaR7TYcpZvej8q/E=
请求Body示例:
{
"timestamp": 1606209755763
}
SDK请求示例(java):
DepartmentJobGetRequest request = new DepartmentJobGetRequest(access_token);
OpenapiResponse<List<JobHeaderModel>> jobList = XrxsDepartmentService.getJobList(request);
响应示例:
{
"errcode":0,
"errmsg":"成功",
"data":[
{
"jobId":"da9eb5053fb642fbb0eb4f266882e0bc",
"jobName":"开发",
"enName": "",
"jobCode":"开发",
"addtime":1619347836,
"modtime":1625816728,
"departmentIds":[
]
},
{
"jobId":"0b8350ddba41441f806dd221349b2034",
"jobName":"测试",
"enName": "",
"jobCode":"测试",
"addtime":1619347836,
"modtime":1625816728,
"departmentIds":[
"3773766ae7e141f49a9aa13da581958a",
"e3ae0f25eb984fe898cb9cca8336450a"
]
},
{
"jobId":"47bdb617f8da49b285ed0f19cb3a35fa",
"jobName":"java",
"enName": "",
"jobCode":"java",
"addtime":1619347836,
"modtime":1625816728,
"departmentIds":[
"d1e332f117dc4ec8b9b1dcf47c6b5490"
]
},
{
"jobId":"69623e0528414766b7a9f183152eda07",
"jobName":"php",
"enName": "",
"jobCode":"php",
"addtime":1619347836,
"modtime":1625816728,
"departmentIds":[
]
},
{
"jobId":"cb1c0bb16d324cdda351336c03ea92d7",
"jobName":"总经办",
"enName": "",
"jobCode":"总经办",
"addtime":1619347836,
"modtime":1625816728,
"departmentIds":[
"fb17fed4e81a47008233334f7ea6c354"
]
},
{
"jobId":"1795d96a15b34c30bceda6bd4a4504aa",
"jobName":"作战部",
"enName": "",
"jobCode":"作战部",
"addtime":1619347836,
"modtime":1625816728,
"departmentIds":[
"66cb5a71fbd24afb831b1ed14ed0a36b"
]
}
]
}