飞书开放平台 Server API 文档

主题

更新人才 ​

用于在企业内更新一个人才。支持自定义字段数据，可配合获取人才字段 接口获取自定义字段信息使用。

注意事项 ​

请求参数中邮箱/电话字段请在「飞书招聘」-「设置」-「候选人信息管理」-「标准简历设置」中确认是否必填。

请求 ​

项目值
HTTP URLhttps://open.feishu.cn/open-apis/hire/v1/talents/combined_update
HTTP MethodPOST
接口频率限制1000 次/分钟、50 次/秒
支持的应用类型custom
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用hire:talent 更新人才信息
字段权限要求> Tip: 该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请 contact:user.employee_id:readonly 获取用户 user ID

请求头 ​

名称类型必填描述
Authorizationstring是tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
Content-Typestring是固定值："application/json; charset=utf-8"

查询参数 ​

名称类型必填描述
user_id_typestring否用户 ID 类型
示例值：open_id
可选值有：
- open_id: 标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。了解更多：如何获取 Open ID - union_id: 标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。了解更多：如何获取 Union ID？ - user_id: 标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。了解更多：如何获取 User ID？ - people_admin_id: 以people_admin_id来识别用户
默认值：open_id
当值为 user_id，字段权限要求： contact:user.employee_id:readonly 获取用户 user ID

请求体 ​

名称类型必填描述
talent_idstring是人才 ID，可通过获取人才列表接口获取
示例值："7158793341499426348"
init_source_idstring否简历来源 ID，可通过获取简历来源列表接口查询，已弃用，请使用 resume_source_id 字段
示例值："1"
folder_id_liststring\[\]否文件夹 ID 列表，可通过获取人才文件夹列表接口获取
示例值：["702551782317613290"]
数据校验规则：
- 最大长度：100
operator_idstring否更新人 ID，与入参 user_id_type 类型一致
示例值："ou_84aad35d084aa403a838cf73ee18467"
operator_account_typeint否更新人类型
示例值：1
可选值有：
- 1: 员工 - 3: 系统
resume_attachment_idstring否简历附件 ID，如何创建附件请参考创建附件；请注意：本接口仅会给人才增加一个附件简历，不会解析附件简历中的内容并更新人才
示例值："7383906146040678700"
basic_infotalent_combined_basic_info是基本信息
  └ namestring否名字
示例值："张三"
  └ mobilestring否手机
示例值："182xxxx9190"
  └ mobile_country_codestring否手机国家代码，可通过查询地点列表接口获取
示例值："CN_1"
  └ emailstring否邮箱
示例值："16xx1@126.com"
  └ identificationtalent_identification_info否证件信息
    └ identification_typeint否证件类型
示例值：1
可选值有：
- 1: 中国 - 居民身份证 - 2: 护照 - 3: 中国 - 港澳居民居住证 - 4: 中国 - 台湾居民来往大陆通行证 - 5: 其他 - 6: 中国 - 港澳居民来往内地通行证 - 9: 中国 - 台湾居民居住证
    └ identification_numberstring否证件号
示例值："511699199x1x111234"
  └ start_work_timestring否开始工作时间，毫秒时间戳
示例值："1686832459000"
  └ birthdaystring否出生日期时间，毫秒时间戳
示例值："293016767159"
  └ genderint否性别
示例值：1
可选值有：
- 1: 男 - 2: 女 - 3: 其他
  └ nationality_idstring否国籍编码，可通过查询地点列表获取
示例值："CN_112"
  └ current_city_codestring否所在地点编码，可通过查询地点列表获取
示例值："CT_159"
  └ hometown_city_codestring否家乡编码，可通过查询地点列表获取
示例值："CT_159"
  └ customized_datatalent_customized_data_object_value\[\]否自定义字段列表
注意：children 字段无效，请参考请求体示例在当前层级传入 object_id 和 value
    └ object_idstring否自定义字段 ID，可通过获取人才字段 接口获取
示例值："6934193211960330504"
    └ childrentalent_customized_data_object_value_child\[\]否子字段列表
      └ object_idstring否自定义字段 ID，可通过获取人才字段 接口获取
