设置信息¶
获取合同公司列表¶
使用场景：该接口用于获取该企业的全部合同公司列表。
请求方式：GET（HTTPS）
请求地址：https://openapi.2haohr.com/api/contract_companies/?access_token=ACCESS_TOKEN
参数说明：
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| access_token | String | 是 | 调用接口凭证 |
| ids | String | 否 | 合同公司id,使用逗号隔开，一次最多支持100，如果不写，获取所有的合同公司列表 |
权限说明
返回结果：
{
"errcode": 0,
"errmsg": "",
"data": {
"p": 1,
"limit": 20,
"offset": 0,
"total_count": 10,
"totalpage": 1,
"objects": [
{
"id": "1bb01e*****04d3591a03*****d394fb",
"name": "2号人事部",
"short_name": "2号"
},
{
"id": "9faec9*****d4c959d8af*****8c2bd5",
"name": "三茅人力资源",
"short_name": "三茅"
}
]
}
}
参数说明：
| 参数 | 说明 |
|---|---|
| errcode | 返回码 |
| errmsg | 对返回码的文本描述内容 |
| data | 返回数据 |
| id | 合同公司id |
| name | 合同公司名称 |
| short_name | 简称 |
获取工作地点列表¶
使用场景：该接口用于获取该企业的全部工作地点列表。
请求方式：GET（HTTPS）
请求地址：https://openapi.2haohr.com/api/work_places/?access_token=ACCESS_TOKEN
参数说明：
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| access_token | String | 是 | 调用接口凭证 |
| ids | String | 否 | 工作地点id,使用逗号隔开，一次最多支持100，如果不写，获取所有的工作地点列表 |
权限说明
返回结果：
{
"errcode": 0,
"errmsg": "",
"data": {
"p": 1,
"limit": 20,
"offset": 0,
"total_count": 10,
"totalpage": 1,
"objects": [
{
"id": "67ab78*****84487a1a20*****07d52f",
"address": "江苏南京",
"full_address": "深圳市/宝安区"
}
]
}
}
参数说明：
| 参数 | 说明 |
|---|---|
| errcode | 返回码 |
| errmsg | 对返回码的文本描述内容 |
| data | 返回数据 |
| id | 工作地点id |
| address | 工作地点 |
| full_address | 详细地址 |
获取公司离职原因列表¶
使用场景：该接口用于获取该企业的全部离职原因列表。
请求方式：GET（HTTPS）
请求地址：https://openapi.2haohr.com/api/employee/leave_reason_list/?access_token=ACCESS_TOKEN
参数说明：
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| access_token | String | 是 | 调用接口凭证 |
权限说明
返回结果：
{
"errcode": 0,
"errmsg": "",
"data": [
{
"leave_reasons": [
{
"sort": 1,
"id": 1,
"reason_name": "家庭原因"
},
{
"sort": 2,
"id": 2,
"reason_name": "身体原因"
}
],
"leave_type_sort": 1,
"leave_type_id": "33e6c7******4154ab58******49d914",
"leave_type_name": "主动离职"
}
]
}
参数说明：
| 参数 | 说明 |
|---|---|
| errcode | 返回码 |
| errmsg | 对返回码的文本描述内容 |
| data | 返回数据 |
| leave_type_id | 离职类型id |
| leave_type_name | 离职类型名称 |
| leave_type_sort | 离职类型排序 |
| leave_reasons | 离职原因列表 |
| id | 离职原因id |
| reason_name | 离职原因名称 |
| sort | 离职原因排序 |
获取公司异动原因列表¶
使用场景：该接口用于获取该企业的全部异动原因列表。
请求方式：GET（HTTPS）
请求地址：https://openapi.2haohr.com/api/employee/transfer_reason_list/?access_token=ACCESS_TOKEN
参数说明：
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| access_token | String | 是 | 调用接口凭证 |
| type_name | String | 否 | 异动原因类型，full--转全职，promotion--晋升原因，domotion--降级原因，job--调岗原因,没有返回全部 |
权限说明
返回结果：
{
"errcode": 0,
"errmsg": "",
"data": [
{
"type_name": "job",
"reasons": [
{
"sort": 1,
"name": "组织架构调整",
"id": "404b6d******432db133******404d7a"
},
{
"sort": 2,
"name": "个人申请",
"id": "53116e******4583b397******e7cbe6"
},
{
"sort": 3,
"name": "工作安排",
"id": "ea3e55******4432ad83******c19966"
}
]
}
]
}
参数说明：
| 参数 | 说明 |
|---|---|
| errcode | 返回码 |
| errmsg | 对返回码的文本描述内容 |
| data | 返回数据 |
| type_name | 异动类型 |
| reasons | 异动类型原因列表 |
| sort | 异动原因排序 |
| id | 异动原因id |
| name | 异动原因名称 |
企业获取合同类型列表¶
使用场景：该接口用于获取企业合同类型列表，在创建合同记录时需要此信息
请求方式：GET（HTTPS）
请求地址：https://openapi.2haohr.com/api/employees/contract_list/type/list/?access_token=ACCESS_TOKEN&is_used=1
参数说明：
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| access_token | String | 是 | 调用接口凭证 |
| is_used | Number | 否 | 获取所有类型不需要传睇该参数，传惨只允许0，1；0表示未启用，1表示启用中的合同类型 |
权限说明
返回结果：
{
"errcode": 0,
"errmsg": "",
"data": [
{
"contract_type_number": 1,
"contract_type_title": "",
"id": "",
"is_system": false,
"is_used": false,
"remark": ""
}
]
}
参数说明：
| 参数 | 说明 |
|---|---|
| errcode | 返回码 |
| errmsg | 对返回码的文本描述内容 |
| data | 返回数据 |
| id | 合同类型id |
| contract_type_number | 合同类型 |
| contract_type_title | 合同类型名称 |
| is_system | 是否为系统合同 |
| is_used | 是否已启用 |
| remark | 备注 |