Employee Identity (EIAM)
Get Job Title Details by ID
API
# Permissions
The Identity Management API is authorized at the application level. 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 user management interface |
| job_title_read | Read permission for the user management interface |
| all | Read and write permissions for all interfaces |
| read | Permission for all read interfaces |
# Request Specification
GET https://{your_domain}/api/v2/tenant/job-titles/{title_id}
# 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 |
|---|---|---|---|---|
| title_id | Job Title ID | Yes | String | Job Title ID |
# Response Example
Correct Example:
HTTP/1.1 200 OK
Content-Type: application/json
{
"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": "Job title does not exist",
"error_code": "JOB.TITLE.0001"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# Response Parameters
| Parameter Name | Chinese Name | Type | Description |
|---|---|---|---|
| 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 | JOB.TITLE.0001 | 职务不存在 | 请检查对应职务是否存在 |
| Job title does not exist |