示例值："6934193211960330504"
      └ valuestring否自定义字段值，请参考本文「自定义字段数据格式说明」
示例值："张三"
education_listtalent_combined_education_info\[\]否教育经历
注意：更新时会全量覆盖
数据校验规则：
- 最大长度：100
  └ idstring否教育经历 ID，无效字段，请勿使用
示例值："6891560630172518670"
  └ degreeint否学历
示例值：1
可选值有：
- 1: 小学 - 2: 初中 - 3: 专职 - 4: 高中 - 5: 大专 - 6: 本科 - 7: 硕士 - 8: 博士 - 9: 其他
  └ schoolstring否学校
示例值："香港大学"
  └ field_of_studystring否专业
示例值："考古"
  └ start_timestring否教育经历开始时间，毫秒时间戳
示例值："293016767159"
  └ end_timestring否教育经历结束时间，毫秒时间戳
示例值："293016767159"
  └ education_typeint否学历类型
示例值：1
可选值有：
- 1: 海外及港台 - 2: 统招全日制 - 3: 非全日制 - 4: 自考 - 5: 其他
  └ academic_rankingint否成绩排名
示例值：5
可选值有：
- 5: 前 5 % - 10: 前 10 % - 20: 前 20 % - 30: 前 30 % - 50: 前 50 % - -1: 其他
  └ customized_datatalent_customized_data_object_value\[\]否自定义字段列表
注意：children 字段无效，请参考请求体示例在当前层级传入 object_id 和 value
    └ object_idstring否自定义字段 ID，可通过获取人才字段 接口获取
示例值："6934193211960330504"
    └ childrentalent_customized_data_object_value_child\[\]否子字段列表
      └ object_idstring否自定义字段 ID，可通过获取人才字段 接口获取
示例值："6934193211960330504"
      └ valuestring否自定义字段值，请参考本文「自定义字段数据格式说明」
示例值："张三"
career_listtalent_combined_career_info\[\]否工作经历
注意：更新时会全量覆盖
数据校验规则：
- 最大长度：100
  └ idstring否工作经历 ID，无效字段，请勿使用
示例值："6891560630172518670"
  └ companystring否公司名称
示例值："明日科技公司"
  └ titlestring否职位名称
示例值："高级工程师"
  └ descstring否工作经历描述
示例值："测试"
  └ start_timestring否工作经历开始时间，毫秒时间戳
示例值："293016767159"
  └ end_timestring否工作经历结束时间，毫秒时间戳
示例值："293016767159"
  └ career_typeint否工作经历类型
示例值：1
可选值有：
- 1: 实习经历 - 2: 工作经历
  └ customized_datatalent_customized_data_object_value\[\]否自定义字段列表
注意：children 字段无效，请参考请求体示例在当前层级传入 object_id 和 value
    └ object_idstring否自定义字段 ID，可通过获取人才字段 接口获取
示例值："6934193211960330504"
    └ childrentalent_customized_data_object_value_child\[\]否子字段列表
      └ object_idstring否自定义字段 ID，可通过获取人才字段 接口获取
示例值："6934193211960330504"
      └ valuestring否自定义字段值，请参考本文「自定义字段数据格式说明」
示例值："张三"
project_listtalent_combined_project_info\[\]否项目经历
注意：更新时会全量覆盖
数据校验规则：
- 最大长度：100
  └ idstring否项目经历 ID，无效字段，请勿使用
示例值："6891560630172518670"
  └ namestring否项目名称
示例值："系统稳定性提升项目"
  └ rolestring否项目角色
示例值："研发人员"
  └ linkstring否项目链接
示例值："https://www.a.com"
  └ descstring否项目描述
示例值："该项目目标是提升整个系统的稳定性，达到行业一流水准。"
  └ start_timestring否项目开始时间，毫秒时间戳
示例值："293016767159"
  └ end_timestring否项目结束时间，毫秒时间戳
示例值："293016767159"
  └ customized_datatalent_customized_data_object_value\[\]否自定义字段列表
