竹云IDaaS•开放平台
员工身份(EIAM)

新增职位

接口

# 权限

身份管理API是以应用维度授权的，在调用接口前需为不同的应用设置接口权限，详情请参考API权限。

权限代码 描述
job_position_all 职位管理接口的读写权限
all 全部接口读写权限

# 请求说明

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

# 请求头

参数名 中文名称 必须 类型 描述
Authorization 授权 是 String 格式：Bearer {access_token}
Content-Type 内容类型 是 String 固定值：application/json; charset=utf-8

# 请求示例

{ 
    "org_code": "10000",
    "name": "IDaaS Java 开发工程师",
    "code": "IDaaS_Java_Developer",
    "title_code": "Senior_Engineer"
}
1
2
3
4
5
6

新增职位信息，职位如果和职务相关联，则传递参数title_code，如果不关联，可以不传递title_code参数

# 请求参数

参数名 中文名称 必须 类型 描述
org_code 组织编码 是 String
name 职位名称 是 String 职位名称
code 职位编码 是 String 职位编码，系统唯一
title_code 职务编码 否 String 关联的职务编码，可以为空

# 返回示例

成功示例： 
HTTP/1.1 201 Created 
Content-Type: application/json 
{ 
    "position_id": "20201028102749564-9082-DC8CD2722" 
} 

错误示例： 
HTTP/1.1 400 Bad Request 
{ 
    "error_code": "ORG.0001", 
    "error_msg": "组织不存在" 
}
1
2
3
4
5
6
7
8
9
10
11
12
13

# 返回参数

参数名 中文名称 类型 描述
position_id 职位id String 系统自动生成

# 错误码

状态码 错误码 错误信息 处理措施
400 ENT.CONFIG.0031 任职管理功能未开启，请先开启此功能 请先在企业中心开启任职管理
The job management function is not enabled, please enable this function first
400 COM.0601 参数错误，缺少参数或者参数类型不正确 请检查入参是否符合校验规则
Parameter missing or incorrect parameter type
400 JOB.POSITION.0009 职位编码已存在 请修改为其他的职位编码
Position code already exists
400 ORG.0001 组织不存在 请检查对应组织是否存在
Organization does not exist
400 JOB.TITLE.0001 职务不存在 请检查对应职务是否存在
Job title does not exist

修改职位