飞书开放平台 Server API 文档

主题

获取人才列表 ​

批量获取人才摘要信息，包括人才 ID、人才基信息、教育经历、工作经历等。若需要获取人才详细信息请使用获取人才详情接口。

请求 ​

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

请求头 ​

名称类型必填描述
Authorizationstring是tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token

查询参数 ​

名称类型必填描述
keywordstring否搜索关键词，支持布尔语言（使用 and、or、not 连接关键词）
示例值：张三 and 产品经理
update_start_timestring否最早更新时间，毫秒时间戳
示例值：1618500278663
update_end_timestring否最晚更新时间，毫秒时间戳
示例值：1618500278663
page_sizeint否分页大小
示例值：10
默认值：10
数据校验规则：
- 最大值：20
sort_byint否排序规则
示例值：1
可选值有：
- 1: 按更新日期降序 - 2: 按相关度降序 - 3: 按投递时间降序 - 4: 按入库时间降序
默认值：1
page_tokenstring否分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果
示例值：eyJvZmZzZXQiOjEwLCJ0aW1lc3RhbXAiOjE2Mjc1NTUyMjM2NzIsImlkIjpudWxsfQ==
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 来识别用户
默认值：people_admin_id
当值为 user_id，字段权限要求： contact:user.employee_id:readonly 获取用户 user ID
query_optionstring否请求控制参数
示例值：ignore_empty_error
可选值有：
- ignore_empty_error: 忽略结果为空时的报错

响应 ​

响应体 ​

名称类型描述
codeint错误码，非 0 表示失败
msgstring错误描述
data\--
  └ has_moreboolean是否还有更多项
  └ page_tokenstring分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token
  └ itemstalent\[\]人才摘要信息列表
    └ idstring人才 ID，详情可查看：获取人才详情
    └ is_in_agency_periodboolean是否在猎头保护期
可选值有：
- false: 未在猎头保护期 - true: 在猎头保护期
    └ is_onboardedboolean是否已入职
可选值有：
- false: 未入职 - true: 已入职
    └ basic_infotalent_basic_info基本信息
      └ namestring姓名
      └ mobilestring手机
      └ mobile_codestring手机国家区号，遵守国际统一标准，请参考百度百科-国际长途电话区号
      └ mobile_country_codestring手机国家代码，详情请查看：查询地点列表
      └ emailstring邮箱
      └ experience_yearsint工作年限
      └ ageint年龄
      └ nationalitytalent_nationality国籍（地区）
        └ nationality_codestring国家编码，详情请查看：查询地点列表
        └ zh_namestring国籍（地区）中文名
        └ en_namestring国籍（地区）英文名
      └ genderint性别
可选值有：
- 1: 男 - 2: 女 - 3: 其他
      └ current_citytalent_city_info所在地点
        └ city_codestring城市码，详情请查看：查询地点列表
        └ zh_namestring地点中文名
        └ en_namestring地点英文名
      └ hometown_citytalent_city_info家乡
        └ city_codestring城市码，详情请查看：查询地点列表
        └ zh_namestring地点中文名
        └ en_namestring地点英文名
      └ preferred_city_listtalent_city_info\[\]期望工作地点
        └ city_codestring城市码，详情请查看：查询地点列表
        └ zh_namestring地点中文名
        └ en_namestring地点英文名
      └ identification_typeint个人证件类型
可选值有：
- 1: 中国 - 居民身份证 - 2: 护照 - 3: 中国 - 港澳居民居住证 - 4: 中国 - 台湾居民来往大陆通行证 - 5: 其他 - 6: 中国 - 港澳居民来往内地通行证 - 9: 中国 - 台湾居民居住证
      └ identification_numberstring个人证件号
      └ birthdayint出生日期，秒时间戳
      └ creator_idstring创建人 ID，与入参 user_id_type 类型一致
      └ marital_statusint婚姻状况
可选值有：
- 1: 已婚 - 2: 未婚
      └ current_home_addressstring家庭住址
      └ modify_timestring修改时间，毫秒时间戳
    └ education_listtalent_education_info\[\]教育经历
      └ idstring教育经历 ID
      └ degreeint学位