注意：children 字段无效，请参考请求体示例在当前层级传入 object_id 和 value
    └ object_idstring否自定义字段 ID，可通过获取人才字段 接口获取
示例值："6934193211960330504"
    └ childrentalent_customized_data_object_value_child\[\]否子字段列表
      └ object_idstring否自定义字段 ID，可通过获取人才字段 接口获取
示例值："6934193211960330504"
      └ valuestring否自定义字段值，请参考本文「自定义字段数据格式说明」
示例值："张三"
works_listtalent_combined_work_info\[\]否作品
注意：更新时会全量覆盖
数据校验规则：
- 最大长度：100
  └ idstring否作品 ID，无效字段，请勿使用
示例值："6891560630172518670"
  └ linkstring否作品链接
示例值："https://www.a.com"
  └ descstring否作品描述
示例值："个人设计作品"
  └ attachment_idstring否作品附件 ID
示例值："12345678"
  └ customized_datatalent_customized_data_object_value\[\]否自定义字段列表
注意：children 字段无效，请参考请求体示例在当前层级传入 object_id 和 value
    └ object_idstring否自定义字段 ID，可通过获取人才字段 接口获取
示例值："6934193211960330504"
    └ childrentalent_customized_data_object_value_child\[\]否子字段列表
      └ object_idstring否自定义字段 ID，可通过获取人才字段 接口获取
示例值："6934193211960330504"
      └ valuestring否自定义字段值，请参考本文「自定义字段数据格式说明」
示例值："张三"
award_listtalent_combined_award_info\[\]否获奖
注意：更新时会全量覆盖
数据校验规则：
- 最大长度：100
  └ idstring否获奖 ID，无效字段，请勿使用
示例值："6891560630172518670"
  └ titlestring否获奖名称
示例值："最佳新人奖"
  └ award_timestring否获奖时间，毫秒时间戳
示例值："293016767159"
  └ descstring否获奖描述
示例值："最优秀的新人奖"
  └ customized_datatalent_customized_data_object_value\[\]否自定义字段列表
注意：children 字段无效，请参考请求体示例在当前层级传入 object_id 和 value
    └ object_idstring否自定义字段 ID，可通过获取人才字段 接口获取
示例值："6934193211960330504"
    └ childrentalent_customized_data_object_value_child\[\]否子字段列表
      └ object_idstring否自定义字段 ID，可通过获取人才字段 接口获取
示例值："6934193211960330504"
      └ valuestring否自定义字段值，请参考本文「自定义字段数据格式说明」
示例值："张三"
language_listtalent_combined_language_info\[\]否语言能力
注意：更新时会全量覆盖
数据校验规则：
- 最大长度：100
  └ idstring否语言能力 ID，无效字段，请勿使用
示例值："6891560630172518670"
  └ languageint否语言类型
示例值：1
可选值有：
- 1: 英语 - 2: 法语 - 3: 日语 - 4: 韩语 - 5: 德语 - 6: 俄语 - 7: 西班牙语 - 8: 葡萄牙语 - 9: 阿拉伯语 - 10: 印地语 - 11: 印度斯坦语 - 12: 孟加拉语 - 13: 豪萨语 - 14: 旁遮普语 - 15: 波斯语 - 16: 斯瓦西里语 - 17: 泰卢固语 - 18: 土耳其语 - 19: 意大利语 - 20: 爪哇语 - 21: 泰米尔语 - 22: 马拉地语 - 23: 越南语 - 24: 普通话 - 25: 粤语 - 26: 印尼语 - 27: 马来语 - 28: 泰语 - 29: 塞尔维亚语
  └ proficiencyint否语言精通程度
示例值：1
可选值有：
- 1: 入门 - 2: 日常会话 - 3: 商务会话 - 4: 无障碍沟通 - 5: 母语
  └ customized_datatalent_customized_data_object_value\[\]否自定义字段列表
注意：children 字段无效，请参考请求体示例在当前层级传入 object_id 和 value
    └ object_idstring否自定义字段 ID，可通过获取人才字段 接口获取
示例值："6934193211960330504"
    └ childrentalent_customized_data_object_value_child\[\]否子字段列表
      └ object_idstring否自定义字段 ID，可通过获取人才字段 接口获取
