获取岗位信息(包括岗位分类)
接口说明: 获取公司岗位词典的详细信息。包含岗位id，父岗位id，岗位分类，岗位名称，岗位编码，岗位说明以及岗位备注以及适用部门。 共三种情况:
jobId 和 departmentId 都为空时，获取公司全部的岗位详细信息
jobId不为空，获取公司单个指定岗位详细信息
jobId为空且departmentId不为空时，获取公司指定部门下的岗位信息
请求方式:POST（HTTPS）
请求地址:https://api.xinrenxinshi.com/v5/department/jobdictionary/detaillist
请求Header:
| key | value |
|---|---|
| access_token | 获取的access_token的实际值 |
Query参数:
| key | value |
|---|---|
| sign | 签名值 |
Body参数:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| jobId | String | N | 岗位id，传值时，返回指定岗位的详细信息 |
| departmentId | String | N | 部门id，传值时，返回公司对应部门下的岗位详细信息 |
| timestamp | Long | Y | 请求时间戳（精确到毫秒） |
返回结果:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| errcode | Integer | Y | 0成功，其他失败 |
| errmsg | String | Y | 结果描述 |
| data | List<JobDictionaryModel> | Y | 岗位详细信息列表 |
JobDictionaryModel
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| jobId | String | Y | 岗位id |
| parentId | String | Y | 父岗位id，即岗位所属的分类id |
| name | String | Y | 岗位名称 |
| enName | String | Y | 岗位英文名称 |
| type | String | Y | 岗位类型,0-岗位分类，1-岗位实体 |
| code | String | Y | 岗位编码 |
| remark | String | N | 岗位备注 |
| introduction | String | N | 岗位说明 |
| departmentIds | List<String> | N | 岗位的适用部门ids |
| rankIds | List<String> | N | 岗位的适用职级ids |
| addtime | Integer | Y | 添加时间 |
| modtime | Integer | Y | 更新时间 |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/department/jobdictionary/detaillist?sign=LBTdxC91dr0LaR7TYcpZvej8q/E=
请求Body示例:
{
"timestamp": 1606209755763
}
SDK请求示例(java):
JobDictionaryDetailRquest request = new JobDictionaryDetailRquest(access_token());
OpenapiResponse<List<JobDictionaryModel>> jobDictionary = XrxsDepartmentService.getJobDictionary(request);
响应示例:
{
"errcode":0,
"errmsg":"成功",
"data":[
{
"jobId":"886f867fdd8f4fd1b52120213dcd9276",
"parentId":"0",
"type":0,
"name":"岗位1",
"enName": "",
"code":null,
"remark":null,
"introduction":"",
"addtime":1619347836,
"modtime":1625816728,
"departmentIds":[
],
"rankIds": [
]
},
{
"jobId":"da9eb5053fb642fbb0eb4f266882e0bc",
"parentId":"886f867fdd8f4fd1b52120213dcd9276",
"type":1,
"name":"开发",
"enName": "",
"code":"开发",
"remark":"",
"introduction":"",
"addtime":1619347836,
"modtime":1625816728,
"departmentIds":[
],
"rankIds": [
]
},
{
"jobId":"0b8350ddba41441f806dd221349b2034",
"parentId":"886f867fdd8f4fd1b52120213dcd9276",
"type":1,
"name":"测试",
"enName": "",
"code":"测试",
"remark":"",
"introduction":"",
"addtime":1619347836,
"modtime":1625816728,
"departmentIds":[
"3773766ae7e141f49a9aa13da581958a",
"e3ae0f25eb984fe898cb9cca8336450a"
],
"rankIds": [
"e91a63bb2cd746878b3f2dbc363ba684",
"8372c30db7c9448db70a34b32f2525fa"
]
},
{
"jobId":"2c797f58638f4b50a12b3d7b677aa114",
"parentId":"0",
"type":0,
"name":"岗位2",
"enName": "",
"code":null,
"remark":null,
"introduction":"",
"addtime":1619347836,
"modtime":1625816728,
"departmentIds":[
],
"rankIds": [
"e91a63bb2cd746878b3f2dbc363ba684"
]
},
{
"jobId":"b58d231e668f4168a186a7f2045e3756",
"parentId":"0",
"type":0,
"name":"岗位3",
"enName": "",
"code":null,
"remark":null,
"introduction":"岗位3",
"addtime":1619347836,
"modtime":1625816728,
"departmentIds":[
],
"rankIds": [
"e91a63bb2cd746878b3f2dbc363ba684"
]
},
{
"jobId":"47bdb617f8da49b285ed0f19cb3a35fa",
"parentId":"2c797f58638f4b50a12b3d7b677aa114",
"type":1,
"name":"java",
"enName": "",
"code":"java",
"remark":"",
"introduction":"",
"addtime":1619347836,
"modtime":1625816728,
"departmentIds":[
"d1e332f117dc4ec8b9b1dcf47c6b5490"
],
"rankIds": [
"e91a63bb2cd746878b3f2dbc363ba684"
]
},
{
"jobId":"69623e0528414766b7a9f183152eda07",
"parentId":"2c797f58638f4b50a12b3d7b677aa114",
"type":1,
"name":"php",
"enName": "",
"code":"php",
"remark":"",
"introduction":"",
"addtime":1619347836,
"modtime":1625816728,
"departmentIds":[
],
"rankIds": [
]
},
{
"jobId":"cb1c0bb16d324cdda351336c03ea92d7",
"parentId":"b58d231e668f4168a186a7f2045e3756",
"type":1,
"name":"总经办",
"enName": "",
"code":"总经办",
"remark":"",
"introduction":"",
"addtime":1619347836,
"modtime":1625816728,
"departmentIds":[
"fb17fed4e81a47008233334f7ea6c354"
],
"rankIds": [
"8372c30db7c9448db70a34b32f2525fa"
]
},
{
"jobId":"1795d96a15b34c30bceda6bd4a4504aa",
"parentId":"b58d231e668f4168a186a7f2045e3756",
"type":1,
"name":"作战部",
"enName": "",
"code":"作战部",
"remark":"",
"introduction":"",
"addtime":1619347836,
"modtime":1625816728,
"departmentIds":[
"66cb5a71fbd24afb831b1ed14ed0a36b"
],
"rankIds": [
"8372c30db7c9448db70a34b32f2525fa"
]
}
]
}