批量获取人才ID

通过手机号、邮箱、证件号，批量查询人才ID

Warning: - 入参的手机号、邮箱、证件号至少需要传一种，否则无法查询到人才数据

• 入参的手机号、邮箱、证件号是AND的逻辑关系。也就是当条件同时满足时才会返回人才数据。

请求

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

请求头

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

请求体

名称	类型	必填	描述
mobile_code	string	否	国际区号，遵守国际统一标准，请参考百度百科-国际长途电话区号。传入手机号但没传区号的情况下，默认为中国大陆区号："86" 示例值："86"
mobile_number_list	string\[\]	否	手机号列表 示例值：["182900291190"]
email_list	string\[\]	否	邮箱列表 示例值：["foo@bytedance.com"]
identification_type	int	否	证件类型，枚举定义详见文档：枚举常量介绍 的 IdentificationType。传入证件号的情况下必须传入该参数 示例值：1
identification_number_list	string\[\]	否	证件号列表 示例值：["510403xxxxxxxx"]

请求体示例

{
    "mobile_code": "86",
    "mobile_number_list": [
        "182900291190"
    ],
    "email_list": [
        "foo@bytedance.com"
    ],
    "identification_type": 1,
    "identification_number_list": [
        "510403xxxxxxxx"
    ]
}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ talent_list	talent_batch_info\[\]	人才信息列表
└ talent_id	string	人才 ID，详情请查看：获取人才信息
└ mobile_code	string	国际区号，遵守国际统一标准，请参考百度百科-国际长途电话区号，仅当入参传入mobile_number_list 时返回
└ mobile_number	string	手机号，仅当入参传入mobile_number_list时返回
└ email	string	邮箱，仅当入参传入email_list 时返回
└ identification_type	int	证件类型，枚举定义详见文档：枚举常量介绍 的 IdentificationType，仅当入参传入identification_number_list 时返回
└ identification_number	string	证件号，仅当入参传入identification_number_list 时返回
└ is_onboarded	boolean	是否已入职 可选值有： - false: 未入职 - true: 已入职 字段权限要求： hire:talent_onboard_status:readonly 获取人才入职状态

响应体示例

{
    "code": 0,
    "msg": "ok",
    "data": {
        "talent_list": [
            {
                "talent_id": "6891560630172518670",
                "mobile_code": "86",
                "mobile_number": "182900291190",
                "email": "foo@bytedance.com",
                "identification_type": 1,
                "identification_number": "510403xxxxxxxx",
                "is_onboarded": true
            }
        ]
    }
}

错误码

HTTP状态码	错误码	描述	排查建议
200	1002001	系统错误	请根据实际报错信息定位或咨询技术支持
400	1002009	手机号不正确	请检查入参mobile_code 或mobile_number_list 是否正确