操作人才标签

可为人才新增、删除标签。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/hire/v1/talents/:talent_id/tag
HTTP Method	POST
接口频率限制	20 次/秒
支持的应用类型	custom
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用	hire:talent 更新人才信息

请求头

名称	类型	必填	描述
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获取 示例值："6960663240925956661"

请求体

名称	类型	必填	描述
operation	int	是	操作类型 示例值：1 可选值有： - 1: 新增 - 2: 删除
tag_id_list	string\[\]	是	标签 ID 列表，可通过以下接口获取获取人才标签信息列表 示例值：["6960663240925956661"]

请求体示例

{
    "operation": 1,
    "tag_id_list": [
        "6960663240925956661"
    ]
}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-

响应体示例

{
    "code": 0,
    "msg": "ok",
    "data": {}
}

错误码

HTTP状态码	错误码	描述	排查建议
500	1002001	系统错误	请根据实际报错信息定位或咨询客服
400	1002002	参数错误	检查参数是否正确，例如类型，大小
400	1002111	标签 ID 错误	检查标签 ID 参数 tag_id_list 是否正确
400	1002112	标签未启用	启用标签后重试
400	1002113	人才上已存在此标签	参数 tag_id_list 中移除已存在标签后重试
400	1002114	人才上不存在此标签	参数 tag_id_list 中移除不存在标签后重试