部分更新职位

POST

/TenantBaseExternal/api/v5/Position/Update

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

适用场景：修改指定的职位信息

警告信息：1.若对应的职位不存在，则进行错误提示
2.必填项不支持清空：名称（Name）、编码（Code）、设立日期（EstablishDate）、所属组织（OIdOrganization，组织单元OId）

tips：1.支持部分更新，仅传入需要更新的字段即可
2.支持清空逻辑，指定字段传入null即可清空

错误码示例

{
"code": "417",
"message": "编码【Test0625A001】与启用的职位【Test0625A001】重复！"
}

请求参数

Body 参数application/json

示例

返回响应

🟢200响应结果

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://openapi.italent.cn/TenantBaseExternal/api/v5/Position/Update' \
--header 'Content-Type: application/json' \
--data-raw '//主键ID方式
{
  "data": {
        "objectId":"89cc6d6d-77e1-4eb9-8dc8-04709f4383af",
        "name": "PositionTest0712011",
        "code": "PositionTest0712011",
        "establishDate": "2021-07-01T00:00:00",
        "oIdOrganization": 4745267,
        "oIdJobPost": "2400",
        "oIdJobLevelType": "0a021c69-182e-4c85-aab8-bda0d80d656e",
        "oIdJobSequence": "180",
        "highestOIdJobLevel": "c56c867f-f716-4283-8b9b-9e2a2114af88",
        "description": "这是一个职位的职责描述",
        "place": "1100",
        "positionKey": "1",
        "positionSecret": "1",
        "order": 100,
        "score": 100.0,
        "jobRequirements": "35岁以下",
        "customProperties": {
            "extcuntomField_127666_1101051360":"测试自定义"
        },
    "emptyFields":["oIdProfessionalLine"] //清空指定字段值
  }
}

//业务OId方式
{
  "data": {
        "oId":"89cc6d6d-77e1-4eb9-8dc8-04709f4383af",
        "name": "PositionTest0712011",
        "code": "PositionTest0712011",
        "establishDate": "2021-07-01T00:00:00",
        "oIdOrganization": 4745267,
        "oIdJobPost": "2400",
        "oIdJobLevelType": "0a021c69-182e-4c85-aab8-bda0d80d656e",
        "oIdJobSequence": "180",
        "highestOIdJobLevel": "c56c867f-f716-4283-8b9b-9e2a2114af88",
        "description": "这是一个职位的职责描述",
        "place": "1100",
        "positionKey": "1",
        "positionSecret": "1",
        "order": 100,
        "score": 100.0,
        "jobRequirements": "35岁以下",
        "customProperties": {
            "extcuntomField_127666_1101051360":"测试自定义"
        },
    "emptyFields":["oIdProfessionalLine"] //清空指定字段值
  }
}'

响应示例

{
    "code": "string",
    "message": "string"
}

修改于 2021-10-13 10:54:24

根据时间窗滚动查询变动的职等信息

根据时间窗滚动查询变动的职位信息

部分更新职位

错误码示例#

请求参数

返回响应

错误码示例