招聘候选人 · 人才与人才库接口

本页是招聘候选人接口（租户令牌）的续篇，可结合前文一起阅读。

创建人才备注

为人才创建备注信息，支持在备注中 @ 其他用户。限频：20 次/秒。所需权限：hire:note（更新招聘备注）。字段权限：contact:user.employee_id:readonly（返回的用户 ID 字段）。

函数签名：

csharp

Task<FeishuApiResult<CreateNoteResult>?> CreateNoteAsync(
    [Body] CreateNoteRequest request,
    [Query("user_id_type")] string? user_id_type = null,
    CancellationToken cancellationToken = default);

认证：租户令牌

参数：

参数名	类型	必填	说明
`request`	`CreateNoteRequest`	✅	创建请求体（talent_id、content 必填；application_id、creator_id、privacy 私密属性（1-私密/2-公开）、notify_mentioned_user、mention_entity_list 选填）
`user_id_type`	`string?`	⚪	用户 ID 类型（open_id/union_id/user_id/people_admin_id），默认 open_id；取 user_id 时需 contact:user.employee_id:readonly 字段权限

响应：

json

{
  "code": 0,
  "msg": "success",
  "data": {
    "note": {}
  }
}

说明：data.note 为 Note，含备注 ID、人才/投递 ID、是否私密、创建/更新时间、创建人 ID 与内容。

更新人才备注

按备注 ID 更新备注内容，支持更新 @ 用户并选择是否通知被 @ 的用户。限频：20 次/秒。所需权限：hire:note（更新招聘备注）。字段权限：contact:user.employee_id:readonly（返回的用户 ID 字段）。

函数签名：

csharp

Task<FeishuApiResult<PatchNoteResult>?> PatchNoteAsync(
    [Path] string note_id,
    [Body] PatchNoteRequest request,
    [Query("user_id_type")] string? user_id_type = null,
    CancellationToken cancellationToken = default);

认证：租户令牌

参数：

参数名	类型	必填	说明
`note_id`	`string`	✅	备注 ID，可通过获取人才备注列表接口获取，示例值：`6960663240925956401`
`request`	`PatchNoteRequest`	✅	更新请求体（content 必填；operator_id、notify_mentioned_user、mention_entity_list 选填）
`user_id_type`	`string?`	⚪	用户 ID 类型（open_id/union_id/user_id/people_admin_id），默认 open_id；取 user_id 时需 contact:user.employee_id:readonly 字段权限

响应：

json

{
  "code": 0,
  "msg": "success",
  "data": {
    "note": {}
  }
}

说明：data.note 为更新后的 Note；可通过 notify_mentioned_user 控制是否通知被 @ 的用户。

获取人才备注

按备注 ID 获取备注详情。限频：20 次/秒。所需权限：hire:note:readonly（获取招聘备注）或 hire:note（更新招聘备注）。字段权限：contact:user.employee_id:readonly（返回的用户 ID 字段）。

函数签名：

csharp

Task<FeishuApiResult<GetNoteResult>?> GetNoteAsync(
    [Path] string note_id,
    [Query("user_id_type")] string? user_id_type = null,
    CancellationToken cancellationToken = default);

认证：租户令牌

参数：

参数名	类型	必填	说明
`note_id`	`string`	✅	备注 ID，可通过获取人才备注列表接口获取，示例值：`6949805467799537964`
`user_id_type`	`string?`	⚪	用户 ID 类型（open_id/union_id/user_id/people_admin_id），默认 open_id；取 user_id 时需 contact:user.employee_id:readonly 字段权限

响应：

json

{
  "code": 0,
  "msg": "success",
  "data": {
    "note": {}
  }
}

说明：data.note 为 Note 备注详情。

获取人才备注列表

按人才 ID 分页获取备注列表。限频：20 次/秒。所需权限：hire:note:readonly（获取招聘备注）或 hire:note（更新招聘备注）。字段权限：contact:user.employee_id:readonly（返回的用户 ID 字段）。

函数签名：

csharp

