查询人才猎头保护期信息

查询指定人才的猎头保护期信息列表，包含保护期起止时间、猎头供应商、猎头顾问信息等。若人才已经入职，还会返回入职时所在的保护期信息。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/hire/v1/agencies/protection_period/search
HTTP Method	POST
接口频率限制	10 次/秒
支持的应用类型	custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可	hire:agency:readonly 获取招聘猎头信息 hire:agency 更新招聘猎头信息

请求头

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

请求体

名称	类型	必填	描述
talent_id	string	是	人才 ID，可通过通过手机号或邮箱获取人才 ID、获取人才列表接口获取 示例值："6930815272790114324"

请求体示例

{
    "talent_id": "6930815272790114324"
}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ is_onboarded	boolean	是否已入职
└ onboarded_in_protection	boolean	是否在猎头保护期内入职
└ onboarded_protection	agency_protection	入职时所在保护期，当且仅当is_onboarded = true && onboarded_in_protection = true时，该字段有值
└ protection_type	int	保护期类型 可选值有： - 1: 人才保护期 - 2: 职位保护期
└ application_id	string	如保护期类型为 职位保护期（2）时，返回职位保护所在的投递 ID，详情请参考：获取投递信息
└ start_time	string	保护期开始时间，毫秒时间戳
└ expire_time	string	保护期过期时间，毫秒时间戳
└ agency_supplier_id	string	猎头供应商 ID，详情请参考：获取猎头供应商信息
└ agency_supplier_name	i18n	猎头供应商名称
└ zh_cn	string	中文名称
└ en_us	string	英文名称
└ agency_supplier_user_id	string	猎头顾问 ID，与user_id_type类型一致。 注意：由于猎头顾问位于猎头供应商租户，不在本接口调用方租户里，若需获取猎头信息，需切换租户至猎头供应商租户后通过获取单个用户信息访问猎头顾问详情
└ agency_supplier_user_name	i18n	猎头顾问名称
└ zh_cn	string	中文名称
└ en_us	string	英文名称
└ protection_list	agency_protection\[\]	保护期列表，若返回空，则表明人才上没有任何的保护期
└ protection_type	int	保护期类型 可选值有： - 1: 人才保护期 - 2: 职位保护期
└ application_id	string	如保护期类型为 职位保护期（2）时，返回职位保护所在的投递 ID，详情请参考：获取投递信息
└ start_time	string	保护期开始时间，毫秒时间戳
└ expire_time	string	保护期过期时间，毫秒时间戳
└ agency_supplier_id	string	猎头供应商 ID，详情请参考：获取猎头供应商信息
└ agency_supplier_name	i18n	猎头供应商名称
└ zh_cn	string	中文名称
└ en_us	string	英文名称
└ agency_supplier_user_id	string	猎头顾问 ID，与user_id_type类型一致。 注意：由于猎头顾问位于猎头供应商租户，不在本接口调用方租户里，若需获取猎头信息，需切换租户至猎头供应商租户后通过获取单个用户信息访问猎头顾问详情
└ agency_supplier_user_name	i18n	猎头顾问名称
└ zh_cn	string	中文名称
└ en_us	string	英文名称

响应体示例

{
    "code": 0,
    "msg": "ok",
    "data": {
        "is_onboarded": false,
        "onboarded_in_protection": false,
        "onboarded_protection": {
            "protection_type": 1,
            "application_id": "6930815272790114323",
            "start_time": "1700023694629",
            "expire_time": "1700023694630",
            "agency_supplier_id": "6930815272790114324",
            "agency_supplier_name": {
                "zh_cn": "超越猎头公司",
                "en_us": "chaoyue head-hunting company"
            },
            "agency_supplier_user_id": "6930815272790114324",
            "agency_supplier_user_name": {
                "zh_cn": "张三",
                "en_us": "zhangsan"
            }
        },
        "protection_list": [
            {
                "protection_type": 1,
                "application_id": "6930815272790114323",
                "start_time": "1700023694629",
                "expire_time": "1700023694630",
                "agency_supplier_id": "6930815272790114324",
                "agency_supplier_name": {
                    "zh_cn": "超越猎头公司",
                    "en_us": "chaoyue head-hunting company"
                },
                "agency_supplier_user_id": "6930815272790114324",
                "agency_supplier_user_name": {
                    "zh_cn": "张三",
                    "en_us": "zhangsan"
                }
            }
        ]
    }
}

错误码

HTTP状态码	错误码	描述	排查建议
500	1002001	系统错误	请根据实际报错信息定位或咨询技术支持
400	1002002	参数错误	请检查参数talent_id