可选值有：
- 1: 小学 - 2: 初中 - 3: 专职 - 4: 高中 - 5: 大专 - 6: 本科 - 7: 硕士 - 8: 博士 - 9: 其他
      └ schoolstring学校名称
      └ field_of_studystring专业
      └ start_timestring教育经历的起始日期，精确到月份
      └ end_timestring教育经历的结束时间，精确到月份
      └ end_time_v2string结束时间-新，无「至今」传值。建议使用此字段，避免模糊的毕业时间影响候选人筛选
      └ education_typeint学历类型
可选值有：
- 1: 海外及港台 - 2: 统招全日制 - 3: 非全日制 - 4: 自考 - 5: 其他
      └ academic_rankingint成绩排名
可选值有：
- 5: 前 5 % - 10: 前 10 % - 20: 前 20 % - 30: 前 30 % - 50: 前 50 % - -1: 其他
      └ tag_listint\[\]教育经历标签
可选值有：
- 1: 985学校 - 2: 211学校 - 3: 一本 - 4: 国外院校QS200
    └ career_listtalent_career_info\[\]工作经历
      └ idstring工作经历 ID
      └ companystring公司名称
      └ titlestring职位名称
      └ descstring工作经历描述
      └ start_timestring工作经历的开始日期，精确到月份
      └ end_timestring工作经历的结束日期，精确到月份
      └ career_typeint经历类型
可选值有：
- 1: 实习经历 - 2: 工作经历 - 3: 兼职经历 - 4: 其他经历
      └ tag_listint\[\]工作经历标签
可选值有：
- 5: 百度/阿里/腾讯 - 6: 头条/美团/滴滴 - 14: 互联网 100 强
    └ project_listtalent_project_info\[\]项目经历
      └ idstring项目经历 ID
      └ namestring项目名称
      └ rolestring项目角色
      └ linkstring项目链接
      └ descstring项目描述
      └ start_timestring项目的开始日期，精确到月份
      └ end_timestring项目的结束日期，精确到月份
    └ works_listtalent_works_info\[\]作品
      └ idstring作品 ID，可通过获取附件信息获取作品附件信息
      └ linkstring作品链接
      └ descstring作品描述
      └ namestring作品附件名称
    └ award_listtalent_award_info\[\]获奖
      └ idstring获奖 ID
      └ titlestring获奖名称
      └ award_timestring获奖日期，精确到年份
      └ descstring获奖描述
    └ language_listtalent_language_info\[\]语言能力
      └ idstring语言能力 ID
      └ languageint语言
可选值有：
- 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: 粤语
      └ proficiencyint精通程度
可选值有：
- 1: 入门 - 2: 日常会话 - 3: 商务会话 - 4: 无障碍沟通 - 5: 母语
    └ sns_listtalent_sns_info\[\]社交账号
      └ idstring社交账号 ID
      └ sns_typeintSNS 名称
可选值有：
- 1: 领英 - 2: 脉脉 - 3: 微信 - 4: 微博 - 5: Github - 6: 知乎 - 7: 脸书 - 8: 推特 - 9: Whatsapp - 10: 个人网站 - 11: QQ
      └ linkstringURL/ID
    └ resume_source_listtalent_resume_source\[\]简历来源
      └ idstring简历来源 ID，详情请查看：获取简历来源列表
      └ zh_namestring简历来源中文名
      └ en_namestring简历来源英文名
    └ interview_registration_listtalent_interview_registration_simple\[\]面试登记表
      └ idstring面试登记表 ID，详情可查看：获取面试登记表模板列表
      └ registration_timeint面试登记表创建时间，毫秒时间戳
    └ resume_attachment_id_liststring\[\]简历附件 ID 列表（按照简历创建时间降序），详情请查看：获取附件信息
    └ top_degreeint最高学历
可选值有：
- 1: 小学 - 2: 初中 - 3: 专职 - 4: 高中 - 5: 大专 - 6: 本科 - 7: 硕士 - 8: 博士 - 9: 其他
    └ first_degreeint第一学历
可选值有：
- 1: 低于大专 - 2: 大专 - 3: 本科 - 4: 硕士 - 5: 博士 - 6: 其他 - 7: 无

