IDaaS Open Platform
Employee Identity (EIAM)

Add Job Position

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_position_all Read and write permissions for the job position management interface
all Read and write permissions for all interfaces

# Request Specification

POST https://{your_domain}/api/v2/tenant/job-positions

# 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

{
    "org_code": "10000",
    "name": "IDaaS Java Development Engineer",
    "code": "IDaaS_Java_Developer",
    "title_code": "Senior_Engineer"
}
1
2
3
4
5
6

To add job position information, if the position is associated with a job title, pass the parameter title_code. If it is not associated, the title_code parameter can be omitted.

# Request Parameters

Parameter Name Chinese Name Required Type Description
org_code Organization Code Yes String
name Job Position Name Yes String Job position name
code Job Position Code Yes String Job position code, unique within the system
title_code Job Title Code No String Associated job title code, can be empty

# Response Example

Success Example:
HTTP/1.1 201 Created
Content-Type: application/json
{
    "position_id": "20201028102749564-9082-DC8CD2722"
}

Error Example:
HTTP/1.1 400 Bad Request
{
    "error_code": "ORG.0001",
    "error_msg": "Organization does not exist"
}
1
2
3
4
5
6
7
8
9
10
11
12
13

# Response Parameters

Parameter Name Chinese Name Type Description
position_id Position ID String Automatically generated by the system

# Error Codes

Status Code Error Code Error Message Handling Action
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.
The job management function is not enabled, please enable this function first
400 COM.0601 Parameter error, missing parameter or incorrect parameter type. Please check if the input parameters comply with the validation rules.
Parameter missing or incorrect parameter type
400 JOB.POSITION.0009 Position code already exists. Please modify to a different position code.
Position code already exists
400 ORG.0001 Organization does not exist. Please check if the corresponding organization exists.
Organization does not exist
400 JOB.TITLE.0001 Job title does not exist. Please check if the corresponding job title exists.
Job title does not exist

I'm ready. Please provide the Markdown content you need translated.

Update Job Position