Task<FeishuApiResult<GetNoteListResult>?> GetNoteListAsync(
    [Query("talent_id")] string talent_id,
    [Query("page_size")] int? page_size = null,
    [Query("page_token")] string? page_token = null,
    [Query("user_id_type")] string? user_id_type = null,
    CancellationToken cancellationToken = default);

认证：租户令牌

参数：

参数名	类型	必填	说明
`talent_id`	`string`	✅	人才 ID，示例值：`6916472453069883661`
`page_size`	`int?`	⚪	每页数量，默认 10，最大 200
`page_token`	`string?`	⚪	分页标记，首次请求不填，翻页时取上一次返回的 page_token
`user_id_type`	`string?`	⚪	用户 ID 类型（open_id/union_id/user_id/people_admin_id），默认 open_id；取 user_id 时需 contact:user.employee_id:readonly 字段权限

响应：

json

{
  "code": 0,
  "msg": "success",
  "data": {
    "items": [],
    "has_more": false,
    "page_token": ""
  }
}

说明：data.items 为 Note[]；返回的备注 ID 可用于更新/删除备注。

删除人才备注

按备注 ID 删除指定备注。限频：20 次/秒。所需权限：hire:note（更新招聘备注）。

函数签名：

csharp

Task<FeishuNullDataApiResult?> DeleteNoteAsync(
    [Path] string note_id,
    CancellationToken cancellationToken = default);

认证：租户令牌

参数：

参数名	类型	必填	说明
`note_id`	`string`	✅	备注 ID，可通过获取人才备注列表接口获取，示例值：`6996605821056812588`

响应：

json

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

说明：删除成功时 data 为空对象。

获取简历评估任务列表

获取指定评估人的简历评估任务列表。限频：1000 次/分钟、50 次/秒。所需权限：hire:evaluation:readonly（获取简历评估信息）。字段权限：contact:user.employee_id:readonly（返回的用户 ID 字段）。

函数签名：

csharp

Task<FeishuApiResult<GetEvaluationTaskListResult>?> GetEvaluationTaskListAsync(
    [Query("user_id")] string user_id,
    [Query("page_size")] int? page_size = null,
    [Query("page_token")] string? page_token = null,
    [Query("activity_status")] int? activity_status = null,
    [Query("user_id_type")] string? user_id_type = null,
    CancellationToken cancellationToken = default);

认证：租户令牌

参数：

参数名	类型	必填	说明
`user_id`	`string`	✅	评估人 ID，需与 user_id_type 类型保持一致，示例值：`ou_e6139117c300506837def50545420c6a`
`page_size`	`int?`	⚪	每页数量，最大 20，默认 10
`page_token`	`string?`	⚪	分页标记，首次请求不填，翻页时取上一次返回的 page_token
`activity_status`	`int?`	⚪	任务状态：1-待评估，2-已评估，3-无需评估；不传查询全部
`user_id_type`	`string?`	⚪	用户 ID 类型（open_id/union_id/user_id/people_admin_id），默认 open_id；取 user_id 时需 contact:user.employee_id:readonly 字段权限

响应：

json

{
  "code": 0,
  "msg": "success",
  "data": {
    "has_more": false,
    "page_token": "",
    "items": []
  }
}

说明：data.items 为 EvaluationTask[]；user_id 必须与 user_id_type 的类型一致。

获取笔试阅卷任务列表

获取指定员工的笔试阅卷任务列表。限频：1000 次/分钟、50 次/秒。所需权限：hire:exam:readonly（获取笔试信息）。字段权限：contact:user.employee_id:readonly（返回的用户 ID 字段）。

函数签名：

csharp

Task<FeishuApiResult<GetExamMarkingTaskListResult>?> GetExamMarkingTaskListAsync(
    [Query("user_id")] string user_id,
    [Query("page_size")] int? page_size = null,
    [Query("page_token")] string? page_token = null,
    [Query("activity_status")] int? activity_status = null,
    [Query("user_id_type")] string? user_id_type = null,
    CancellationToken cancellationToken = default);

认证：租户令牌

参数：