示例值："6934193211960330504"
      └ valuestring否自定义字段值，请参考本文「自定义字段数据格式说明」
示例值："张三"
sns_listtalent_combined_sns_info\[\]否社交账号
注意：更新时会全量覆盖
数据校验规则：
- 最大长度：100
  └ idstring否社交账号 ID，无效字段，请勿使用
示例值："6891560630172518670"
  └ sns_typeint否社交平台
示例值：1
可选值有：
- 1: 领英 - 2: 脉脉 - 3: 微信 - 4: 微博 - 5: Github - 6: 知乎 - 7: 脸书 - 8: 推特 - 9: Whatsapp - 10: 个人网站 - 11: QQ
  └ linkstring否URL/ID
示例值："https://www.a.com"
  └ customized_datatalent_customized_data_object_value\[\]否自定义字段列表
注意：children 字段无效，请参考请求体示例在当前层级传入 object_id 和 value
    └ object_idstring否自定义字段 ID，可通过获取人才字段 接口获取
示例值："6934193211960330504"
    └ childrentalent_customized_data_object_value_child\[\]否子字段列表
      └ object_idstring否自定义字段 ID，可通过获取人才字段 接口获取
示例值："6934193211960330504"
      └ valuestring否自定义字段值，请参考本文「自定义字段数据格式说明」
示例值："张三"
preferred_city_code_liststring\[\]否意向地点，可通过查询地点列表接口获取
示例值：["CT_1"]
数据校验规则：
- 最大长度：100
self_evaluationtalent_self_evaluation否自我评价
  └ idstring否自我评价 ID，无效字段，请勿使用
示例值："6891560630172518670"
  └ contentstring否自我评价内容
示例值："自我评价：平常心"
  └ customized_datatalent_customized_data_object_value\[\]否自定义字段列表
注意：children 字段无效，请参考请求体示例在当前层级传入 object_id 和 value
    └ object_idstring否自定义字段 ID，可通过获取人才字段 接口获取
示例值："6934193211960330504"
    └ childrentalent_customized_data_object_value_child\[\]否子字段列表
      └ object_idstring否自定义字段 ID，可通过获取人才字段 接口获取
示例值："6934193211960330504"
      └ valuestring否自定义字段值，请参考本文「自定义字段数据格式说明」
示例值："张三"
customized_datatalent_customized_data_object_value\[\]否自定义模块列表
注意： - children 字段为二维数组，请参考请求体示例 - 更新时会全量覆盖
  └ object_idstring否自定义模块 ID，可通过获取人才字段 接口获取
示例值："6934193211960330504"
  └ childrentalent_customized_data_object_value_child\[\]否子字段列表
    └ object_idstring否自定义字段 ID，可通过获取人才字段 接口获取
示例值："6934193211960330504"
    └ valuestring否自定义字段值，请参考本文「自定义字段数据格式说明」
示例值："张三"

自定义字段数据格式说明 ​

  • 单选："1"
  • 多选："[\"1\", \"2\"]"
  • 单行："单行文本"
  • 多行："多行文本"
  • 数字："1"
  • 月份选择："1627379423000"
  • 年份选择："1627379423000"
  • 日期选择："1627379423000"
  • 附件："[{\"file_id\": \"7250161881116838204\"},{\"file_id\": \"7250161808660826429\"}]"
  • 时间段："[\"1577808000000\", \"1612108800000\"]"

请求体示例 ​

