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

修改职位

接口

# 权限

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

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

# 请求说明

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

# 请求头

参数名 中文名称 必须 类型 描述
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

根据请求的职位ID参数更新职位信息。职位有关联用户使用的情况下不允许更新职位的机构。

# 请求参数

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

# 返回示例

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

错误示例：
HTTP/1.1 400 Bad Request
{
  "error_msg": "职位不存在",
  "error_code": "JOB.POSITION.0001"
}
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.0001 职位不存在 请检查对应职位是否存在
Position does not exist
400 JOB.POSITION.0009 职位编码已存在 请修改为其他的职位编码
Position code already exists
400 JOB.POSITION.0016 当前职位存在关联用户不能修改所属组织 请先将此职位关联的用户取消关联再修改职位
The current position is associated with a user who cannot modify the organization they belong to
400 ORG.0001 组织不存在 请检查对应组织是否存在
Organization does not exist
400 JOB.TITLE.0001 职务不存在 请检查对应职务是否存在
Job title does not exist

删除职位