参数名	类型	必填	说明
`user_id`	`string`	✅	阅卷人 ID，需与 user_id_type 类型保持一致，示例值：`ou_e6139117c300506837def50545420c6a`
`page_size`	`int?`	⚪	每页数量，最大 20，默认 10
`page_token`	`string?`	⚪	分页标记，首次请求不填，翻页时取上一次返回的 page_token
`activity_status`	`int?`	⚪	任务状态：1-待阅卷，2-已阅卷；不传查询全部
`user_id_type`	`string?`	⚪	用户 ID 类型（open_id/union_id/user_id/people_admin_id），默认 open_id；取 user_id 时需 contact:user.employee_id:readonly 字段权限

响应：

json

{
  "code": 0,
  "msg": "success",
  "data": {
    "has_more": false,
    "page_token": "",
    "items": []
  }
}

说明：data.items 为 ExamMarkingTask[]；user_id 必须与 user_id_type 的类型一致。

获取面试任务列表

获取指定员工的面试任务列表。限频：1000 次/分钟、50 次/秒。所需权限：hire:interview:readonly（获取面试信息）。字段权限：contact:user.employee_id:readonly（返回的用户 ID 字段）。

函数签名：

csharp

Task<FeishuApiResult<GetInterviewTaskListResult>?> GetInterviewTaskListAsync(
    [Query("user_id")] string user_id,
    [Query("page_size")] int? page_size = null,
    [Query("page_token")] string? page_token = null,
    [Query("activity_status")] int? activity_status = null,
    [Query("user_id_type")] string? user_id_type = null,
    CancellationToken cancellationToken = default);

认证：租户令牌

参数：

参数名	类型	必填	说明
`user_id`	`string`	✅	面试官 ID，需与 user_id_type 类型保持一致，示例值：`ou_e6139117c300506837def50545420c6a`
`page_size`	`int?`	⚪	每页数量，最大 20，默认 10
`page_token`	`string?`	⚪	分页标记，首次请求不填，翻页时取上一次返回的 page_token
`activity_status`	`int?`	⚪	任务状态：1-未开始，2-未评估，3-已评估，5-已终止；不传查询全部
`user_id_type`	`string?`	⚪	用户 ID 类型（open_id/union_id/user_id/people_admin_id），默认 open_id；取 user_id 时需 contact:user.employee_id:readonly 字段权限

响应：

json

{
  "code": 0,
  "msg": "success",
  "data": {
    "has_more": false,
    "page_token": "",
    "items": []
  }
}

说明：data.items 为 InterviewTask[]；user_id 必须与 user_id_type 的类型一致。

获取简历来源列表

分页获取简历来源列表（内推、猎头、第三方招聘网站等来源配置）。限频：20 次/秒。所需权限：hire:talent:readonly（获取人才信息）或 hire:talent（更新人才信息）。

函数签名：

csharp

Task<FeishuApiResult<GetResumeSourceListResult>?> GetResumeSourceListAsync(
    [Query("page_size")] int? page_size = null,
    [Query("page_token")] string? page_token = null,
    CancellationToken cancellationToken = default);

认证：租户令牌

参数：

参数名	类型	必填	说明
`page_size`	`int?`	⚪	每页数量，最大 100
`page_token`	`string?`	⚪	分页标记，首次请求不填，翻页时取上一次返回的 page_token

响应：

json

{
  "code": 0,
  "msg": "success",
  "data": {
    "items": [],
    "page_token": "",
    "has_more": false
  }
}

说明：data.items 为 ResumeSource[]，含内推、猎头、第三方招聘网站等来源配置。

批量加入/移除人才库中人才

对同一个人才库批量执行人才加入或移除操作；不存在的 ID 报错返回，已在/不在库中则静默处理。限频：10 次/秒。所需权限：hire:talent_folder（更新人才库信息）。

函数签名：

csharp

Task<FeishuNullDataApiResult?> BatchChangeTalentPoolAsync(
    [Path] string talent_pool_id,
    [Body] BatchChangeTalentPoolRequest request,
    CancellationToken cancellationToken = default);

认证：租户令牌

参数：

参数名	类型	必填	说明
`talent_pool_id`	`string`	✅	人才库 ID，可通过获取人才库列表接口获取，示例值：`6930815272790114324`
`request`	`BatchChangeTalentPoolRequest`	✅	请求体（talent_id_list 必填：人才 ID 列表，1～50 个；option_type 必填：1 加入 / 2 移除）

