新增职务

权限

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

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

请求说明

请求头

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

请求示例

{ 
    "name": "高级工程师",
    "code": "Senior_Engineer"
}

TIP

新增职务信息，Code全局唯一

请求参数

参数名	中文名称	必须	类型	描述
name	职务名称	是	String	职务名称
code	职务编码	是	String	职务编码，系统唯一

返回示例

成功示例

HTTP/1.1 201 Created

{ 
    "title_id": "20201028102749564-9082-DC8CD2722" 
}

错误示例

HTTP/1.1 400 Bad Request

{ 
    "error_code": "JOB.TITLE.0009", 
    "error_msg": "职务编码已存在" 
}

返回参数

参数名	中文名称	类型	描述
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.0009	职务编码已存在	Job title code already exists	请修改为其他的职务编码