Employee Identity (EIAM)
Get Job Position Details by Position ID
API
# 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_position_all | Read-write permission for the job position management interface |
| job_position_read | Read permission for the job position management interface |
| all | Read-write permission for all interfaces |
| read | Permission for all read interfaces |
# Request Specification
GET https://{your_domain}/api/v2/tenant/job-positions/{position_id}
# Request Headers
| Parameter Name | Chinese Name | Required | Type | Description |
|---|---|---|---|---|
| Authorization | Authorization Token | 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 |
|---|---|---|---|---|
| position_id | Position ID | Yes | String | Job Position ID |
# Return Example
Correct Example:
HTTP/1.1 200 OK
Content-Type: application/json
{
"position_id": "20220825141325371-4D03-81EF80243",
"org_id": "20210529172248496-D329-5748DE918",
"name": "IDaaS Java Developer",
"code": "IDaaS_Java_Developer",
"title_id": "20210529172248496-D329-5748DE919",
"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": "Position does not exist",
"error_code": "JOB.POSITION.0001"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# Return Parameters
| Parameter Name | Chinese Name | Type | Description |
|---|---|---|---|
| position_id | Position ID | String | |
| org_id | Organization ID | String | |
| name | Position Name | String | |
| code | Position Code | String | |
| title_id | Job Title ID for the Position | String | |
| created_at | Creation Time | String | |
| updated_at | Modification Time | String |
# Error Codes
| Status Code | Error Code | Error Message | Handling Measures |
|---|---|---|---|
| 400 | ENT.CONFIG.0031 | The job management function is not enabled, please enable this function first | Please enable job management in the enterprise center first |
| 400 | JOB.POSITION.0001 | Position does not exist | Please check if the corresponding position exists |