响应：

json

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

说明：talent_id_list 最多 50 个；不存在的 ID 会报错，已在库/不在库的情况静默处理。

获取人才库列表

分页获取人才库列表，返回人才库 ID、中英文名称与描述、父子关系、可见性与创建/修改时间。限频：1000 次/分钟、50 次/秒。所需权限：hire:talent_folder:readonly（获取人才库信息）或 hire:talent_folder（更新人才库信息）。

函数签名：

csharp

Task<FeishuApiResult<GetTalentPoolListResult>?> GetTalentPoolListAsync(
    [Query("page_size")] int? page_size = null,
    [Query("page_token")] string? page_token = null,
    [Query("id_list")] string[]? id_list = null,
    CancellationToken cancellationToken = default);

认证：租户令牌

参数：

参数名	类型	必填	说明
`page_size`	`int?`	⚪	每页数量，默认 10，最大 100
`page_token`	`string?`	⚪	分页标记，首次请求不填，翻页时取上一次返回的 page_token
`id_list`	`string[]?`	⚪	人才库 ID 列表，传入时按列表返回，最大 50 个；不传返回全部

响应：

json

{
  "code": 0,
  "msg": "success",
  "data": {
    "items": [],
    "page_token": "",
    "has_more": false
  }
}

说明：data.items 为 TalentPool[]，含中英文名称与描述、父子关系、可见性与创建/修改时间。

将人才加入人才库

将单个人才加入指定人才库，并可选择加入后是否从其他人才库移出。限频：1000 次/分钟、50 次/秒。所需权限：hire:talent_folder（更新人才库信息）。

函数签名：

csharp

Task<FeishuApiResult<AddTalentToTalentPoolResult>?> AddTalentToTalentPoolAsync(
    [Path] string talent_pool_id,
    [Body] AddTalentToTalentPoolRequest request,
    CancellationToken cancellationToken = default);

认证：租户令牌

参数：

参数名	类型	必填	说明
`talent_pool_id`	`string`	✅	人才库 ID，可通过获取人才库列表接口获取，示例值：`6930815272790114324`
`request`	`AddTalentToTalentPoolRequest`	✅	请求体（talent_id 必填：人才 ID；add_type 必填：1 不从其他库移出 / 2 从其他库移出）

响应：

json

{
  "code": 0,
  "msg": "success",
  "data": {
    "talent_pool_id": "",
    "talent_id": ""
  }
}

说明：add_type 为 2 时，人才加入目标库后会从其他人才库移出。

操作人才标签

为人才批量新增或删除标签。限频：20 次/秒。所需权限：hire:talent（更新人才信息）。

函数签名：

csharp

Task<FeishuNullDataApiResult?> OperateTalentTagAsync(
    [Path] string talent_id,
    [Body] OperateTalentTagRequest request,
    CancellationToken cancellationToken = default);

认证：租户令牌

参数：

参数名	类型	必填	说明
`talent_id`	`string`	✅	人才 ID，可通过批量获取人才 ID 接口获取，示例值：`6930815272790114324`
`request`	`OperateTalentTagRequest`	✅	请求体（operation 必填：1 新增 / 2 删除；tag_id_list 必填：标签 ID 列表）

响应：

json

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

说明：成功时 data 为空对象；标签 ID 可通过「获取人才标签列表」接口获取。

创建人才

在企业内创建一个人才（简历级聚合写入）；预置姓名必填，邮箱/手机是否必填取决于飞书招聘标准简历模板设置。限频：1000 次/分钟、50 次/秒。所需权限：hire:talent（更新人才信息）。字段权限：contact:user.employee_id:readonly（返回的用户 ID 字段）。

函数签名：

csharp

Task<FeishuApiResult<CombinedCreateTalentResult>?> CombinedCreateTalentAsync(
    [Body] CombinedCreateTalentRequest request,
    [Query("user_id_type")] string? user_id_type = null,
    CancellationToken cancellationToken = default);

认证：租户令牌

参数：

