Get Job Position List

Permissions

The Identity Management API is authorized at the application level. Before calling the API, you need to set API permissions for different applications. For details, see API Permissions.

Permission Code	Description
job_position_all	Read/Write permission for job position management APIs
job_position_read	Read permission for job position management APIs
all	Read/Write permission for all APIs
read	Read permission for all read APIs

Request Description

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	Query all job positions when empty
updated_at_greater	Update time greater than	No	String	Filters by update time, only records updated after this time are returned, format: yyyy-MM-dd HH:mm:ss
offset	Page number	Yes	int	Starting from page 0
limit	Page size	Yes	int	Page size between 10 and 100

Response Example

Success Example

HTTP/1.1 200 OK

{
    "total": 1,
    "job_positions": [
        {
            "position_id": "20220825141325371-4D03-81EF80243",
            "org_id": "20210529172248496-D329-5748DE918",
            "name": "IDaaS Java Development Engineer",
            "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"
}

Response Parameters

Parameter Name	Chinese Name	Type	Description
total	Total	int
job_positions	Job position list	List
--position_id	Job position ID	String
--org_id	Organization ID	String
--name	Job position name	String
--code	Job position code	String
--title_id	Job title ID corresponding to the job position	String
--created_at	Creation time	String
--updated_at	Update time	String

Error Codes

Status Code	Error Code	Chinese Error Message	English Error Message	Resolution
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	OAP.PAGE.0003	分页页码不符合校验规则	The pagination page number does not meet the verification rules	Please check whether the input pagination page number is correct
400	OAP.PAGE.0004	每页数量不符合校验规则	The number of pages does not meet the verification rules	Please check whether the input page size is correct
400	OAP.PARAM.0004	参数[{0}]不符合校验规则	Parameter [{0}] does not comply with validation rules	Please check whether the input parameters comply with validation rules
400	ORG.0001	组织不存在	Organization does not exist	Please check whether the corresponding organization exists