IDaaS Open Platform
Employee Identity (EIAM)

Get Job Position List

Interface

# Permissions

The Identity Management API is authorized at the 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 and write permissions for the job position management interface
job_position_read Read permission for the job position 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-positions?org_id=&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
org_id Organization ID No String When empty, query all job positions
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 Number Yes int Starting from page 0
limit Items Per Page Yes int Items per page should be between 10-100

# Response Example

Correct Example:
HTTP/1.1 200 OK
Content-Type: application/json
{
    "total": 1,
    "job_positions": [
        {
            "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": "Organization does not exist",
  "error_code": "ORG.0001"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

# Response Parameters

Parameter Name Chinese Name Type Description
total Total Count int
job_positions Job Position Collection List
--position_id Position ID String
--org_id Organization ID String
--name Position Name String
--code Position Code String
--title_id Job Title ID Corresponding to the Position 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
400 ORG.0001 组织不存在 请检查对应组织是否存在
Organization does not exist

Understood. I am ready to receive the Markdown content for translation. Please paste it.

Add Job Title