参数名	类型	必填	说明
`request`	`CombinedCreateTalentRequest`	✅	创建请求体（basic_info 必填；education_list 等各子经历数组最大 100 条）
`user_id_type`	`string?`	⚪	用户 ID 类型（open_id/union_id/user_id/people_admin_id），默认 open_id；取 user_id 时需 contact:user.employee_id:readonly 字段权限

响应：

json

{
  "code": 0,
  "msg": "success",
  "data": {
    "talent_id": "",
    "creator_id": "",
    "creator_account_type": 0
  }
}

说明：邮箱/手机是否必填取决于标准简历模板设置；各子经历数组最大 100 条。

更新人才信息

按人才 ID 全量聚合更新企业内人才信息；各子经历数组为全量覆盖，邮箱/手机必填性取决于标准简历模板设置。限频：1000 次/分钟、50 次/秒。所需权限：hire:talent（更新人才信息）。字段权限：contact:user.employee_id:readonly（返回的用户 ID 字段）。

函数签名：

csharp

Task<FeishuApiResult<CombinedUpdateTalentResult>?> CombinedUpdateTalentAsync(
    [Body] CombinedUpdateTalentRequest request,
    [Query("user_id_type")] string? user_id_type = null,
    CancellationToken cancellationToken = default);

认证：租户令牌

参数：

参数名	类型	必填	说明
`request`	`CombinedUpdateTalentRequest`	✅	更新请求体（talent_id 必填；basic_info 必填；operator_id/operator_account_type 为更新者信息）
`user_id_type`	`string?`	⚪	用户 ID 类型（open_id/union_id/user_id/people_admin_id），默认 open_id；取 user_id 时需 contact:user.employee_id:readonly 字段权限

响应：

json

{
  "code": 0,
  "msg": "success",
  "data": {
    "talent_id": "",
    "operator_id": "",
    "operator_account_type": 0
  }
}

说明：为全量聚合更新，各子经历数组全量覆盖，未提交的经历会被清除。

人才加入文件夹

把一批人才加入到指定文件夹。限频：1000 次/分钟、50 次/秒。所需权限：hire:talent（更新人才信息）或 hire:talent_folder_association（更新人才文件夹关联信息）。

函数签名：

csharp

Task<FeishuApiResult<TalentToFolderResult>?> AddTalentToFolderAsync(
    [Body] TalentToFolderRequest request,
    CancellationToken cancellationToken = default);

认证：租户令牌

参数：

参数名	类型	必填	说明
`request`	`TalentToFolderRequest`	✅	请求体（talent_id_list 必填：人才 ID 列表，1～200 个；folder_id 必填：文件夹 ID）

响应：

json

{
  "code": 0,
  "msg": "success",
  "data": {
    "talent_id_list": [],
    "folder_id": ""
  }
}

说明：单次最多 200 个 talent_id；返回回显的人才 ID 列表与文件夹 ID。

人才移出文件夹

按人才 ID 列表把人才从指定文件夹移出。限频：10 次/秒。所需权限：hire:talent_folder_association（更新人才文件夹关联信息）。

函数签名：

csharp

Task<FeishuApiResult<TalentToFolderResult>?> RemoveTalentFromFolderAsync(
    [Body] TalentToFolderRequest request,
    CancellationToken cancellationToken = default);

认证：租户令牌

参数：

参数名	类型	必填	说明
`request`	`TalentToFolderRequest`	✅	请求体（talent_id_list 必填：人才 ID 列表，1～200 个；folder_id 必填：文件夹 ID）

响应：

json

{
  "code": 0,
  "msg": "success",
  "data": {
    "talent_id_list": [],
    "folder_id": ""
  }
}

说明：单次最多 200 个 talent_id；只解除文件夹关联，不删除人才。

获取人才文件夹信息

分页获取招聘系统中的人才文件夹列表（文件夹维度的人才库）。限频：1000 次/分钟、50 次/秒。所需权限：hire:talent_folder:readonly（获取人才库信息）或 hire:talent_folder（更新人才库信息）。字段权限：contact:user.employee_id:readonly（user_id_type=user_id 时返回的用户 ID 字段）。

函数签名：

csharp

