新增职务

接口限制：100次/秒/企业 3000次/分钟/企业

适用场景：新增职务信息

警告信息：1.职务的所属资源集合不能为空，且必须已存在
2.为防止并发请求导致重复数据，请求参数相同时，3秒内仅能请求一次，否则进行错误提示

tips：1.必填项：名称（Name）、编码（Code）、设立日期（EstablishDate）、所属资源集合（OIdResourceSet，资源集合OId）
2.生效日期默认为设立日期

错误码示例

{
"data": null,
"code": "417",
"message": "编码【apiTest3】与启用的职务【api测试3】重复"
}

curl --location --request POST 'https://openapi.italent.cn/TenantBaseExternal/api/v5/JobPost/Create' \ --header 'Content-Type: application/json' \ --data-raw '{ "data": { "name": "不匹配职务", "code": "1222", "establishDate": "2020-09-11T00:00:00", "oIdResourceSet": "9bfe7938-dc97-4844-ba24-0cfccac067bd", "oIdJobLevelType": "8d9c4b67-4100-42a9-9652-a1fb40cb4a99", "oIdJobLevel": "33d7d04b-3dec-4e13-9beb-c04c9b56487e", "highestOIdJobLevel": "33d7d04b-3dec-4e13-9beb-c04c9b56487e", "score": 5.0, "jobPostKey": "0", "jobPostSecret": "0", "jobRequirements": "测试任职要求", "oIdJobGradeLow": "2971cb20-0b4c-402f-bf57-ce545b1543a5", "oIdJobGradeHigh": "2971cb20-0b4c-402f-bf57-ce545b1543a5", "oIdJobSequence": "180", "oIdProfessionalLine": "2ecaab9b-bb4f-4394-9846-d1f5df682d04", "description": "测试职责描述", "customProperties": { "extbeizhua_127666_398499608": "这是一个备注字段" } } }'

请求参数

Body 参数application/json

data

object

可选

name

string

可选

名称，必填，示例：设计师

code

string

可选

编码，必填，示例：designer

establishDate

string <date-time> | null

可选

设立日期，必填且大于等于1900-01-01且小于等于9999-12-31，示例：2001-01-02

oIdResourceSet

string

可选

所属资源集合，必填，查看可用选项

oIdJobLevelType

string

可选

职级类别，查看可用选项

oIdTalentCriterion

string

可选

胜任力模型，Lookup字段，相关应用：人才标准，相关对象：人才标准示例：8785dd30-7b2d-4fce-8fd3-df0e4be79f46

oIdJobLevel

string

可选

最低职级，职级对象主键，示例：8785dd30-7b2d-4fce-8fd3-df0e4be79f46

highestOIdJobLevel

string

可选

最高职级，职级对象主键，示例：8785dd30-7b2d-4fce-8fd3-df0e4be79f46

score

number <float> | null

可选

评估总分，示例：3.4

jobPostKey

string

可选

关键职务，查看可用选项

jobPostSecret

string

可选

涉密职务，查看可用选项

jobRequirements

string

可选

任职要求，如精通ps

oIdJobGradeLow

string

可选

最低职等，查看可用选项

oIdJobGradeHigh

string

可选

最高职等，查看可用选项

oIdJobSequence

string

可选

职务序列，查看可用选项

oIdProfessionalLine

string

可选

专业条线，查看可用选项

name_zh_TW

string

可选

名称_繁体，示例：名稱示例

name_en_US

string

可选

名称_英文，示例：NameEnglish

description

string

可选

职责描述，示例：这是一个职责描述。

description_zh_TW

string

可选

职责描述_繁体，示例：这是一个职责描述。

description_en_US

string

可选

职责描述_英文，示例：这是一个职责描述。

optionalSysProperties

object

可选

非必填（可选）标准字段Key（字段编码）-Value（字段值）字典，暂不使用，仅预留方便后续扩展使用。(区分大小写，自动忽略自定义字段和不存在的字段)，若有同名属性，则优先使用属性值。示例：key=Remarks,value="可选标准字段"

customProperties

object

可选

租户级别自定义字段Key（字段编码）-Value（字段值）字典(区分大小写，自动忽略非自定义字段和不存在的字段)，示例：key=exthtxybeizhua_127666_1123139652,value="自定义字段"

示例

返回响应

🟢200响应结果

application/json

Body

data

object

可选

oId

string

可选

职务实体业务OId，如 2444

objectId

string

可选

职务实体主键GUID，如 7FA89C42-15E5-6001-9915-C418FD79C41F

code

string

可选

响应码（正常情况必须200）或异常错误编码（异常情况）：200-OK，417-参数异常、业务不合法，500-内部服务器异常。示例："200"

message

string

结果消息

可选

错误码示例#

请求参数

返回响应

错误码示例