修改职务
权限
身份管理API是以应用维度授权的，在调用接口前需为不同的应用设置接口权限，详情请参考API权限。
| 权限代码 | 描述 |
|---|---|
| job_title_all | 职务管理接口的读写权限 |
| all | 全部接口读写权限 |
请求说明
请求头
| 参数名 | 中文名称 | 必须 | 类型 | 描述 |
|---|---|---|---|---|
| Authorization | 授权 | 是 | String | 格式：Bearer {access_token} |
| Content-Type | 内容类型 | 是 | String | 固定值：application/json; charset=utf-8 |
请求示例
json
{
"name": "高级工程师",
"code": "Senior_Engineer"
}TIP
根据请求的职务ID参数更新职务信息。
请求参数
| 参数名 | 中文名称 | 必须 | 类型 | 描述 |
|---|---|---|---|---|
| title_id | 职务id | 是 | String | 要修改的职务ID |
| name | 职务名称 | 是 | String | 职务名称 |
| code | 职务编码 | 是 | String | 职务编码，系统唯一 |
返回示例
成功示例
HTTP/1.1 200 OK
json
{
"title_id": "20201028102749564-9082-DC8CD2722"
}错误示例
HTTP/1.1 400 Bad Request
json
{
"error_msg": "职务不存在",
"error_code": "JOB.TITLE.0001"
}返回参数
| 参数名 | 中文名称 | 类型 | 描述 |
|---|---|---|---|
| title_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.TITLE.0001 | 职务不存在 | Job title does not exist | 请检查对应职务是否存在 |
| 400 | JOB.TITLE.0009 | 职务编码已存在 | Job title code already exists | 请修改为其他的职务编码 |