Task<FeishuApiResult<GetTalentFolderListResult>?> GetTalentFolderListAsync(
    [Query("page_size")] int? page_size = null,
    [Query("page_token")] string? page_token = null,
    [Query("user_id_type")] string? user_id_type = null,
    CancellationToken cancellationToken = default);

认证：租户令牌

参数：

参数名	类型	必填	说明
`page_size`	`int?`	⚪	每页数量，默认 10，最大 100
`page_token`	`string?`	⚪	分页标记，首次请求不填，翻页时取上一次返回的 page_token
`user_id_type`	`string?`	⚪	用户 ID 类型（open_id/union_id/user_id/people_admin_id），默认 open_id；取 user_id 时需 contact:user.employee_id:readonly 字段权限

响应：

json

{
  "code": 0,
  "msg": "success",
  "data": {
    "has_more": false,
    "page_token": "",
    "items": []
  }
}

说明：data.items 为 TalentFolder[]；返回的 folder_id 用于人才加入/移出文件夹。

根据手机号或邮箱获取人才 ID

通过手机号、邮箱或证件号批量反查人才 ID 及基础信息；三类条件为且（AND）关系，至少传入一种，最多各 100 条。限频：1000 次/分钟、50 次/秒。所需权限：hire:talent:readonly（获取人才信息）或 hire:talent（更新人才信息）。字段权限：hire:talent_onboard_status:readonly（返回的入职状态字段）。

函数签名：

csharp

Task<FeishuApiResult<BatchGetTalentIdResult>?> BatchGetTalentIdAsync(
    [Body] BatchGetTalentIdRequest request,
    CancellationToken cancellationToken = default);

认证：租户令牌

参数：

参数名	类型	必填	说明
`request`	`BatchGetTalentIdRequest`	✅	请求体（mobile_code、mobile_number_list、email_list、identification_type、identification_number_list 选填）

响应：

json

{
  "code": 0,
  "msg": "success",
  "data": {
    "talent_list": []
  }
}

说明：data.talent_list 为 TalentBatchInfo[]；三类查询条件为「且」关系，至少传入一种，每类最多 100 条。

获取人才列表

按关键词、更新时间等条件分页获取候选人（人才）全量档案列表（查询参数采用查询对象模式 TalentListQuery，见 AGENTS.md API-2）。限频：20 次/秒。所需权限：hire:talent:readonly（获取人才信息）或 hire:talent（更新人才信息）。字段权限：contact:user.employee_id:readonly（user_id_type=user_id 时返回的用户 ID 字段）。

函数签名：

csharp

Task<FeishuApiResult<GetTalentListResult>?> GetTalentListAsync(
    [Query] TalentListQuery? query = null,
    CancellationToken cancellationToken = default);

认证：租户令牌

参数：

参数名	类型	必填	说明
`query`	`TalentListQuery?`	⚪	关键词、更新时间范围、分页、排序与 ID 类型查询参数，该对象会整体展开为查询参数

响应：

json

{
  "code": 0,
  "msg": "success",
  "data": {
    "items": [],
    "has_more": false,
    "page_token": ""
  }
}

说明：data.items 为 Talent[]；可按更新时间增量拉取人才全量档案。

获取人才字段

获取人才档案的字段（模块）配置清单，含字段类型、选项与自定义字段。限频：10 次/秒。所需权限：hire:talent:readonly（获取人才信息）或 hire:talent（更新人才信息）。

函数签名：

csharp

Task<FeishuApiResult<QueryTalentObjectResult>?> QueryTalentObjectAsync(
    CancellationToken cancellationToken = default);

认证：租户令牌

参数：

参数名	类型	必填	说明
（无）	—	—	该接口无需业务参数

响应：

json

{
  "code": 0,
  "msg": "success",
  "data": {
    "items": []
  }
}

说明：data.items 为 CommonSchema[]，含字段类型、选项与自定义字段配置。

获取人才信息（v1）

按人才 ID 获取候选人（人才）完整信息，返回 v1 版 talent 结构。限频：20 次/秒。所需权限：hire:talent:readonly（获取人才信息）或 hire:talent（更新人才信息）。字段权限：contact:user.employee_id:readonly（user_id_type=user_id 时返回的用户 ID 字段）。

函数签名：

csharp