json
{
    "talent_id": "7158793341499426348",
    "init_source_id": "1",
    "folder_id_list": [
        "702551782317613290"
    ],
    "operator_id": "ou_84aad35d084aa403a838cf73ee18467",
    "operator_account_type": 1,
    "resume_attachment_id": "7383906146040678700",
    "basic_info": {
        "name": "张三",
        "mobile": "182900291190",
        "mobile_country_code": "CN_1",
        "email": "16xx1@126.com",
        "identification": {
            "identification_type": 1,
            "identification_number": "511699199x1x111234"
        },
        "start_work_time": "293016767159",
        "birthday": "293016767159",
        "gender": 1,
        "nationality_id": "CN_112",
        "current_city_code": "CT_159",
        "hometown_city_code": "CT_159",
        "customized_data": [
            {
                "object_id": "6934193211960330504",
                "value": "已婚"
            }
        ]
    },
    "education_list": [
        {
            "degree": 1,
            "school": "香港大学",
            "field_of_study": "考古",
            "start_time": "293016767159",
            "end_time": "293016767159",
            "education_type": 1,
            "academic_ranking": 5,
            "customized_data": [
                {
                    "object_id": "6934193211960330505",
                    "value": "C9"
                }
            ]
        }
    ],
    "career_list": [
        {
            "company": "明日科技公司",
            "title": "高级工程师",
            "desc": "测试",
            "start_time": "293016767159",
            "end_time": "293016767159",
            "career_type": 1,
            "customized_data": [
                {
                    "object_id": "6934193211960330506",
                    "value": "[\"1577808000000\", \"1612108800000\"]"
                }
            ]
        }
    ],
    "project_list": [
        {
            "name": "系统稳定性提升项目",
            "role": "研发人员",
            "link": "https://www.a.com",
            "desc": "该项目目标是提升整个系统的稳定性，达到行业一流水准。",
            "start_time": "293016767159",
            "end_time": "293016767159",
            "customized_data": [
                {
                    "object_id": "6934193211960330507",
                    "value": "1627379423000"
                }
            ]
        }
    ],
    "works_list": [
        {
            "link": "https://www.a.com",
            "desc": "个人设计作品",
            "attachment_id": "12345678",
            "customized_data": [
                {
                    "object_id": "6934193211960330508",
                    "value": "1627379423000"
                }
            ]
        }
    ],
    "award_list": [
        {
            "title": "最佳新人奖",
            "award_time": "293016767159",
            "desc": "最优秀的新人奖",
            "customized_data": [
                {
                    "object_id": "6934193211960330509",
                    "value": "奖项含金量很高"
                }
            ]
        }
    ],
    "language_list": [
        {
            "language": 1,
            "proficiency": 1,
            "customized_data": [
                {
                    "object_id": "6934193211960330510",
                    "value": "3"
                }
            ]
        }
    ],
    "sns_list": [
        {
            "sns_type": 1,
            "link": "https://www.a.com",
            "customized_data": [
                {
                    "object_id": "6934193211960330511",
                    "value": "常用的社交账号"
                }
            ]
        }
    ],
    "preferred_city_code_list": [
        "CT_2"
    ],
    "self_evaluation": {
        "content": "自我评价：平常心",
        "customized_data": [
            {
                "object_id": "6934193211960330512",
                "value": "1"
            }
        ]
    },
    "customized_data": [
        {
            "object_id": "6934193211960330504",
            "children": [
                [
                    {
                        "object_id": "6934193211960330513",
                        "value": "[\"1\", \"2\"]"
                    }
                ]
            ]
        }
    ]
}

响应 ​

响应体 ​

名称类型描述
codeint错误码，非 0 表示失败
msgstring错误描述
data\--
  └ talent_idstring人才 ID
  └ operator_idstring更新人 ID，与入参 user_id_type 类型一致
  └ operator_account_typeint更新人类型
可选值有：
- 1: 员工 - 3: 系统

响应体示例 ​

json
{
    "code": 0,
    "msg": "ok",
    "data": {
        "talent_id": "7021471300428613932",
        "operator_id": "ou_84aad35d084aa403a838cf73ee18467",
        "operator_account_type": 1
    }
}

错误码 ​

HTTP状态码错误码描述排查建议
5001002001System error请根据实际报错信息定位或咨询技术支持
4001002002Parameter error检查参数是否正确，例如类型，大小
4001002102talent not exists人才 ID 不合法，请检查入参 talent_id 是否通过获取人才列表接口获取或格式是否符合字符串要求

更多错误码信息，参见通用错误码。

内容来源：飞书开放平台 · 自动爬取整理

本镜像仅供学习与查阅，文档版权归飞书所有