Employee Identity (EIAM)
Get Job Title List
Interface
# Permissions
The Identity Management API is authorized on an application dimension. Before calling the interface, you need to set interface permissions for different applications. For details, please refer to API Permissions.
| Permission Code | Description |
|---|---|
| job_title_all | Read and write permissions for the job title management interface |
| job_title_read | Read-only permission for the job title management interface |
| all | Read and write permissions for all interfaces |
| read | Permission for all read-only interfaces |
# Request Specification
GET https://{your_domain}/api/v2/tenant/job-titles?offset=0&limit=10&updated_at_greater=
# Request Headers
| Parameter Name | Chinese Name | Required | Type | Description |
|---|---|---|---|---|
| Authorization | Authorization | Yes | String | Format: Bearer {access_token} |
| Content-Type | Content Type | Yes | String | Fixed value: application/json; charset=utf-8 |
# Request Example
None
# Request Parameters
| Parameter Name | Chinese Name | Required | Type | Description |
|---|---|---|---|---|
| updated_at_greater | Updated At Greater Than | No | String | Filter by update time, only returns records updated after this time, format: yyyy-MM-dd HH:mm:ss |
| offset | Page Offset | Yes | int | Starting from page 0 |
| limit | Items Per Page | Yes | int | Number of items per page, between 10 and 100 |
# Return Example
Correct Example:
HTTP/1.1 200 OK
Content-Type: application/json
{
"total": 1,
"job_titles": [
{
"title_id": "20220825141325371-4D03-81EF80243",
"name": "Senior Engineer",
"code": "Senior_Engineer",
"created_at": "2024-03-27 10:00:45.532",
"updated_at": "2024-03-28 08:26:00.105"
}
]
}
Error Example:
HTTP/1.1 400 Bad Request
{
"error_msg": "Pagination parameter error",
"error_code": "OAP.PAGE.0001"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
# Return Parameters
| Parameter Name | Chinese Name | Type | Description |
|---|---|---|---|
| total | Total Count | int | |
| job_titles | Job Title Collection | List | |
| --title_id | Job Title ID | String | |
| --name | Job Title Name | String | |
| --code | Job Title Code | String | |
| --created_at | Creation Time | String | |
| --updated_at | Modification Time | String |
# Error Codes
| Status Code | Error Code | Error Message | Resolution |
|---|---|---|---|
| 400 | ENT.CONFIG.0031 | 任职管理功能未开启，请先开启此功能 | 请先在企业中心开启任职管理 |
| The job management function is not enabled, please enable this function first | |||
| 400 | OAP.PAGE.0003 | 分页页码不符合校验规则 | 请检查入参分页页码是否正确 |
| The pagination page number does not meet the verification rules | |||
| 400 | OAP.PAGE.0004 | 每页数量不符合校验规则 | 请检查入参每页数量是否正确 |
| The number of pages does not meet the verification rules | |||
| 400 | OAP.PARAM.0004 | 参数[{0}]不符合校验规则 | 请检查入参是否符合校验规则 |
| Parameter [{0}] does not comply with validation rules |
I am ready to proceed. Please provide the Markdown content you need translated.