响应体示例 ​

json
{
    "code": 0,
    "msg": "ok",
    "data": {
        "has_more": true,
        "page_token": "eyJvZmZzZXQiOjEwLCJ0aW1lc3RhbXAiOjE2Mjc1NTUyMjM2NzIsImlkIjpudWxsfQ==",
        "items": [
            {
                "id": "6891560630172518670",
                "is_in_agency_period": true,
                "is_onboarded": true,
                "basic_info": {
                    "name": "张三",
                    "mobile": "182900291190",
                    "mobile_code": "86",
                    "mobile_country_code": "CN_1",
                    "email": "16xx1@126.com",
                    "experience_years": 5,
                    "age": 22,
                    "nationality": {
                        "nationality_code": "CN_1",
                        "zh_name": "中国",
                        "en_name": "China"
                    },
                    "gender": 1,
                    "current_city": {
                        "city_code": "CT_11",
                        "zh_name": "北京",
                        "en_name": "Beijing"
                    },
                    "hometown_city": {
                        "city_code": "CT_22",
                        "zh_name": "成都",
                        "en_name": "Chengdu"
                    },
                    "preferred_city_list": [
                        {
                            "city_code": "ST_47",
                            "zh_name": "上海",
                            "en_name": "Shanghai"
                        }
                    ],
                    "identification_type": 1,
                    "identification_number": "511699199x1x111234",
                    "birthday": 293016767159,
                    "creator_id": "ou_4c5ec7005d5e476175d5edfd3f1e5206",
                    "marital_status": 1,
                    "current_home_address": "南京路1号",
                    "modify_time": "1634801678103"
                },
                "education_list": [
                    {
                        "id": "6891560630172518670",
                        "degree": 1,
                        "school": "湘港大学",
                        "field_of_study": "考古",
                        "start_time": "1990-01",
                        "end_time": "1994-01",
                        "end_time_v2": "1687180087000",
                        "education_type": 1,
                        "academic_ranking": 5,
                        "tag_list": [
                            1
                        ]
                    }
                ],
                "career_list": [
                    {
                        "id": "6891560630172518670",
                        "company": "明日科技公司",
                        "title": "高级工程师",
                        "desc": "负责公司主页 UI 交互动画设计，行业领先水准",
                        "start_time": "1990-01",
                        "end_time": "1994-01",
                        "career_type": 1,
                        "tag_list": [
                            6
                        ]
                    }
                ],
                "project_list": [
                    {
                        "id": "6891560630172518670",
                        "name": "权限重构项目",
                        "role": "项目负责人",
                        "link": "www.recruitment-demo.com",
                        "desc": "将系统的权限模块进行重构，支持更加灵活的权限控制能力。",
                        "start_time": "1990-01",
                        "end_time": "1991-01"
                    }
                ],
                "works_list": [
                    {
                        "id": "6891560630172518670",
                        "link": "www.test.com",
                        "desc": "全国 UI 设计大赛一等奖",
                        "name": "全国 UI 设计大赛"
                    }
                ],
                "award_list": [
                    {
                        "id": "6891560630172518670",
                        "title": "最佳新人奖",
                        "award_time": "1991",
                        "desc": "最优秀的新人奖"
                    }
                ],
                "language_list": [
                    {
                        "id": "6891560630172518670",
                        "language": 1,
                        "proficiency": 1
                    }
                ],
                "sns_list": [
                    {
                        "id": "6891560630172518670",
                        "sns_type": 1,
                        "link": "www.test.com"
                    }
                ],
                "resume_source_list": [
                    {
                        "id": "6891560630172518670",
                        "zh_name": "猎头",
                        "en_name": "Hunter"
                    }
                ],
                "interview_registration_list": [
                    {
                        "id": "6833685612520950030",
                        "registration_time": 1618494330932
                    }
                ],
                "resume_attachment_id_list": [
                    "64352523512563462"
                ],
                "top_degree": 1,
                "first_degree": 3
            }
        ]
    }
}

错误码 ​

HTTP状态码错误码描述排查建议
5001002001系统错误请根据实际报错信息定位或咨询技术支持
4001002002参数错误检查参数是否正确，例如类型，大小

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

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

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