Task<FeishuApiResult<GetTalentResult>?> GetTalentAsync(
    [Path] string talent_id,
    [Query("user_id_type")] string? user_id_type = null,
    CancellationToken cancellationToken = default);

认证：租户令牌

参数：

参数名	类型	必填	说明
`talent_id`	`string`	✅	人才 ID，可通过获取人才列表接口获取，示例值：`6930815272790114324`
`user_id_type`	`string?`	⚪	用户 ID 类型（open_id/union_id/user_id/people_admin_id），默认 people_admin_id；取 user_id 时需 contact:user.employee_id:readonly 字段权限

响应：

json

{
  "code": 0,
  "msg": "success",
  "data": {
    "talent": {}
  }
}

说明：data.talent 为 v1 版 Talent；需要人才库/标签/黑名单等扩展数据时改用 v2 接口。

获取人才详细信息（v2）

按人才 ID 获取人才 v2 版详细信息（data 直接为 composite_talent，含人才库、文件夹、标签、黑名单、备注等扩展数据）；不支持查询已删除人才。限频：20 次/秒。所需权限：hire:talent:readonly（获取人才信息）或 hire:talent（更新人才信息）；备注/人才库/标签/黑名单等字段另需对应字段权限。

函数签名：

csharp

Task<FeishuApiResult<GetTalentV2Result>?> GetTalentV2Async(
    [Path] string talent_id,
    [Query("user_id_type")] string? user_id_type = null,
    CancellationToken cancellationToken = default);

认证：租户令牌

参数：

参数名	类型	必填	说明
`talent_id`	`string`	✅	人才 ID，示例值：`6930815272790114324`
`user_id_type`	`string?`	⚪	用户 ID 类型（open_id/union_id/user_id/people_admin_id），默认 people_admin_id；取 user_id 时需 contact:user.employee_id:readonly 字段权限

响应：

json

{
  "code": 0,
  "msg": "success",
  "data": {
    "talent_id": "",
    "basic_info": {},
    "education_list": [],
    "career_list": [],
    "project_list": [],
    "works_list": [],
    "award_list": [],
    "language_list": [],
    "sns_list": [],
    "resume_source_list": [],
    "internship_list": [],
    "customized_data_list": [],
    "resume_attachment_id_list": [],
    "resume_attachment_list": [],
    "interview_registration_list": [],
    "registration_list": [],
    "is_onboarded": false,
    "is_in_agency_period": false,
    "top_degree": 0,
    "talent_pool_id_list": [],
    "talent_folder_ref_list_v2": [],
    "tag_list": [],
    "similar_info_v2": {},
    "block_info": {},
    "talent_pool_ref_list_v2": [],
    "note_list_v2": []
  }
}

说明：data 直接为 v2 版聚合人才信息；不支持查询已删除人才，扩展字段需对应字段权限。

招聘候选人 · 人才与人才库接口 ​

创建人才备注 ​

更新人才备注 ​

获取人才备注 ​

获取人才备注列表 ​

删除人才备注 ​

获取简历评估任务列表 ​

获取笔试阅卷任务列表 ​

获取面试任务列表 ​

获取简历来源列表 ​

批量加入/移除人才库中人才 ​

获取人才库列表 ​

将人才加入人才库 ​

操作人才标签 ​

创建人才 ​

更新人才信息 ​

人才加入文件夹 ​

人才移出文件夹 ​

获取人才文件夹信息 ​

根据手机号或邮箱获取人才 ID ​

获取人才列表 ​

获取人才字段 ​

获取人才信息（v1） ​

获取人才详细信息（v2） ​

招聘候选人 · 人才与人才库接口

创建人才备注

更新人才备注

获取人才备注

获取人才备注列表

删除人才备注

获取简历评估任务列表

获取笔试阅卷任务列表

获取面试任务列表

获取简历来源列表

批量加入/移除人才库中人才

获取人才库列表

将人才加入人才库

操作人才标签

创建人才

更新人才信息

人才加入文件夹

人才移出文件夹

获取人才文件夹信息

根据手机号或邮箱获取人才 ID

获取人才列表

获取人才字段

获取人才信息（v1）

获取人才详细信息（v2）