diff --git a/TenantAccessList.md b/TenantAccessList.md index e3a7af8..2d384ff 100644 --- a/TenantAccessList.md +++ b/TenantAccessList.md @@ -635,7 +635,7 @@ GetVcV1Alerts 3182024-08-13✓考勤打卡创建班次 PostAttendanceV1Shifts -3192024-08-13✓考勤打卡删除班次 +3192024-08-27✓考勤打卡删除班次 DeleteAttendanceV1ShiftsByShiftId 3202024-08-13✓考勤打卡按 ID 查询班次 GetAttendanceV1ShiftsByShiftId @@ -643,11 +643,11 @@ PostAttendanceV1ShiftsQuery 3222024-08-13✓考勤打卡查询所有班次 GetAttendanceV1Shifts -3232024-08-13✓考勤打卡创建或修改考勤组 +3232024-08-28✓考勤打卡创建或修改考勤组 PostAttendanceV1Groups 3242024-07-05✓通讯录获取单位信息 GetContactV3UnitByUnitId -3252024-08-13✓考勤打卡删除考勤组 +3252024-08-28✓考勤打卡删除考勤组 DeleteAttendanceV1GroupsByGroupId 3262024-08-13✓考勤打卡按 ID 查询考勤组 GetAttendanceV1GroupsByGroupId @@ -655,7 +655,7 @@ PostAttendanceV1GroupsSearch 3282024-08-13✓考勤打卡查询所有考勤组 GetAttendanceV1Groups -3292024-08-13✓考勤打卡创建或修改排班表 +3292024-08-27✓考勤打卡创建或修改排班表 PostAttendanceV1UserDailyShiftsBatchCreate 3302024-08-13✓考勤打卡查询排班表 PostAttendanceV1UserDailyShiftsQuery @@ -693,7 +693,7 @@ PostAttendanceV1UserTasksQuery 3472024-07-05✓通讯录添加用户组成员 PostContactV3GroupByGroupIdMemberAdd -3482024-08-13✓考勤打卡修改用户人脸识别信息 +3482024-08-28✓考勤打卡修改用户人脸识别信息 PostAttendanceV1UserSettingsModify 3492024-08-13✓考勤打卡批量查询用户人脸识别信息 GetAttendanceV1UserSettingsQuery @@ -759,7 +759,7 @@ GetApprovalV4ExternalTasks 3802024-08-12✓通讯录批量移除用户组成员 PostContactV3GroupByGroupIdMemberBatchRemove -3812024-08-14✓审批发送审批 Bot 消息 +3812024-08-27✓审批发送审批 Bot 消息 PostApprovalV1MessageSend 3822024-01-26✓审批更新审批 Bot 消息 PostApprovalV1MessageUpdate @@ -999,105 +999,105 @@ PostTaskV2CustomFieldsByCustomFieldGuidOptions 5002023-09-11✓任务更新自定义字段选项 PatchTaskV2CustomFieldsByCustomFieldGuidOptionsByOptionGuid -5012024-08-15✓邮箱创建邮件组 +5012024-08-28✓邮箱创建邮件组 PostMailV1Mailgroups 5022024-07-05✓通讯录删除职级 DeleteContactV3JobLevelsByJobLevelId -5032024-08-15✓邮箱删除邮件组 +5032024-08-28✓邮箱删除邮件组 DeleteMailV1MailgroupsByMailgroupId -5042024-08-15✓邮箱修改邮件组部分信息 +5042024-08-28✓邮箱修改邮件组部分信息 PatchMailV1MailgroupsByMailgroupId -5052024-08-15✓邮箱修改邮件组全部信息 +5052024-08-28✓邮箱修改邮件组全部信息 PutMailV1MailgroupsByMailgroupId -5062024-08-15✓邮箱查询指定邮件组 +5062024-08-28✓邮箱查询指定邮件组 GetMailV1MailgroupsByMailgroupId -5072024-08-15✓邮箱批量获取邮件组 +5072024-08-28✓邮箱批量获取邮件组 GetMailV1Mailgroups -5082024-08-15✓邮箱批量创建邮件组管理员 +5082024-08-28✓邮箱批量创建邮件组管理员 PostMailV1MailgroupsByMailgroupIdManagersBatchCreate -5092024-08-15✓邮箱批量删除邮件组管理员 +5092024-08-28✓邮箱批量删除邮件组管理员 PostMailV1MailgroupsByMailgroupIdManagersBatchDelete -5102024-08-15✓邮箱批量获取邮件组管理员 +5102024-08-28✓邮箱批量获取邮件组管理员 GetMailV1MailgroupsByMailgroupIdManagers -5112024-08-15✓邮箱创建邮件组成员 +5112024-08-28✓邮箱创建邮件组成员 PostMailV1MailgroupsByMailgroupIdMembers -5122024-08-15✓邮箱删除邮件组成员 +5122024-08-28✓邮箱删除邮件组成员 DeleteMailV1MailgroupsByMailgroupIdMembersByMemberId 5132024-07-05✓通讯录更新职级 PutContactV3JobLevelsByJobLevelId -5142024-08-15✓邮箱查询指定邮件组成员 +5142024-08-28✓邮箱查询指定邮件组成员 GetMailV1MailgroupsByMailgroupIdMembersByMemberId -5152024-08-15✓邮箱获取所有邮件组成员 +5152024-08-28✓邮箱获取所有邮件组成员 GetMailV1MailgroupsByMailgroupIdMembers -5162024-08-15✓邮箱批量创建邮件组成员 +5162024-08-28✓邮箱批量创建邮件组成员 PostMailV1MailgroupsByMailgroupIdMembersBatchCreate -5172024-08-15✓邮箱批量删除邮件组成员 +5172024-08-28✓邮箱批量删除邮件组成员 DeleteMailV1MailgroupsByMailgroupIdMembersBatchDelete -5182024-08-15✓邮箱创建邮件组别名 +5182024-08-28✓邮箱创建邮件组别名 PostMailV1MailgroupsByMailgroupIdAliases -5192024-08-15✓邮箱删除邮件组别名 +5192024-08-28✓邮箱删除邮件组别名 DeleteMailV1MailgroupsByMailgroupIdAliasesByAliasId -5202024-08-15✓邮箱获取邮件组所有别名 +5202024-08-28✓邮箱获取邮件组所有别名 GetMailV1MailgroupsByMailgroupIdAliases -5212024-08-15✓邮箱创建邮件组权限成员 +5212024-08-28✓邮箱创建邮件组权限成员 PostMailV1MailgroupsByMailgroupIdPermissionMembers -5222024-08-15✓邮箱删除邮件组权限成员 +5222024-08-28✓邮箱删除邮件组权限成员 DeleteMailV1MailgroupsByMailgroupIdPermissionMembersByPermissionMemberId -5232024-08-15✓邮箱获取邮件组权限成员 +5232024-08-28✓邮箱获取邮件组权限成员 GetMailV1MailgroupsByMailgroupIdPermissionMembersByPermissionMemberId 5242024-07-05✓通讯录获取单个职级信息 GetContactV3JobLevelsByJobLevelId -5252024-08-15✓邮箱批量获取邮件组权限成员 +5252024-08-28✓邮箱批量获取邮件组权限成员 GetMailV1MailgroupsByMailgroupIdPermissionMembers -5262024-08-15✓邮箱批量创建邮件组权限成员 +5262024-08-28✓邮箱批量创建邮件组权限成员 PostMailV1MailgroupsByMailgroupIdPermissionMembersBatchCreate -5272024-08-15✓邮箱批量删除邮件组权限成员 +5272024-08-28✓邮箱批量删除邮件组权限成员 DeleteMailV1MailgroupsByMailgroupIdPermissionMembersBatchDelete -5282024-08-15✓邮箱创建公共邮箱 +5282024-08-28✓邮箱创建公共邮箱 PostMailV1PublicMailboxes -5292024-08-15✓邮箱修改公共邮箱部分信息 +5292024-08-28✓邮箱修改公共邮箱部分信息 PatchMailV1PublicMailboxesByPublicMailboxId -5302024-08-15✓邮箱修改公共邮箱全部信息 +5302024-08-28✓邮箱修改公共邮箱全部信息 PutMailV1PublicMailboxesByPublicMailboxId -5312024-08-15✓邮箱查询指定公共邮箱 +5312024-08-28✓邮箱查询指定公共邮箱 GetMailV1PublicMailboxesByPublicMailboxId -5322024-08-15✓邮箱查询所有公共邮箱 +5322024-08-28✓邮箱查询所有公共邮箱 GetMailV1PublicMailboxes -5332024-08-15✓邮箱永久删除公共邮箱 +5332024-08-28✓邮箱永久删除公共邮箱 DeleteMailV1PublicMailboxesByPublicMailboxId -5342024-08-15✓邮箱添加公共邮箱成员 +5342024-08-28✓邮箱添加公共邮箱成员 PostMailV1PublicMailboxesByPublicMailboxIdMembers 5352024-07-05✓通讯录获取租户职级列表 GetContactV3JobLevels -5362024-08-15✓邮箱删除公共邮箱单个成员 +5362024-08-28✓邮箱删除公共邮箱单个成员 DeleteMailV1PublicMailboxesByPublicMailboxIdMembersByMemberId -5372024-08-15✓邮箱删除公共邮箱所有成员 +5372024-08-28✓邮箱删除公共邮箱所有成员 PostMailV1PublicMailboxesByPublicMailboxIdMembersClear -5382024-08-15✓邮箱查询指定公共邮箱成员信息 +5382024-08-28✓邮箱查询指定公共邮箱成员信息 GetMailV1PublicMailboxesByPublicMailboxIdMembersByMemberId -5392024-08-15✓邮箱查询所有公共邮箱成员信息 +5392024-08-28✓邮箱查询所有公共邮箱成员信息 GetMailV1PublicMailboxesByPublicMailboxIdMembers -5402024-08-15✓邮箱批量添加公共邮箱成员 +5402024-08-28✓邮箱批量添加公共邮箱成员 PostMailV1PublicMailboxesByPublicMailboxIdMembersBatchCreate -5412024-08-15✓邮箱批量删除公共邮箱成员 +5412024-08-28✓邮箱批量删除公共邮箱成员 DeleteMailV1PublicMailboxesByPublicMailboxIdMembersBatchDelete -5422024-08-15✓邮箱创建公共邮箱别名 +5422024-08-28✓邮箱创建公共邮箱别名 PostMailV1PublicMailboxesByPublicMailboxIdAliases -5432024-08-15✓邮箱删除公共邮箱别名 +5432024-08-28✓邮箱删除公共邮箱别名 DeleteMailV1PublicMailboxesByPublicMailboxIdAliasesByAliasId -5442024-08-15✓邮箱查询公共邮箱的所有别名 +5442024-08-28✓邮箱查询公共邮箱的所有别名 GetMailV1PublicMailboxesByPublicMailboxIdAliases -5452024-08-15✓邮箱从回收站删除用户邮箱地址 +5452024-08-28✓邮箱从回收站删除用户邮箱地址 DeleteMailV1UserMailboxesByUserMailboxId 5462024-07-05✓通讯录创建序列 PostContactV3JobFamilies -5472024-08-15✓邮箱创建用户邮箱别名 +5472024-08-28✓邮箱创建用户邮箱别名 PostMailV1UserMailboxesByUserMailboxIdAliases -5482024-08-15✓邮箱删除用户邮箱别名 +5482024-08-28✓邮箱删除用户邮箱别名 DeleteMailV1UserMailboxesByUserMailboxIdAliasesByAliasId -5492024-08-15✓邮箱获取用户邮箱所有别名 +5492024-08-28✓邮箱获取用户邮箱所有别名 GetMailV1UserMailboxesByUserMailboxIdAliases -5502024-08-15✓邮箱查询邮箱地址状态 +5502024-08-28✓邮箱查询邮箱地址状态 PostMailV1UsersQuery 5512022-03-15✓应用信息校验应用管理员 GetApplicationV3IsUserAdmin @@ -1391,15 +1391,15 @@ GetCorehrV1DepartmentsByDepartmentId 6962024-02-23✓飞书人事批量查询部门 GetCorehrV1Departments -6972024-02-06✓飞书人事（企业版）通过地点 ID 批量获取地点信息 +6972024-08-28✓飞书人事（企业版）通过地点 ID 批量获取地点信息 PostCorehrV2LocationsBatchGet 6982024-02-06✓飞书人事创建地点 PostCorehrV1Locations -6992024-02-06✓飞书人事删除地点 +6992024-08-28✓飞书人事删除地点 DeleteCorehrV1LocationsByLocationId -7002024-05-10✓飞书人事查询单个地点 +7002024-08-28✓飞书人事查询单个地点 GetCorehrV1LocationsByLocationId -7012024-05-10✓飞书人事批量查询地点 +7012024-08-28✓飞书人事批量分页查询地点信息 GetCorehrV1Locations 7022024-08-21✓消息与群组合并转发消息 PostImV1MessagesMergeForward @@ -1465,19 +1465,19 @@ GetCorehrV1PreHiresByPreHireId 7332024-07-15✓飞书人事[不推荐] 批量查询待入职信息 GetCorehrV1PreHires -7342024-07-23✓飞书人事（企业版）搜索合同 +7342024-08-26✓飞书人事（企业版）搜索合同 PostCorehrV2ContractsSearch 7352024-08-09✓消息与群组获取消息中的资源文件 GetImV1MessagesByMessageIdResourcesByFileKey -7362024-07-23✓飞书人事创建合同 +7362024-08-26✓飞书人事新建合同 PostCorehrV1Contracts 7372024-07-23✓飞书人事删除合同 DeleteCorehrV1ContractsByContractId -7382024-07-23✓飞书人事更新合同 +7382024-08-26✓飞书人事更新合同 PatchCorehrV1ContractsByContractId -7392024-07-23✓飞书人事查询单个合同 +7392024-08-26✓飞书人事查询单个合同 GetCorehrV1ContractsByContractId -7402024-07-23✓飞书人事批量查询合同 +7402024-08-26✓飞书人事批量查询合同 GetCorehrV1Contracts 7412024-07-15✓飞书人事（企业版）搜索试用期信息 PostCorehrV2ProbationSearch @@ -1535,25 +1535,25 @@ GetCorehrV1CompensationStandardsMatch 7682024-08-23✓消息与群组发送短信加急 PatchImV1MessagesByMessageIdUrgentSms -7692024-08-02✓招聘新建职位 +7692024-08-28✓招聘新建职位 PostHireV1JobsCombinedCreate 7702024-01-22✓招聘获取职位信息 GetHireV1JobsByJobId 7712024-06-21✓招聘获取职位设置 GetHireV1JobsByJobIdConfig -7722024-08-02✓招聘更新职位 +7722024-08-28✓招聘更新职位 PostHireV1JobsByJobIdCombinedUpdate 7732024-03-15✓招聘更新职位设置 PostHireV1JobsByJobIdUpdateConfig -7742023-11-02✓招聘获取职位类别列表 +7742024-08-28✓招聘获取职位类别列表 GetHireV1JobTypes -7752024-08-09✓招聘创建招聘需求 +7752024-08-28✓招聘创建招聘需求 PostHireV1JobRequirements -7762024-07-11✓招聘获取招聘需求信息 +7762024-08-28✓招聘获取招聘需求信息 PostHireV1JobRequirementsSearch -7772024-07-11✓招聘获取招聘需求列表 +7772024-08-28✓招聘获取招聘需求列表 GetHireV1JobRequirements -7782024-08-07✓招聘更新招聘需求 +7782024-08-28✓招聘更新招聘需求 PutHireV1JobRequirementsByJobRequirementId 7792024-07-05✓通讯录批量获取用户信息 GetContactV3UsersBatch @@ -1561,17 +1561,17 @@ PatchImV1MessagesByMessageIdUrgentPhone 7812024-08-09✓招聘删除招聘需求 DeleteHireV1JobRequirementsByJobRequirementId -7822024-08-09✓招聘获取招聘需求模板列表 +7822024-08-27✓招聘获取招聘需求模板列表 GetHireV1JobRequirementSchemas -7832024-08-09✓招聘获取招聘流程信息 +7832024-08-28✓招聘获取招聘流程信息 GetHireV1JobProcesses -7842023-11-02✓招聘获取信息登记表模板列表 +7842024-08-28✓招聘获取信息登记表列表 GetHireV1RegistrationSchemas -7852024-08-09✓招聘获取内推官网下职位广告列表 +7852024-08-28✓招聘获取内推官网下职位广告列表 GetHireV1ReferralWebsitesJobPosts -7862024-08-07✓招聘获取内推官网下职位广告详情 +7862024-08-28✓招聘获取内推官网下职位广告详情 GetHireV1ReferralWebsitesJobPostsByJobPostId -7872024-08-09✓招聘获取内推信息 +7872024-08-27✓招聘获取内推信息 GetHireV1ReferralsGetByApplication 7882024-07-03✓招聘创建外部投递 PostHireV1ExternalApplications @@ -1581,7 +1581,7 @@ DeleteHireV1ExternalApplicationsByExternalApplicationId 7912024-08-23✓消息与群组批量发送消息 PostMessageV4BatchSend -7922024-07-03✓招聘创建外部面试 +7922024-08-26✓招聘创建外部面试 PostHireV1ExternalInterviews 7932024-07-03✓招聘创建外部面评 PostHireV1ExternalInterviewAssessments @@ -1591,9 +1591,9 @@ PostHireV1TalentsAddToFolder 7962024-06-28✓招聘获取人才文件夹列表 GetHireV1TalentFolders -7972024-03-05✓招聘通过手机号或邮箱获取人才 ID +7972024-08-28✓招聘批量获取人才简要信息 PostHireV1TalentsBatchGetId -7982024-08-23✓招聘获取人才字段 +7982024-08-28✓招聘获取人才字段 GetHireV1TalentObjectsQuery 7992024-06-26✓招聘获取人才信息 V1 GetHireV1TalentsByTalentId @@ -1607,9 +1607,9 @@ GetHireV1ApplicationsByApplicationId 8042024-08-19✓招聘获取投递列表 GetHireV1Applications -8052024-08-23✓招聘获取简历评估信息 +8052024-08-28✓招聘批量获取简历评估信息 GetHireV1Evaluations -8062024-08-23✓招聘获取面试满意度问卷列表 +8062024-08-28✓招聘获取面试满意度问卷列表 GetHireV1Questionnaires 8072024-08-07✓招聘获取面试信息 GetHireV1Interviews @@ -1631,9 +1631,9 @@ PostHireV1OffersByOfferIdInternOfferStatus 8162024-07-10✓招聘更新 e-HR 导入任务结果 PatchHireV1EhrImportTasksByEhrImportTaskId -8172024-07-10✓招聘操作候选人入职 +8172024-08-28✓招聘操作候选人入职 PostHireV1ApplicationsByApplicationIdTransferOnboard -8182024-01-22✓招聘更新入职状态 +8182024-08-28✓招聘更新员工状态 PatchHireV1EmployeesByEmployeeId 8192024-07-11✓招聘通过投递 ID 获取入职信息 GetHireV1EmployeesGetByApplication @@ -1651,9 +1651,9 @@ GetHireV1Notes 8262024-07-19✓招聘获取简历来源列表 GetHireV1ResumeSources -8272024-08-15✓招聘创建账号自定义字段 +8272024-08-28✓招聘创建账号自定义字段 PostHireV1EcoAccountCustomFields -8282024-08-15✓招聘更新账号自定义字段 +8282024-08-28✓招聘更新账号自定义字段 PatchHireV1EcoAccountCustomFieldsBatchUpdate 8292024-08-15✓招聘删除账号自定义字段 PostHireV1EcoAccountCustomFieldsBatchDelete @@ -1669,7 +1669,7 @@ PatchHireV1EcoBackgroundCheckPackagesBatchUpdate 8352024-08-21✓消息与群组上传图片 PostImV1Images -8362024-07-30✓招聘删除背调套餐和附加调查项 +8362024-08-28✓招聘删除背调套餐和附加调查项 PostHireV1EcoBackgroundCheckPackagesBatchDelete 8372024-08-12✓招聘更新背调订单进度 PostHireV1EcoBackgroundChecksUpdateProgress @@ -1677,15 +1677,15 @@ PostHireV1EcoBackgroundChecksUpdateResult 8392024-08-12✓招聘终止背调订单 PostHireV1EcoBackgroundChecksCancel -8402023-11-02✓招聘推送试卷列表 +8402024-08-26✓招聘创建试卷列表 PostHireV1EcoExamPapers -8412023-11-02✓招聘更新试卷 +8412024-08-26✓招聘更新试卷列表 PatchHireV1EcoExamPapersBatchUpdate -8422023-11-02✓招聘删除试卷 +8422024-08-26✓招聘删除试卷列表 PostHireV1EcoExamPapersBatchDelete -8432023-11-02✓招聘回传笔试安排结果 +8432024-08-28✓招聘回传笔试安排结果 PostHireV1EcoExamsByExamIdLoginInfo -8442024-03-15✓招聘回传笔试结果 +8442024-08-28✓招聘回传笔试结果 PostHireV1EcoExamsByExamIdUpdateResult 8452024-07-26✓招聘注册内推账户 PostHireV1ReferralAccount @@ -1697,7 +1697,7 @@ PostHireV1ReferralAccountByReferralAccountIdWithdraw 8492024-08-02✓招聘内推账户提现数据对账 PostHireV1ReferralAccountReconciliation -8502024-07-11✓招聘获取附件信息 +8502024-08-26✓招聘获取附件信息 GetHireV1AttachmentsByAttachmentId 8512024-07-11✓招聘获取附件 PDF 格式下载链接 GetHireV1AttachmentsByAttachmentIdPreview @@ -2019,19 +2019,19 @@ PostDocumentAiV1VehicleInvoiceRecognize 10102024-01-03✓AI 能力识别文件中的健康证 PostDocumentAiV1HealthCertificateRecognize -10112024-02-06✓飞书人事（企业版）创建成本中心 +10112024-08-26✓飞书人事（企业版）创建成本中心 PostCorehrV2CostCenters 10122024-02-06✓飞书人事（企业版）启用 / 停用成本中心 PatchCorehrV2CostCentersByCostCenterId -10132024-02-06✓飞书人事（企业版）删除成本中心 +10132024-08-26✓飞书人事（企业版）删除成本中心 DeleteCorehrV2CostCentersByCostCenterId -10142024-02-06✓飞书人事（企业版）搜索成本中心信息 +10142024-08-26✓飞书人事（企业版）搜索成本中心信息 PostCorehrV2CostCentersSearch 10152024-02-06✓飞书人事（企业版）创建成本中心版本 PostCorehrV2CostCentersByCostCenterIdVersions -10162024-02-06✓飞书人事（企业版）更新成本中心版本 +10162024-08-26✓飞书人事（企业版）更正成本中心版本 PatchCorehrV2CostCentersByCostCenterIdVersionsByVersionId -10172024-02-06✓飞书人事（企业版）删除成本中心版本 +10172024-08-26✓飞书人事（企业版）撤销成本中心版本 DeleteCorehrV2CostCentersByCostCenterIdVersionsByVersionId 10182024-07-12✓招聘获取职位上的招聘人员信息 GetHireV1JobsByJobIdRecruiter @@ -2051,7 +2051,7 @@ PostImV1ThreadsByThreadIdForward 10262024-07-16✓日历查询日程视图 GetCalendarV4CalendarsByCalendarIdEventsInstanceView -10272024-08-02✓招聘获取职位列表 +10272024-08-28✓招聘获取职位列表 GetHireV1Jobs 10282024-06-26✓多维表格查询记录 PostBitableV1AppsByAppTokenTablesByTableIdRecordsSearch @@ -2059,7 +2059,7 @@ PutApplicationV6ApplicationsByAppIdManagement 10302024-02-27✓画板获取所有节点 GetBoardV1WhiteboardsByWhiteboardIdNodes -10312024-08-23✓招聘获取人才列表 +10312024-08-28✓招聘获取人才列表 GetHireV1Talents 10322024-03-07✓AI 能力识别文件中的简历信息 PostDocumentAiV1ResumeParse @@ -2135,9 +2135,9 @@ PostCorehrV2DepartmentsQueryMultiTimeline 10682024-05-29删除云文档搜索文件 PostSuiteDocsApiSearchObject -10692024-07-17✓飞书人事（企业版）添加人员 +10692024-08-26✓飞书人事（企业版）添加人员 PostCorehrV2Employees -10702024-07-10✓招聘获取角色详情 +10702024-08-28✓招聘获取角色详情 GetHireV1RolesByRoleId 10712024-06-25✓招聘获取终止投递原因 GetHireV1TerminationReasons @@ -2161,7 +2161,7 @@ PostPerformanceV2IndicatorsQuery 10812024-07-10✓绩效获取标签填写题配置 PostPerformanceV2QuestionsQuery -10822024-07-26✓绩效获取绩效详情数据 +10822024-08-27✓绩效获取绩效详情数据 PostPerformanceV2ReviewDatasQuery 10832024-08-22✓绩效获取指标列表 PostPerformanceV2MetricLibsQuery @@ -2177,23 +2177,23 @@ PostPerformanceV2MetricDetailsQuery 10892024-07-02✓云文档批量增加协作者权限 PostDriveV1PermissionsByTokenMembersBatchCreate -10902024-07-10✓绩效批量删除补充信息 +10902024-08-28✓绩效批量删除补充信息 DeletePerformanceV2AdditionalInformationsBatch -10912024-07-10✓绩效批量查询补充信息 +10912024-08-28✓绩效批量查询补充信息 PostPerformanceV2AdditionalInformationsQuery -10922024-07-10✓绩效批量导入补充信息 +10922024-08-28✓绩效批量导入补充信息 PostPerformanceV2AdditionalInformationsImport 10932024-08-12✓招聘创建附件 PostHireV1Attachments -10942024-08-02✓招聘获取招聘官网下的职位列表 +10942024-08-27✓招聘获取招聘官网下的职位广告列表 GetHireV1WebsitesByWebsiteIdJobPosts 10952024-07-22✓招聘获取项目列表 GetHireV1Subjects 10962024-07-22✓招聘获取职能分类列表 GetHireV1JobFunctions -10972024-08-02✓招聘搜索招聘官网下的职位列表 +10972024-08-27✓招聘搜索招聘官网下的职位广告列表 PostHireV1WebsitesByWebsiteIdJobPostsSearch -10982024-07-24✓招聘创建人才 +10982024-08-28✓招聘创建人才 PostHireV1TalentsCombinedCreate 10992024-07-22✓招聘获取申请表附加信息 PostHireV1ApplicationsDiversityInclusionsSearch @@ -2241,13 +2241,13 @@ PostCalendarV4CalendarsByCalendarIdEventsByEventIdMeetingMinute 11212024-07-15✓飞书人事（企业版）操作员工完成入职 PostCorehrV2PreHiresByPreHireIdComplete -11222024-07-15✓飞书人事（企业版）流转入职任务 +11222024-08-28✓飞书人事（企业版）流转入职任务 PostCorehrV2PreHiresByPreHireIdTransitTask 11232024-07-15✓飞书人事（企业版）查询待入职信息 PostCorehrV2PreHiresQuery 11242024-07-22✓招聘职位发布至官网 PostHireV1AdvertisementsByAdvertisementIdPublish -11252024-08-07✓招聘设置猎头保护期 +11252024-08-27✓招聘设置猎头保护期 PostHireV1AgenciesProtect 11262024-08-07✓招聘获取猎头供应商信息 GetHireV1AgenciesByAgencyId @@ -2255,9 +2255,9 @@ GetHireV1AgenciesQuery 11282024-07-22✓招聘转移投递阶段 PostHireV1ApplicationsByApplicationIdTransferStage -11292024-07-22✓招聘获取职位模板 +11292024-08-28✓招聘获取职位模板 GetHireV1JobSchemas -11302024-08-23✓招聘获取面试评价详细信息 +11302024-08-28✓招聘获取面试评价详细信息 GetHireV1InterviewRecordsByInterviewRecordId 11312024-08-02✓招聘获取招聘官网下职位广告详情 GetHireV1WebsitesByWebsiteIdJobPostsByJobPostId @@ -2267,11 +2267,11 @@ GetHireV1OfferApplicationForms 11342024-08-02✓招聘关闭职位 PostHireV1JobsByJobIdClose -11352024-07-22✓招聘重启职位 +11352024-08-28✓招聘重启职位 PostHireV1JobsByJobIdOpen 11362024-07-22✓招聘添加笔试结果 PostHireV1Exams -11372024-07-22✓招聘更新人才信息 +11372024-08-28✓招聘更新人才 PostHireV1TalentsCombinedUpdate 11382024-07-22✓招聘创建人才外部信息 PostHireV1TalentsByTalentIdExternalInfo @@ -2281,7 +2281,7 @@ GetHireV1BackgroundCheckOrders 11412024-07-22✓招聘获取人才面试信息 GetHireV1InterviewsGetByTalent -11422024-07-22✓招聘获取面试登记表模板列表 +11422024-08-28✓招聘获取面试登记表列表 GetHireV1InterviewRegistrationSchemas 11432024-08-08✓招聘获取 Offer 申请表信息 GetHireV1OfferApplicationFormsByOfferApplicationFormId @@ -2305,37 +2305,37 @@ PostHireV1TestsSearch 11532024-08-22✓招聘获取人才详情 GetHireV2TalentsByTalentId -11542024-08-23✓招聘获取面试记录附件 +11542024-08-28✓招聘获取面试记录附件 GetHireV1InterviewRecordsAttachments 11552024-07-22✓招聘获取外部投递信息 GetHireV1ExternalApplications -11562024-08-20✓招聘获取人才库列表 +11562024-08-28✓招聘获取人才库列表 GetHireV1TalentPools -11572024-08-20✓招聘将人才加入人才库 +11572024-08-28✓招聘将人才加入人才库 PostHireV1TalentPoolsByTalentPoolIdTalentRelationship -11582024-08-20✓招聘更新人才在职状态 +11582024-08-28✓招聘更新人才在职状态 PostHireV1TalentsByTalentIdOnboardStatus 11592024-07-22✓招聘更新外部面评 PatchHireV1ExternalInterviewAssessmentsByExternalInterviewAssessmentId 11602024-08-23✓招聘批量获取面试评价详细信息 GetHireV1InterviewRecords -11612024-08-09✓招聘创建三方协议 +11612024-08-28✓招聘创建三方协议 PostHireV1TripartiteAgreements -11622024-08-09✓招聘删除三方协议 +11622024-08-28✓招聘删除三方协议 DeleteHireV1TripartiteAgreementsByTripartiteAgreementId -11632024-08-09✓招聘查询猎头保护期信息 +11632024-08-28✓招聘查询猎头保护期信息 PostHireV1AgenciesProtectionPeriodSearch -11642024-08-09✓招聘获取三方协议 +11642024-08-28✓招聘获取三方协议 GetHireV1TripartiteAgreements -11652024-08-09✓招聘更新三方协议 +11652024-08-28✓招聘更新三方协议 PutHireV1TripartiteAgreementsByTripartiteAgreementId -11662024-08-07✓招聘查询人才内推信息 +11662024-08-28✓招聘查询人才内推信息 PostHireV1ReferralsSearch 11672024-07-22✓招聘导入外部内推奖励 PostHireV1ExternalReferralRewards 11682024-08-09✓招聘获取面试评价表列表 GetHireV1InterviewFeedbackForms -11692024-08-07✓招聘删除外部内推奖励 +11692024-08-27✓招聘删除外部内推奖励 DeleteHireV1ExternalReferralRewardsByExternalReferralRewardId 11702024-07-31✓多维表格批量获取记录 PostBitableV1AppsByAppTokenTablesByTableIdRecordsBatchGet @@ -2361,4 +2361,16 @@ GetAdminV1AuditInfos 11812024-08-22✓飞书人事（企业版）查询指定生效日期的部门架构树 PostCorehrV2DepartmentsTree +11822024-08-28新增招聘获取用户角色列表 +GetHireV1UserRoles +11832024-08-26新增招聘查询面试官信息列表 +GetHireV1Interviewers +11842024-08-26新增招聘更新面试官信息 +PatchHireV1InterviewersByInterviewerId +11852024-08-26新增招聘获取面试速记明细 +GetHireV1Minutes +11862024-08-26新增应用信息向管理员申请授权 +PostApplicationV6ScopesApply +11872024-08-26新增应用信息查询租户授权状态 +GetApplicationV6Scopes diff --git a/UserAccessList.md b/UserAccessList.md index cc03b45..cfc6a2b 100644 --- a/UserAccessList.md +++ b/UserAccessList.md @@ -707,7 +707,7 @@ PostTaskV2CustomFieldsByCustomFieldGuidOptions 3542023-09-11✓任务更新自定义字段选项 PatchTaskV2CustomFieldsByCustomFieldGuidOptionsByOptionGuid -3552024-08-15✓邮箱查询所有公共邮箱 +3552024-08-28✓邮箱查询所有公共邮箱 GetMailV1PublicMailboxes 3562023-11-27✓搜索搜索消息 PostSearchV2Message @@ -1015,7 +1015,7 @@ PostAilyV1Sessions 5082024-08-22✓薪酬管理批量查询员工薪资档案 PostCompensationV1ArchivesQuery -5092024-07-17✓飞书人事（企业版）添加人员 +5092024-08-26✓飞书人事（企业版）添加人员 PostCorehrV2Employees 5102024-07-10删除绩效获取指标库信息 PostPerformanceV2MetricLibsQuery diff --git a/src/Application/GetApplicationV6ScopesResponseDto.cs b/src/Application/GetApplicationV6ScopesResponseDto.cs new file mode 100644 index 0000000..ce31f4f --- /dev/null +++ b/src/Application/GetApplicationV6ScopesResponseDto.cs @@ -0,0 +1,56 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-08-28 +// +// Last Modified By : yxr +// Last Modified On : 2024-08-28 +// ************************************************************************ +// +// MIT +// +// 查询租户授权状态 响应体 +// ************************************************************************ +namespace FeishuNetSdk.Application; +/// +/// 查询租户授权状态 响应体 +/// 调用该接口查询当前应用向租户申请授权的状态。 +/// 接口ID：7406972061036445700 +/// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/scope/list +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fapplication-v6%2fscope%2flist +/// +public record GetApplicationV6ScopesResponseDto +{ + /// + /// 租户对当前应用所需权限的授予情况。 + /// 必填：否 + /// + [JsonPropertyName("scopes")] + public Scope[]? Scopes { get; set; } + + /// + /// 租户对当前应用所需权限的授予情况。 + /// + public record Scope + { + /// + /// 权限名称。取值示例 `user.phone:readonly`。 + /// 必填：是 + /// 示例值：user.phone:readonly + /// + [JsonPropertyName("scope_name")] + public string ScopeName { get; set; } = string.Empty; + + /// + /// 权限授予状态。 + /// 必填：是 + /// 示例值：1 + /// 可选值： + /// 1：已授权 + /// 2：未授权 + /// + /// + [JsonPropertyName("grant_status")] + public int GrantStatus { get; set; } + } +} diff --git a/src/Attendance/PostAttendanceV1GroupsBodyDto.cs b/src/Attendance/PostAttendanceV1GroupsBodyDto.cs index 1505e2d..d53e2c7 100644 --- a/src/Attendance/PostAttendanceV1GroupsBodyDto.cs +++ b/src/Attendance/PostAttendanceV1GroupsBodyDto.cs @@ -24,14 +24,14 @@ namespace FeishuNetSdk.Attendance; public record PostAttendanceV1GroupsBodyDto { /// - /// 6921319402260496386 + /// 考勤组信息 /// 必填：是 /// [JsonPropertyName("group")] public PostAttendanceV1GroupsBodyDtoGroup Group { get; set; } = new(); /// - /// 6921319402260496386 + /// 考勤组信息 /// public record PostAttendanceV1GroupsBodyDtoGroup { @@ -452,7 +452,7 @@ public record Location public int GroupType { get; set; } /// - /// 班次 ID 列表。当考勤类型参数（group_type）设置为固定班制时，必填该参数，且必须填够 7 个（从周一至周日）。班次 ID 可以通过[查询所有班次](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/shift/list) 和[按名称查询班次](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/shift/query) 获取 + /// 班次 ID 列表。当考勤类型参数（group_type）设置为固定班制时，必填该参数，且必须填够 7 个（从周一至周日）。班次 ID 可以通过[查询所有班次](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/shift/list) 和[按名称查询班次](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/shift/query) 获取。休息日填0 /// 必填：是 /// 示例值：6921319402260496386 /// diff --git a/src/Attendance/PostAttendanceV1GroupsResponseDto.cs b/src/Attendance/PostAttendanceV1GroupsResponseDto.cs index 7c798e7..2347644 100644 --- a/src/Attendance/PostAttendanceV1GroupsResponseDto.cs +++ b/src/Attendance/PostAttendanceV1GroupsResponseDto.cs @@ -24,14 +24,14 @@ namespace FeishuNetSdk.Attendance; public record PostAttendanceV1GroupsResponseDto { /// - /// 6921319402260496386 + /// 考勤组信息 /// 必填：否 /// [JsonPropertyName("group")] public PostAttendanceV1GroupsResponseDtoGroup? Group { get; set; } /// - /// 6921319402260496386 + /// 考勤组信息 /// public record PostAttendanceV1GroupsResponseDtoGroup { diff --git a/src/Attendance/PostAttendanceV1UserSettingsModifyBodyDto.cs b/src/Attendance/PostAttendanceV1UserSettingsModifyBodyDto.cs index 05ea762..f3b0839 100644 --- a/src/Attendance/PostAttendanceV1UserSettingsModifyBodyDto.cs +++ b/src/Attendance/PostAttendanceV1UserSettingsModifyBodyDto.cs @@ -42,7 +42,7 @@ public record PostAttendanceV1UserSettingsModifyBodyDtoUserSetting public string UserId { get; set; } = string.Empty; /// - /// 人脸照片文件 ID，获取方式：[文件上传](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/file/upload) + /// 人脸照片文件 ID，获取方式：[上传用户人脸识别照片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/file/upload) /// 必填：是 /// 示例值：xxxxxb306842b1c189bc5212eefxxxxx /// diff --git a/src/Attendance/PostAttendanceV1UserSettingsModifyResponseDto.cs b/src/Attendance/PostAttendanceV1UserSettingsModifyResponseDto.cs index 6840e0f..965f0b4 100644 --- a/src/Attendance/PostAttendanceV1UserSettingsModifyResponseDto.cs +++ b/src/Attendance/PostAttendanceV1UserSettingsModifyResponseDto.cs @@ -42,7 +42,7 @@ public record PostAttendanceV1UserSettingsModifyResponseDtoUserSetting public string UserId { get; set; } = string.Empty; /// - /// 人脸照片文件 ID，获取方式：[文件上传](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/file/upload) + /// 人脸照片文件 ID /// 必填：是 /// 示例值：xxxxxb306842b1c189bc5212eefxxxxx /// diff --git a/src/Corehr/DeleteCorehrV2CostCentersByCostCenterIdBodyDto.cs b/src/Corehr/DeleteCorehrV2CostCentersByCostCenterIdBodyDto.cs index 9f691ee..7189645 100644 --- a/src/Corehr/DeleteCorehrV2CostCentersByCostCenterIdBodyDto.cs +++ b/src/Corehr/DeleteCorehrV2CostCentersByCostCenterIdBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Corehr; /// /// 删除成本中心 请求体 -/// 删除成本中心 +/// 删除成本中心记录 /// 接口ID：7225452763517157379 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/organization-management/cost_center/delete /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fcost_center%2fdelete diff --git a/src/Corehr/DeleteCorehrV2CostCentersByCostCenterIdVersionsByVersionIdBodyDto.cs b/src/Corehr/DeleteCorehrV2CostCentersByCostCenterIdVersionsByVersionIdBodyDto.cs index 48a6595..7640d4a 100644 --- a/src/Corehr/DeleteCorehrV2CostCentersByCostCenterIdVersionsByVersionIdBodyDto.cs +++ b/src/Corehr/DeleteCorehrV2CostCentersByCostCenterIdVersionsByVersionIdBodyDto.cs @@ -9,12 +9,12 @@ // // MIT // -// 删除成本中心版本 请求体 +// 撤销成本中心版本 请求体 // ************************************************************************ namespace FeishuNetSdk.Corehr; /// -/// 删除成本中心版本 请求体 -/// 撤销成本中心版本 +/// 撤销成本中心版本 请求体 +/// 该接口支持通过成本中心的版本ID撤销成本中心版本信息 /// 接口ID：7225452763517124611 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/organization-management/cost_center/cost_center-version/delete /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fcost_center-version%2fdelete diff --git a/src/Corehr/PatchCorehrV2CostCentersByCostCenterIdVersionsByVersionIdBodyDto.cs b/src/Corehr/PatchCorehrV2CostCentersByCostCenterIdVersionsByVersionIdBodyDto.cs index 0ae4097..c2e4972 100644 --- a/src/Corehr/PatchCorehrV2CostCentersByCostCenterIdVersionsByVersionIdBodyDto.cs +++ b/src/Corehr/PatchCorehrV2CostCentersByCostCenterIdVersionsByVersionIdBodyDto.cs @@ -9,12 +9,12 @@ // // MIT // -// 更新成本中心版本 请求体 +// 更正成本中心版本 请求体 // ************************************************************************ namespace FeishuNetSdk.Corehr; /// -/// 更新成本中心版本 请求体 -/// 更正成本中心版本 +/// 更正成本中心版本 请求体 +/// 对成本中心的版本记录进行更正，可更正的字段包括：名称，上级成本中心，成本中心负责人列表，成本中心的描述，生效时间 /// 接口ID：7225452763517190147 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/organization-management/cost_center/cost_center-version/patch /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fcost_center-version%2fpatch @@ -34,7 +34,7 @@ public record PatchCorehrV2CostCentersByCostCenterIdVersionsByVersionIdBodyDto public record I18n { /// - /// 语言 + /// 信息的语言，支持中文和英文。中文用zh-CN；英文用en-US /// 必填：是 /// 示例值：zh-CN /// @@ -44,14 +44,14 @@ public record I18n /// /// 内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：基础架构 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; } /// - /// 上级成本中心ID + /// 上级成本中心ID，可通过[【搜索成本中心信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search)接口查询获得 /// 必填：否 /// 示例值：6862995757234914824 /// @@ -59,7 +59,7 @@ public record I18n public string? ParentCostCenterId { get; set; } /// - /// 成本中心负责人ID 列表 + /// 成本中心负责人ID 列表，可通过[【搜索员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search)接口获取 /// 必填：否 /// [JsonPropertyName("managers")] @@ -74,6 +74,10 @@ public record I18n /// /// 生效时间 + /// - 填写格式：YYYY-MM-DD + /// - 系统默认为填写日期当天的 00:00:00 生效 + /// - 该接口只支持到最小单位为日 + /// - 日期范围要求:1900-01-01 ～9999-12-31 /// 必填：是 /// 示例值：2020-01-01 /// diff --git a/src/Corehr/PatchCorehrV2CostCentersByCostCenterIdVersionsByVersionIdResponseDto.cs b/src/Corehr/PatchCorehrV2CostCentersByCostCenterIdVersionsByVersionIdResponseDto.cs index 5e52c6b..3c2f562 100644 --- a/src/Corehr/PatchCorehrV2CostCentersByCostCenterIdVersionsByVersionIdResponseDto.cs +++ b/src/Corehr/PatchCorehrV2CostCentersByCostCenterIdVersionsByVersionIdResponseDto.cs @@ -9,12 +9,12 @@ // // MIT // -// 更新成本中心版本 响应体 +// 更正成本中心版本 响应体 // ************************************************************************ namespace FeishuNetSdk.Corehr; /// -/// 更新成本中心版本 响应体 -/// 更正成本中心版本 +/// 更正成本中心版本 响应体 +/// 对成本中心的版本记录进行更正，可更正的字段包括：名称，上级成本中心，成本中心负责人列表，成本中心的描述，生效时间 /// 接口ID：7225452763517190147 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/organization-management/cost_center/cost_center-version/patch /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fcost_center-version%2fpatch @@ -62,7 +62,7 @@ public record CostCenterVersion public record I18n { /// - /// 语言 + /// 信息的语言，支持中文和英文。中文用zh-CN；英文用en-US /// 必填：是 /// 示例值：zh-CN /// @@ -72,7 +72,7 @@ public record I18n /// /// 内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：基础架构 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -87,7 +87,7 @@ public record I18n public string? Code { get; set; } /// - /// 上级成本中心ID + /// 上级成本中心ID，详细信息可通过[【搜索成本中心信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search)接口查询获得 /// 必填：否 /// 示例值：6862995757234914824 /// @@ -95,7 +95,7 @@ public record I18n public string? ParentCostCenterId { get; set; } /// - /// 成本中心负责人ID 列表 + /// 成本中心负责人ID 列表，详细信息可通过[【搜索员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search)接口获取 /// 必填：否 /// [JsonPropertyName("managers")] @@ -110,6 +110,8 @@ public record I18n /// /// 生效时间 + /// - 返回格式：YYYY-MM-DD（最小单位到日） + /// - 日期范围:1900-01-01 ～9999-12-31 /// 必填：是 /// 示例值：2020-01-01 /// @@ -117,7 +119,9 @@ public record I18n public string EffectiveTime { get; set; } = string.Empty; /// - /// 过期时间 + /// 失效时间 + /// - 返回格式：YYYY-MM-DD（最小单位到日） + /// - 日期范围:1900-01-01～9999-12-31 /// 必填：否 /// 示例值：2020-01-01 /// diff --git a/src/Corehr/PostCorehrV2ContractsSearchResponseDto.cs b/src/Corehr/PostCorehrV2ContractsSearchResponseDto.cs index 6e76aea..5bb3df6 100644 --- a/src/Corehr/PostCorehrV2ContractsSearchResponseDto.cs +++ b/src/Corehr/PostCorehrV2ContractsSearchResponseDto.cs @@ -132,7 +132,7 @@ public record I18n public string? FirstPartyCompanyId { get; set; } /// - /// 合同签约人员ID，详细信息可通过[【查询个人信息接口】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/person/get)接口查询获得 + /// 合同签约员工ID，详细信息可通过接口文档[【批量查询员工信息接口】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)接口查询获得 /// 必填：否 /// 示例值：7088589447189022252 /// diff --git a/src/Corehr/PostCorehrV2CostCentersBodyDto.cs b/src/Corehr/PostCorehrV2CostCentersBodyDto.cs index 076a7e2..f5dfcd4 100644 --- a/src/Corehr/PostCorehrV2CostCentersBodyDto.cs +++ b/src/Corehr/PostCorehrV2CostCentersBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Corehr; /// /// 创建成本中心 请求体 -/// 创建成本中心 +/// 单个创建成本中心；可定义成本中心的名称，父级成本中心，成本中心负责人，生效时间等 /// 接口ID：7225452763517140995 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/organization-management/cost_center/create /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fcost_center%2fcreate @@ -22,19 +22,21 @@ namespace FeishuNetSdk.Corehr; public record PostCorehrV2CostCentersBodyDto { /// - /// 成本中心名称。名称不能包含「/」「；」「;」符号，名称长度不能超过 255 个字符 + /// - 名称不能包含「/」「；」「;」字符 + /// - 成本中心中英文名称会有全局唯一校验 /// 必填：是 /// [JsonPropertyName("name")] public I18n[] Names { get; set; } = Array.Empty(); /// - /// 成本中心名称。名称不能包含「/」「；」「;」符号，名称长度不能超过 255 个字符 + /// - 名称不能包含「/」「；」「;」字符 + /// - 成本中心中英文名称会有全局唯一校验 /// public record I18n { /// - /// 语言 + /// 名称信息的语言，支持中文和英文。中文用zh-CN；英文用en-US /// 必填：是 /// 示例值：zh-CN /// @@ -44,14 +46,14 @@ public record I18n /// /// 内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：基础架构相关 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; } /// - /// 编码 + /// - 编码 (不能与其他记录的编码重复)；当开启自动编码时，该字段将无效 /// 必填：否 /// 示例值：MDPD00000023 /// @@ -59,7 +61,7 @@ public record I18n public string? Code { get; set; } /// - /// 上级成本中心ID + /// 上级成本中心ID，详细信息可通过[【搜索成本中心信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search)接口查询获得 /// 必填：否 /// 示例值：6862995757234914824 /// @@ -67,7 +69,8 @@ public record I18n public string? ParentCostCenterId { get; set; } /// - /// 成本中心负责人ID 列表 + /// 成本中心负责人ID 列表； + /// 详细信息可通过[【搜索员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search)接口获取 /// 必填：否 /// [JsonPropertyName("managers")] @@ -81,7 +84,7 @@ public record I18n public I18n[]? Descriptions { get; set; } /// - /// 生效时间 + /// 生效时间；该接口最知好吃到最小单位为日 /// 必填：是 /// 示例值：2020-01-01 /// diff --git a/src/Corehr/PostCorehrV2CostCentersResponseDto.cs b/src/Corehr/PostCorehrV2CostCentersResponseDto.cs index 9f0ab06..e6e5b3d 100644 --- a/src/Corehr/PostCorehrV2CostCentersResponseDto.cs +++ b/src/Corehr/PostCorehrV2CostCentersResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Corehr; /// /// 创建成本中心 响应体 -/// 创建成本中心 +/// 单个创建成本中心；可定义成本中心的名称，父级成本中心，成本中心负责人，生效时间等 /// 接口ID：7225452763517140995 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/organization-management/cost_center/create /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fcost_center%2fcreate @@ -54,7 +54,7 @@ public record PostCorehrV2CostCentersResponseDtoCostCenter public record I18n { /// - /// 语言 + /// 信息的语言，支持中文和英文。中文用zh-CN；英文用en-US /// 必填：是 /// 示例值：zh-CN /// @@ -64,7 +64,7 @@ public record I18n /// /// 内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：基础架构 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -79,7 +79,7 @@ public record I18n public string? Code { get; set; } /// - /// 上级成本中心ID + /// 上级成本中心ID，详细信息可通过[【搜索成本中心信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search)接口查询获得 /// 必填：否 /// 示例值：6862995757234914824 /// @@ -87,7 +87,7 @@ public record I18n public string? ParentCostCenterId { get; set; } /// - /// 成本中心负责人ID 列表 + /// 成本中心负责人ID 列表；详细信息可通过[【搜索员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search)接口获取 /// 必填：否 /// [JsonPropertyName("managers")] @@ -101,7 +101,9 @@ public record I18n public I18n[]? Descriptions { get; set; } /// - /// 生效时间 + /// 生效日期 + /// - 返回格式：YYYY-MM-DD （最小单位到日） + /// - 日期范围:1900-01-01 ～9999-12-31 /// 必填：是 /// 示例值：2020-01-01 /// @@ -109,7 +111,9 @@ public record I18n public string EffectiveTime { get; set; } = string.Empty; /// - /// 过期时间 + /// 失效日期 + /// - 返回格式：YYYY-MM-DD （最小单位到日） + /// - 日期范围:1900-01-01 ～9999-12-31 /// 必填：否 /// 示例值：2020-01-01 /// diff --git a/src/Corehr/PostCorehrV2CostCentersSearchBodyDto.cs b/src/Corehr/PostCorehrV2CostCentersSearchBodyDto.cs index 951d8c1..a0469e5 100644 --- a/src/Corehr/PostCorehrV2CostCentersSearchBodyDto.cs +++ b/src/Corehr/PostCorehrV2CostCentersSearchBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Corehr; /// /// 搜索成本中心信息 请求体 -/// 查询成本中心信息 +/// 搜索成本中心信息；支持通过成本中心ID，成本中心名称，成本中心编码，成本中心上级搜索成本中心的信息，有分页功能。 /// 接口ID：7225452763517075459 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/organization-management/cost_center/search /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fcost_center%2fsearch diff --git a/src/Corehr/PostCorehrV2CostCentersSearchResponseDto.cs b/src/Corehr/PostCorehrV2CostCentersSearchResponseDto.cs index 2825365..74cf33a 100644 --- a/src/Corehr/PostCorehrV2CostCentersSearchResponseDto.cs +++ b/src/Corehr/PostCorehrV2CostCentersSearchResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Corehr; /// /// 搜索成本中心信息 响应体 -/// 查询成本中心信息 +/// 搜索成本中心信息；支持通过成本中心ID，成本中心名称，成本中心编码，成本中心上级搜索成本中心的信息，有分页功能。 /// 接口ID：7225452763517075459 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/organization-management/cost_center/search /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fcost_center%2fsearch @@ -62,7 +62,7 @@ public record CostCenterVersion public record I18n { /// - /// 语言 + /// 信息的语言，支持中文和英文。中文用zh-CN；英文用en-US /// 必填：是 /// 示例值：zh-CN /// @@ -95,7 +95,7 @@ public record I18n public string? ParentCostCenterId { get; set; } /// - /// 成本中心负责人ID 列表 + /// 成本中心负责人ID 列表，详细信息可通过[【搜索员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search)接口获取 /// 必填：否 /// [JsonPropertyName("managers")] @@ -109,7 +109,9 @@ public record I18n public I18n[]? Descriptions { get; set; } /// - /// 生效时间 + /// 生效日期 + /// - 返回格式：YYYY-MM-DD （最小单位到日） + /// - 日期范围:1900-01-01 ～9999-12-31 /// 必填：是 /// 示例值：2020-01-01 /// @@ -117,7 +119,9 @@ public record I18n public string EffectiveTime { get; set; } = string.Empty; /// - /// 过期时间 + /// 失效日期 + /// - 返回格式：YYYY-MM-DD （最小单位到日） + /// - 日期范围:1900-01-01 ～9999-12-31 /// 必填：否 /// 示例值：2020-01-01 /// diff --git a/src/Corehr/PostCorehrV2EmployeesBodyDto.cs b/src/Corehr/PostCorehrV2EmployeesBodyDto.cs index 00ce8b0..3b22290 100644 --- a/src/Corehr/PostCorehrV2EmployeesBodyDto.cs +++ b/src/Corehr/PostCorehrV2EmployeesBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Corehr; /// /// 添加人员 请求体 -/// 支持在单个接口中进行人员全信息添加，包括人员基本信息，雇佣信息，任职记录及其他分组信息 +/// 支持在单个接口中进行人员全信息添加，包括人员的基本信息，雇佣信息，入职任职记录及其他分组信息 /// 接口ID：7350663854198161410 /// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/create /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2femployee%2fcreate diff --git a/src/Corehr/PostCorehrV2EmployeesResponseDto.cs b/src/Corehr/PostCorehrV2EmployeesResponseDto.cs index d47d627..32ea670 100644 --- a/src/Corehr/PostCorehrV2EmployeesResponseDto.cs +++ b/src/Corehr/PostCorehrV2EmployeesResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Corehr; /// /// 添加人员 响应体 -/// 支持在单个接口中进行人员全信息添加，包括人员基本信息，雇佣信息，任职记录及其他分组信息 +/// 支持在单个接口中进行人员全信息添加，包括人员的基本信息，雇佣信息，入职任职记录及其他分组信息 /// 接口ID：7350663854198161410 /// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/create /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2femployee%2fcreate diff --git a/src/Corehr/PostCorehrV2LocationsBatchGetBodyDto.cs b/src/Corehr/PostCorehrV2LocationsBatchGetBodyDto.cs index 1a1b24d..97da3b2 100644 --- a/src/Corehr/PostCorehrV2LocationsBatchGetBodyDto.cs +++ b/src/Corehr/PostCorehrV2LocationsBatchGetBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Corehr; /// /// 通过地点 ID 批量获取地点信息 请求体 -/// 通过地点 ID 批量获取地点信息 +/// 该接口用于根据地点 ID批量查询地点信息，信息包含地点名称、描述、地点用途、工时制度、区域设置、时区以及关联的地址信息等。 /// 接口ID：7252157701853167644 /// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/location/batch_get /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2flocation%2fbatch_get @@ -22,9 +22,10 @@ namespace FeishuNetSdk.Corehr; public record PostCorehrV2LocationsBatchGetBodyDto { /// - /// 地点 ID 列表 + /// 地点 ID 列表， 地点维护管理员在 飞书人事系统，组织管理模块维护的地点记录 ID。 /// 必填：是 /// 最大长度：100 + /// 最小长度：1 /// [JsonPropertyName("location_ids")] public string[] LocationIds { get; set; } = Array.Empty(); diff --git a/src/Corehr/PostCorehrV2LocationsBatchGetResponseDto.cs b/src/Corehr/PostCorehrV2LocationsBatchGetResponseDto.cs index 83cfc2c..c546b9f 100644 --- a/src/Corehr/PostCorehrV2LocationsBatchGetResponseDto.cs +++ b/src/Corehr/PostCorehrV2LocationsBatchGetResponseDto.cs @@ -4,7 +4,7 @@ // Created : 2024-06-24 // // Last Modified By : yxr -// Last Modified On : 2024-06-24 +// Last Modified On : 2024-08-28 // ************************************************************************ // // MIT @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Corehr; /// /// 通过地点 ID 批量获取地点信息 响应体 -/// 通过地点 ID 批量获取地点信息 +/// 该接口用于根据地点 ID批量查询地点信息，信息包含地点名称、描述、地点用途、工时制度、区域设置、时区以及关联的地址信息等。 /// 接口ID：7252157701853167644 /// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/location/batch_get /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2flocation%2fbatch_get @@ -34,7 +34,7 @@ public record PostCorehrV2LocationsBatchGetResponseDto public record Location { /// - /// 地点 ID + /// 地点 ID，地点维护管理员在 飞书人事系统，组织管理模块维护的地点记录 ID。 /// 必填：否 /// 示例值：4718803945687580505 /// @@ -42,19 +42,19 @@ public record Location public string? LocationId { get; set; } /// - /// 地点基本信息 + /// 地点基本信息，该结构维护了地点的名称、编码、启用状态、上级地点 等基础信息。 /// 必填：是 /// [JsonPropertyName("hiberarchy_common")] public LocationHiberarchyCommon HiberarchyCommon { get; set; } = new(); /// - /// 地点基本信息 + /// 地点基本信息，该结构维护了地点的名称、编码、启用状态、上级地点 等基础信息。 /// public record LocationHiberarchyCommon { /// - /// 上级组织 + /// 上级地点，在创建场景下， 该字段必填，枚举值及详细信息可通过[【查询地点列表】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)接口查询获得 /// 必填：否 /// 示例值：4719168654814483759 /// @@ -75,6 +75,7 @@ public record I18n { /// /// 语言 + /// - 中文用zh-CN，英文用en-US。 /// 必填：是 /// 示例值：zh-CN /// @@ -82,9 +83,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -103,9 +104,9 @@ public record I18n public record Enum { /// - /// 枚举值 + /// 组织类型，默认值为 location， 枚举值及详细信息可通过[【批量查询枚举类型】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)接口查询获得 /// 必填：是 - /// 示例值：phone_type + /// 示例值：location /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; @@ -124,6 +125,7 @@ public record I18n { /// /// 语言 + /// - 中文用zh-CN，英文用en-US。 /// 必填：是 /// 示例值：zh-CN /// @@ -131,9 +133,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：地点 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -150,16 +152,21 @@ public record I18n /// /// 生效时间 + /// - 填写格式： YY-MM-DD 00:00:00 + /// - 生效时间， 系统默认为填写日期当天的 00:00:00 生效 /// 必填：否 - /// 示例值：2020-05-0100:00:00 + /// 示例值：2020-05-01 00:00:00 /// [JsonPropertyName("effective_time")] public string? EffectiveTime { get; set; } /// /// 失效时间 + /// - 填写格式： YYYY-MM-DD 00:00:00 + /// - 本次编辑的记录版本失效的时间， 如果用户在本次操作的生效日期之后修改了地点信息，则系统会将下一次操作的日期作为当前记录的失效时间。 + /// - 系统默认为填写日期当天的 00:00:00 失效 /// 必填：否 - /// 示例值：2020-05-0200:00:00 + /// 示例值：2020-05-02 00:00:00 /// [JsonPropertyName("expiration_time")] public string? ExpirationTime { get; set; } @@ -180,7 +187,7 @@ public record I18n public I18n[]? Descriptions { get; set; } /// - /// 树形排序，代表同层级的部门排序序号 + /// 树形排序(可忽略)，代表同层级的部门排序序号 /// 必填：否 /// 示例值：123 /// @@ -188,7 +195,7 @@ public record I18n public string? TreeOrder { get; set; } /// - /// 列表排序，代表所有部门的混排序号 + /// 列表排序(可忽略)，代表所有部门的混排序号 /// 必填：否 /// 示例值：123 /// @@ -208,7 +215,7 @@ public record I18n public record ObjectFieldData { /// - /// 字段名 + /// 自定义字段 API Name，即自定义字段的唯一标识 /// 必填：是 /// 示例值：name /// @@ -216,9 +223,9 @@ public record ObjectFieldData public string FieldName { get; set; } = string.Empty; /// - /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(123, 123.23, true, [\"id1\",\"id2\], 2006-01-02 15:04:05]) + /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同。如：```("\"123\"", "\"123.23\"", "\"true\"", [\"id1\",\"id2\"], \"2006-01-02 15:04:05\")``` /// 必填：是 - /// 示例值：Sandy + /// 示例值：\"Sandy\" /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -226,21 +233,21 @@ public record ObjectFieldData } /// - /// 地点用途 + /// 地点用途 ID，枚举值及详细信息可通过[【批量查询地点用途】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)接口查询获得 /// 必填：否 /// [JsonPropertyName("location_usage_list")] public Enum[]? LocationUsageLists { get; set; } /// - /// 地点用途 + /// 地点用途 ID，枚举值及详细信息可通过[【批量查询地点用途】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)接口查询获得 /// public record Enum { /// /// 枚举值 /// 必填：是 - /// 示例值：phone_type + /// 示例值：work_location /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; @@ -259,6 +266,7 @@ public record I18n { /// /// 语言 + /// - 中文用zh-CN，英文用en-US。 /// 必填：是 /// 示例值：zh-CN /// @@ -266,9 +274,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -298,7 +306,7 @@ public record Address /// /// 完整地址（西方文字） /// 必填：否 - /// 示例值：Beijing,Beijing,China, + /// 示例值：Beijing, Beijing, China, /// [JsonPropertyName("full_address_western_script")] public string? FullAddressWesternScript { get; set; } @@ -312,7 +320,8 @@ public record Address public string? AddressId { get; set; } /// - /// 国家 / 地区 + /// 国家 / 地区 ID + /// 可通过[【查询国家/地区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)接口获取 /// 必填：是 /// 示例值：6862995757234914824 /// @@ -320,13 +329,86 @@ public record Address public string CountryRegionId { get; set; } = string.Empty; /// - /// 主要行政区 + /// 主要行政区 ID + /// 可通过[【查询省份/行政区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region_subdivision/search)接口获取 /// 必填：否 /// 示例值：6863326815667095047 /// [JsonPropertyName("region_id")] public string? RegionId { get; set; } + /// + /// 地址行 1 + /// 必填：否 + /// 示例值：丹佛测试地址-纽埃时区 + /// + [JsonPropertyName("address_line1")] + public string? AddressLine1 { get; set; } + + /// + /// 地址行 2 + /// 必填：否 + /// 示例值：PoewH + /// + [JsonPropertyName("address_line2")] + public string? AddressLine2 { get; set; } + + /// + /// 地址行 3 + /// 必填：否 + /// 示例值：PoewH + /// + [JsonPropertyName("address_line3")] + public string? AddressLine3 { get; set; } + + /// + /// 地址行 4 + /// 必填：否 + /// 示例值：jmwJc + /// + [JsonPropertyName("address_line4")] + public string? AddressLine4 { get; set; } + + /// + /// 地址行 5 + /// 必填：否 + /// 示例值：jmwJc + /// + [JsonPropertyName("address_line5")] + public string? AddressLine5 { get; set; } + + /// + /// 地址行 6 + /// 必填：否 + /// 示例值：jmwJc + /// + [JsonPropertyName("address_line6")] + public string? AddressLine6 { get; set; } + + /// + /// 地址行 7 + /// 必填：否 + /// 示例值：jmwJc + /// + [JsonPropertyName("address_line7")] + public string? AddressLine7 { get; set; } + + /// + /// 地址行 8 + /// 必填：否 + /// 示例值：rafSu + /// + [JsonPropertyName("address_line8")] + public string? AddressLine8 { get; set; } + + /// + /// 地址行 9 + /// 必填：否 + /// 示例值：McPRG + /// + [JsonPropertyName("address_line9")] + public string? AddressLine9 { get; set; } + /// /// 地址行 1（非拉丁语系的本地文字） /// 必填：否 @@ -409,6 +491,9 @@ public record Address /// /// 地址类型 + /// 枚举值可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： + /// - object_api_name = "address" + /// - custom_api_name = "address_type" /// 必填：是 /// [JsonPropertyName("address_type_list")] @@ -416,13 +501,16 @@ public record Address /// /// 地址类型 + /// 枚举值可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： + /// - object_api_name = "address" + /// - custom_api_name = "address_type" /// public record Enum { /// /// 枚举值 /// 必填：是 - /// 示例值：phone_type + /// 示例值：home_address /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; @@ -441,6 +529,7 @@ public record I18n { /// /// 语言 + /// - 中文用zh-CN，英文用en-US。 /// 必填：是 /// 示例值：zh-CN /// @@ -448,9 +537,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -488,7 +577,7 @@ public record CustomFieldData /// /// 自定义字段 apiname，即自定义字段的唯一标识 /// 必填：是 - /// 示例值：name + /// 示例值：custom_field_1__c /// [JsonPropertyName("custom_api_name")] public string CustomApiName { get; set; } = string.Empty; @@ -516,14 +605,14 @@ public record CustomName /// /// 英文 /// 必填：否 - /// 示例值：CustomName + /// 示例值：Custom Name /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } } /// - /// 自定义字段类型 + /// 自定义字段类型，详细见[获取自定义字段列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/query) /// 必填：否 /// 示例值：1 /// @@ -531,7 +620,7 @@ public record CustomName public int? Type { get; set; } /// - /// 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同（如 123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05"） + /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同。如：```("\"123\"", "\"123.23\"", "\"true\"", [\"id1\",\"id2\"], \"2006-01-02 15:04:05\")``` /// 必填：是 /// 示例值：\"231\" /// @@ -541,7 +630,7 @@ public record CustomName } /// - /// 工时制度 + /// 工时制度 ID，枚举值及详细信息可通过[【批量查询工时制度】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/list)接口查询获得 /// 必填：否 /// 示例值：4690238309151997779 /// @@ -550,16 +639,21 @@ public record CustomName /// /// 生效时间 + /// - 填写格式： YY-MM-DD 00:00:00 + /// - 生效时间， 系统默认为填写日期当天的 00:00:00 生效 /// 必填：是 - /// 示例值：2020-05-0100:00:00 + /// 示例值：2020-05-01 00:00:00 /// [JsonPropertyName("effective_time")] public string EffectiveTime { get; set; } = string.Empty; /// /// 失效时间 + /// - 填写格式： YYYY-MM-DD 00:00:00 + /// - 本次编辑的记录版本失效的时间， 如果用户在本次操作的生效日期之后修改了地点信息，则系统会将下一次操作的日期作为当前记录的失效时间。 + /// - 系统默认为填写日期当天的 00:00:00 失效 /// 必填：否 - /// 示例值：2020-05-0200:00:00 + /// 示例值：2020-05-02 00:00:00 /// [JsonPropertyName("expiration_time")] public string? ExpirationTime { get; set; } @@ -607,14 +701,14 @@ public record CustomName /// /// 英文 /// 必填：否 - /// 示例值：CustomName + /// 示例值：Custom Name /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } } /// - /// 自定义字段类型 + /// 自定义字段类型，详细见[获取自定义字段列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/query) /// 必填：否 /// 示例值：1 /// @@ -622,7 +716,7 @@ public record CustomName public int? Type { get; set; } /// - /// 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同（如 123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05"） + /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同。如：```("\"123\"", "\"123.23\"", "\"true\"", [\"id1\",\"id2\"], \"2006-01-02 15:04:05\")``` /// 必填：是 /// 示例值：\"231\" /// @@ -631,7 +725,7 @@ public record CustomName } /// - /// 区域设置 + /// 区域设置ID ，枚举值及详细信息可通过[【批量查询枚举信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)接口查询获得 /// 必填：否 /// 示例值：zh_cn /// diff --git a/src/FeishuNetSdk.csproj b/src/FeishuNetSdk.csproj index c511ed5..dd51b4b 100644 --- a/src/FeishuNetSdk.csproj +++ b/src/FeishuNetSdk.csproj @@ -16,7 +16,7 @@ MIT 适用于飞书开放平台的.Net开发包 LICENSE - 2.4.4 + 2.4.5 diff --git a/src/FeishuPeople/GetCorehrV1ContractsByContractIdResponseDto.cs b/src/FeishuPeople/GetCorehrV1ContractsByContractIdResponseDto.cs index 8546d62..0dbef5e 100644 --- a/src/FeishuPeople/GetCorehrV1ContractsByContractIdResponseDto.cs +++ b/src/FeishuPeople/GetCorehrV1ContractsByContractIdResponseDto.cs @@ -124,7 +124,7 @@ public record I18n public string FirstPartyCompanyId { get; set; } = string.Empty; /// - /// Person ID，详细信息可通过接口文档[【查询个人信息接口】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/person/get)接口查询获得 + /// Person ID，详细信息可通过接口文档[【批量查询员工信息接口】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)接口查询获得 /// 必填：否 /// 示例值：151515151 /// diff --git a/src/FeishuPeople/GetCorehrV1ContractsResponseDto.cs b/src/FeishuPeople/GetCorehrV1ContractsResponseDto.cs index b8ede2a..0f71e6c 100644 --- a/src/FeishuPeople/GetCorehrV1ContractsResponseDto.cs +++ b/src/FeishuPeople/GetCorehrV1ContractsResponseDto.cs @@ -124,7 +124,7 @@ public record I18n public string FirstPartyCompanyId { get; set; } = string.Empty; /// - /// Person ID，详细信息可通过接口文档[【查询个人信息接口】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/person/get)接口查询获得 + /// Person ID，详细信息可通过接口文档[【批量查询员工信息接口】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)接口查询获得 /// 必填：否 /// 示例值：151515151 /// diff --git a/src/FeishuPeople/GetCorehrV1LocationsByLocationIdResponseDto.cs b/src/FeishuPeople/GetCorehrV1LocationsByLocationIdResponseDto.cs index e2ef962..d0646bd 100644 --- a/src/FeishuPeople/GetCorehrV1LocationsByLocationIdResponseDto.cs +++ b/src/FeishuPeople/GetCorehrV1LocationsByLocationIdResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.FeishuPeople; /// /// 查询单个地点 响应体 -/// 根据 ID 查询单个地点。 +/// 该接口用于根据地点 ID查询地点信息，信息包含地点名称、描述、地点用途、工时制度、区域设置、时区以及关联的地址信息等。 /// 接口ID：7017694651622113284 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/organization-management/location/get /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fcorehr-v1%2flocation%2fget @@ -34,7 +34,7 @@ public record GetCorehrV1LocationsByLocationIdResponseDto public record GetCorehrV1LocationsByLocationIdResponseDtoLocation { /// - /// 实体在CoreHR内部的唯一键 + /// 地点维护管理员在 飞书人事系统，组织管理模块维护的地点记录 ID。 /// 必填：否 /// 示例值：4718803945687580505 /// @@ -42,19 +42,19 @@ public record GetCorehrV1LocationsByLocationIdResponseDtoLocation public string? Id { get; set; } /// - /// 层级关系，内层字段见实体 + /// 地点基本信息，该结构维护了地点的名称、编码、启用状态、上级地点 等基础信息。 /// 必填：是 /// [JsonPropertyName("hiberarchy_common")] public GetCorehrV1LocationsByLocationIdResponseDtoLocationHiberarchyCommon HiberarchyCommon { get; set; } = new(); /// - /// 层级关系，内层字段见实体 + /// 地点基本信息，该结构维护了地点的名称、编码、启用状态、上级地点 等基础信息。 /// public record GetCorehrV1LocationsByLocationIdResponseDtoLocationHiberarchyCommon { /// - /// 上级地点 + /// 上级地点，在创建场景下， 该字段必填，枚举值及详细信息可通过[【查询地点列表】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)接口查询获得 /// 必填：否 /// 示例值：4719168654814483759 /// @@ -75,6 +75,7 @@ public record I18n { /// /// 语言 + /// - 中文用zh-CN，英文用en-US。 /// 必填：是 /// 示例值：zh-CN /// @@ -91,21 +92,21 @@ public record I18n } /// - /// 类型 + /// 组织类型 /// 必填：否 /// [JsonPropertyName("type")] public Enum? Type { get; set; } /// - /// 类型 + /// 组织类型 /// public record Enum { /// - /// 枚举值 + /// 组织类型，默认值为 location， 枚举值及详细信息可通过[【批量查询枚举类型】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)接口查询获得 /// 必填：是 - /// 示例值：phone_type + /// 示例值：location /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; @@ -124,6 +125,7 @@ public record I18n { /// /// 语言 + /// - 中文用zh-CN，英文用en-US。 /// 必填：是 /// 示例值：zh-CN /// @@ -133,7 +135,7 @@ public record I18n /// /// 内容 /// 必填：是 - /// 示例值：刘梓新 + /// 示例值：地点 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -150,6 +152,8 @@ public record I18n /// /// 生效时间 + /// - 填写格式： YY-MM-DD 00:00:00 + /// - 生效时间， 系统默认为填写日期当天的 00:00:00 生效 /// 必填：否 /// 示例值：2020-05-01 00:00:00 /// @@ -158,6 +162,9 @@ public record I18n /// /// 失效时间 + /// - 填写格式： YYYY-MM-DD 00:00:00 + /// - 本次编辑的记录版本失效的时间， 如果用户在本次操作的生效日期之后修改了地点信息，则系统会将下一次操作的日期作为当前记录的失效时间。 + /// - 系统默认为填写日期当天的 00:00:00 失效 /// 必填：否 /// 示例值：2020-05-02 00:00:00 /// @@ -180,7 +187,7 @@ public record I18n public I18n[]? Descriptions { get; set; } /// - /// 树形排序 + /// 树形排序（可忽略） /// 必填：否 /// 示例值：1 /// @@ -188,7 +195,7 @@ public record I18n public string? TreeOrder { get; set; } /// - /// 列表排序 + /// 列表排序（可忽略） /// 必填：否 /// 示例值：2 /// @@ -216,9 +223,9 @@ public record ObjectFieldData public string FieldName { get; set; } = string.Empty; /// - /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(123, 123.23, true, [\"id1\",\"id2\], 2006-01-02 15:04:05]) + /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同。如：```("\"123\"", "\"123.23\"", "\"true\"", [\"id1\",\"id2\"], \"2006-01-02 15:04:05\")``` /// 必填：是 - /// 示例值：Sandy + /// 示例值：\"Sandy\" /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -238,9 +245,9 @@ public record ObjectFieldData public record Enum { /// - /// 枚举值 + /// 枚举值， 地点用途 ID，枚举值及详细信息可通过[【批量查询地点用途】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)接口查询获得 /// 必填：是 - /// 示例值：phone_type + /// 示例值：work_location /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; @@ -259,6 +266,7 @@ public record I18n { /// /// 语言 + /// - 中文用zh-CN，英文用en-US。 /// 必填：是 /// 示例值：zh-CN /// @@ -268,7 +276,7 @@ public record I18n /// /// 内容 /// 必填：是 - /// 示例值：刘梓新 + /// 示例值：工作地点 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -312,7 +320,8 @@ public record Address public string? Id { get; set; } /// - /// 国家 / 地区 + /// 国家 / 地区 ID + /// 可通过[【查询国家/地区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)接口获取 /// 必填：是 /// 示例值：6862995757234914824 /// @@ -320,7 +329,8 @@ public record Address public string CountryRegionId { get; set; } = string.Empty; /// - /// 主要行政区 + /// 主要行政区 ID + /// 可通过[【查询省份/行政区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region_subdivision/search)接口获取 /// 必填：否 /// 示例值：6863326815667095047 /// @@ -497,6 +507,9 @@ public record Address /// /// 地址类型 + /// 枚举值可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： + /// - object_api_name = "address" + /// - custom_api_name = "address_type" /// 必填：否 /// [JsonPropertyName("address_type_list")] @@ -504,13 +517,16 @@ public record Address /// /// 地址类型 + /// 枚举值可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： + /// - object_api_name = "address" + /// - custom_api_name = "address_type" /// public record Enum { /// /// 枚举值 /// 必填：是 - /// 示例值：phone_type + /// 示例值：onboarding_address /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; @@ -529,6 +545,7 @@ public record I18n { /// /// 语言 + /// - 中文用zh-CN，英文用en-US。 /// 必填：是 /// 示例值：zh-CN /// @@ -538,7 +555,7 @@ public record I18n /// /// 内容 /// 必填：是 - /// 示例值：刘梓新 + /// 示例值：入职地址 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -582,9 +599,9 @@ public record ObjectFieldData public string FieldName { get; set; } = string.Empty; /// - /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(123, 123.23, true, [\"id1\",\"id2\], 2006-01-02 15:04:05]) + /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同。如：```("\"123\"", "\"123.23\"", "\"true\"", [\"id1\",\"id2\"], \"2006-01-02 15:04:05\")``` /// 必填：是 - /// 示例值：Sandy + /// 示例值：\"Sandy\" /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -592,7 +609,7 @@ public record ObjectFieldData } /// - /// 工时制度 + /// 工时制度 ID，枚举值及详细信息可通过[【批量查询工时制度】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/list)接口查询获得 /// 必填：否 /// 示例值：4690238309151997779 /// @@ -600,7 +617,9 @@ public record ObjectFieldData public string? WorkingHoursTypeId { get; set; } /// - /// 生效时间 + /// 生效时间生效时间 + /// - 填写格式： YY-MM-DD 00:00:00 + /// - 生效时间， 系统默认为填写日期当天的 00:00:00 生效 /// 必填：是 /// 示例值：2020-05-01 00:00:00 /// @@ -609,6 +628,9 @@ public record ObjectFieldData /// /// 失效时间 + /// - 填写格式： YYYY-MM-DD 00:00:00 + /// - 本次编辑的记录版本失效的时间， 如果用户在本次操作的生效日期之后修改了地点信息，则系统会将下一次操作的日期作为当前记录的失效时间。 + /// - 系统默认为填写日期当天的 00:00:00 失效 /// 必填：否 /// 示例值：2020-05-02 00:00:00 /// @@ -636,16 +658,16 @@ public record ObjectFieldData public string FieldName { get; set; } = string.Empty; /// - /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(123, 123.23, true, [\"id1\",\"id2\], 2006-01-02 15:04:05]) + /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同。如：```("\"123\"", "\"123.23\"", "\"true\"", [\"id1\",\"id2\"], \"2006-01-02 15:04:05\")``` /// 必填：是 - /// 示例值：Sandy + /// 示例值：\"Sandy\" /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; } /// - /// 区域设置 + /// 区域设置ID ，枚举值及详细信息可通过[【批量查询枚举信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)接口查询获得 /// 必填：否 /// 示例值：zh_cn /// diff --git a/src/FeishuPeople/GetCorehrV1LocationsResponseDto.cs b/src/FeishuPeople/GetCorehrV1LocationsResponseDto.cs index 681e618..a909d43 100644 --- a/src/FeishuPeople/GetCorehrV1LocationsResponseDto.cs +++ b/src/FeishuPeople/GetCorehrV1LocationsResponseDto.cs @@ -9,12 +9,12 @@ // // MIT // -// 批量查询地点 响应体 +// 批量分页查询地点信息 响应体 // ************************************************************************ namespace FeishuNetSdk.FeishuPeople; /// -/// 批量查询地点 响应体 -/// 批量查询地点。 +/// 批量分页查询地点信息 响应体 +/// 该接口用于批量查询地点信息，信息包含地点名称、描述、地点用途、工时制度、区域设置、时区以及关联的地址信息等。 /// 接口ID：7017707615190990851 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/organization-management/location/list /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fcorehr-v1%2flocation%2flist @@ -34,7 +34,7 @@ public record GetCorehrV1LocationsResponseDto public record Location { /// - /// 实体在CoreHR内部的唯一键 + /// 地点维护管理员在 飞书人事系统，组织管理模块维护的地点记录 ID。 /// 必填：否 /// 示例值：4718803945687580505 /// @@ -42,19 +42,19 @@ public record Location public string? Id { get; set; } /// - /// 层级关系，内层字段见实体 + /// 地点基本信息，该结构维护了地点的名称、编码、启用状态、上级地点 等基础信息。 /// 必填：是 /// [JsonPropertyName("hiberarchy_common")] public LocationHiberarchyCommon HiberarchyCommon { get; set; } = new(); /// - /// 层级关系，内层字段见实体 + /// 地点基本信息，该结构维护了地点的名称、编码、启用状态、上级地点 等基础信息。 /// public record LocationHiberarchyCommon { /// - /// 上级 + /// 上级地点，在创建场景下， 该字段必填，枚举值及详细信息可通过[【查询地点列表】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)接口查询获得 /// 必填：否 /// 示例值：4719168654814483759 /// @@ -75,6 +75,7 @@ public record I18n { /// /// 语言 + /// - 中文用zh-CN，英文用en-US。 /// 必填：是 /// 示例值：zh-CN /// @@ -91,21 +92,21 @@ public record I18n } /// - /// 类型 + /// 组织类型 /// 必填：否 /// [JsonPropertyName("type")] public Enum? Type { get; set; } /// - /// 类型 + /// 组织类型 /// public record Enum { /// - /// 枚举值 + /// 组织类型，默认值为 location， 枚举值及详细信息可通过[【批量查询枚举类型】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)接口查询获得 /// 必填：是 - /// 示例值：phone_type + /// 示例值：location /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; @@ -124,6 +125,7 @@ public record I18n { /// /// 语言 + /// - 中文用zh-CN，英文用en-US。 /// 必填：是 /// 示例值：zh-CN /// @@ -133,7 +135,7 @@ public record I18n /// /// 内容 /// 必填：是 - /// 示例值：刘梓新 + /// 示例值：地点 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -150,6 +152,8 @@ public record I18n /// /// 生效时间 + /// - 填写格式： YY-MM-DD 00:00:00 + /// - 生效时间， 系统默认为填写日期当天的 00:00:00 生效 /// 必填：否 /// 示例值：2020-05-01 00:00:00 /// @@ -158,6 +162,9 @@ public record I18n /// /// 失效时间 + /// - 填写格式： YYYY-MM-DD 00:00:00 + /// - 本次编辑的记录版本失效的时间， 如果用户在本次操作的生效日期之后修改了地点信息，则系统会将下一次操作的日期作为当前记录的失效时间。 + /// - 系统默认为填写日期当天的 00:00:00 失效 /// 必填：否 /// 示例值：2020-05-02 00:00:00 /// @@ -180,7 +187,7 @@ public record I18n public I18n[]? Descriptions { get; set; } /// - /// 树形排序 + /// 树形排序（可忽略） /// 必填：否 /// 示例值：1 /// @@ -188,7 +195,7 @@ public record I18n public string? TreeOrder { get; set; } /// - /// 列表排序 + /// 列表排序（可忽略） /// 必填：否 /// 示例值：1 /// @@ -216,9 +223,9 @@ public record ObjectFieldData public string FieldName { get; set; } = string.Empty; /// - /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(123, 123.23, true, [\"id1\",\"id2\], 2006-01-02 15:04:05]) + /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同。如：```("\"123\"", "\"123.23\"", "\"true\"", [\"id1\",\"id2\"], \"2006-01-02 15:04:05\")``` /// 必填：是 - /// 示例值：Sandy + /// 示例值：\"Sandy\" /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -238,9 +245,9 @@ public record ObjectFieldData public record Enum { /// - /// 枚举值 + /// 枚举值， 地点用途 ID，枚举值及详细信息可通过[【批量查询地点用途】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)接口查询获得 /// 必填：是 - /// 示例值：phone_type + /// 示例值：work_location /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; @@ -259,6 +266,7 @@ public record I18n { /// /// 语言 + /// - 中文用zh-CN，英文用en-US。 /// 必填：是 /// 示例值：zh-CN /// @@ -268,7 +276,7 @@ public record I18n /// /// 内容 /// 必填：是 - /// 示例值：刘梓新 + /// 示例值：工作地点 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -312,7 +320,8 @@ public record Address public string? Id { get; set; } /// - /// 国家 / 地区 + /// 国家 / 地区 ID + /// 可通过[【查询国家/地区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)接口获取 /// 必填：是 /// 示例值：6862995757234914824 /// @@ -320,7 +329,8 @@ public record Address public string CountryRegionId { get; set; } = string.Empty; /// - /// 主要行政区 + /// 主要行政区 ID + /// 可通过[【查询省份/行政区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region_subdivision/search)接口获取 /// 必填：否 /// 示例值：6863326815667095047 /// @@ -497,6 +507,9 @@ public record Address /// /// 地址类型 + /// 枚举值可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： + /// - object_api_name = "address" + /// - custom_api_name = "address_type" /// 必填：否 /// [JsonPropertyName("address_type_list")] @@ -504,13 +517,16 @@ public record Address /// /// 地址类型 + /// 枚举值可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： + /// - object_api_name = "address" + /// - custom_api_name = "address_type" /// public record Enum { /// /// 枚举值 /// 必填：是 - /// 示例值：phone_type + /// 示例值：onboarding_address /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; @@ -529,6 +545,7 @@ public record I18n { /// /// 语言 + /// - 中文用zh-CN，英文用en-US。 /// 必填：是 /// 示例值：zh-CN /// @@ -538,7 +555,7 @@ public record I18n /// /// 内容 /// 必填：是 - /// 示例值：刘梓新 + /// 示例值：入职地址 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -582,9 +599,9 @@ public record ObjectFieldData public string FieldName { get; set; } = string.Empty; /// - /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(123, 123.23, true, [\"id1\",\"id2\], 2006-01-02 15:04:05]) + /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同。如：```("\"123\"", "\"123.23\"", "\"true\"", [\"id1\",\"id2\"], \"2006-01-02 15:04:05\")``` /// 必填：是 - /// 示例值：Sandy + /// 示例值：\"Sandy\" /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -592,7 +609,7 @@ public record ObjectFieldData } /// - /// 工时制度 + /// 工时制度 ID，枚举值及详细信息可通过[【批量查询工时制度】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/list)接口查询获得 /// 必填：否 /// 示例值：4690238309151997779 /// @@ -601,6 +618,8 @@ public record ObjectFieldData /// /// 生效时间 + /// - 填写格式： YY-MM-DD 00:00:00 + /// - 生效时间， 系统默认为填写日期当天的 00:00:00 生效 /// 必填：是 /// 示例值：2020-05-01 00:00:00 /// @@ -609,6 +628,9 @@ public record ObjectFieldData /// /// 失效时间 + /// - 填写格式： YYYY-MM-DD 00:00:00 + /// - 本次编辑的记录版本失效的时间， 如果用户在本次操作的生效日期之后修改了地点信息，则系统会将下一次操作的日期作为当前记录的失效时间。 + /// - 系统默认为填写日期当天的 00:00:00 失效 /// 必填：否 /// 示例值：2020-05-02 00:00:00 /// @@ -636,16 +658,16 @@ public record ObjectFieldData public string FieldName { get; set; } = string.Empty; /// - /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(123, 123.23, true, [\"id1\",\"id2\], 2006-01-02 15:04:05]) + /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同。如：```("\"123\"", "\"123.23\"", "\"true\"", [\"id1\",\"id2\"], \"2006-01-02 15:04:05\")``` /// 必填：是 - /// 示例值：Sandy + /// 示例值：\"Sandy\" /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; } /// - /// 区域设置 + /// 区域设置ID ，枚举值及详细信息可通过[【批量查询枚举信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)接口查询获得 /// 必填：否 /// 示例值：zh_cn /// diff --git a/src/FeishuPeople/PostCorehrV1ContractsBodyDto.cs b/src/FeishuPeople/PostCorehrV1ContractsBodyDto.cs index 60e2cb1..8dd36fa 100644 --- a/src/FeishuPeople/PostCorehrV1ContractsBodyDto.cs +++ b/src/FeishuPeople/PostCorehrV1ContractsBodyDto.cs @@ -9,12 +9,12 @@ // // MIT // -// 创建合同 请求体 +// 新建合同 请求体 // ************************************************************************ namespace FeishuNetSdk.FeishuPeople; /// -/// 创建合同 请求体 -/// 通过本接口可以为员工创建合同 +/// 新建合同 请求体 +/// 通过本接口可以为员工创建一份新合同 /// 接口ID：7017707615190876163 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/contract/create /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fcorehr-v1%2fcontract%2fcreate diff --git a/src/FeishuPeople/PostCorehrV1ContractsResponseDto.cs b/src/FeishuPeople/PostCorehrV1ContractsResponseDto.cs index af67c0c..a499cbc 100644 --- a/src/FeishuPeople/PostCorehrV1ContractsResponseDto.cs +++ b/src/FeishuPeople/PostCorehrV1ContractsResponseDto.cs @@ -9,12 +9,12 @@ // // MIT // -// 创建合同 响应体 +// 新建合同 响应体 // ************************************************************************ namespace FeishuNetSdk.FeishuPeople; /// -/// 创建合同 响应体 -/// 通过本接口可以为员工创建合同 +/// 新建合同 响应体 +/// 通过本接口可以为员工创建一份新合同 /// 接口ID：7017707615190876163 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/contract/create /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fcorehr-v1%2fcontract%2fcreate diff --git a/src/Hire/GetHireV1AttachmentsByAttachmentIdResponseDto.cs b/src/Hire/GetHireV1AttachmentsByAttachmentIdResponseDto.cs index 49ed2dd..d5f603b 100644 --- a/src/Hire/GetHireV1AttachmentsByAttachmentIdResponseDto.cs +++ b/src/Hire/GetHireV1AttachmentsByAttachmentIdResponseDto.cs @@ -58,7 +58,7 @@ public record GetHireV1AttachmentsByAttachmentIdResponseDtoAttachment public string? Name { get; set; } /// - /// 附件媒体类型/MIME + /// 附件媒体类型/MIME，遵守统一标准，请参考[百度百科-MIME](https://baike.baidu.com/item/MIME/2900607) /// 必填：否 /// 示例值：application/pdf /// @@ -66,7 +66,7 @@ public record GetHireV1AttachmentsByAttachmentIdResponseDtoAttachment public string? Mime { get; set; } /// - /// 附件创建时间戳（单位ms） + /// 附件创建时间，毫秒时间戳（int64类型） /// 必填：否 /// 示例值：1618899376480 /// diff --git a/src/Hire/GetHireV1EvaluationsResponseDto.cs b/src/Hire/GetHireV1EvaluationsResponseDto.cs index 57ba04c..ec33748 100644 --- a/src/Hire/GetHireV1EvaluationsResponseDto.cs +++ b/src/Hire/GetHireV1EvaluationsResponseDto.cs @@ -9,12 +9,12 @@ // // MIT // -// 获取简历评估信息 响应体 +// 批量获取简历评估信息 响应体 // ************************************************************************ namespace FeishuNetSdk.Hire; /// -/// 获取简历评估信息 响应体 -/// 获取简历评估信息，包含评估人、评估结论、评估详情等信息。支持按照投递 ID、更新时间来进行筛选。 +/// 批量获取简历评估信息 响应体 +/// 批量获取简历评估信息，包含评估人、评估结论、评估详情等信息。支持按照投递 ID、更新时间来进行筛选。 /// 接口ID：7062626037662892033 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/candidate-management/delivery-process-management/evaluation/list /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2fevaluation%2flist @@ -122,7 +122,7 @@ public record Evaluation public string? Content { get; set; } /// - /// 面试评估创建时间，毫秒时间戳 + /// 简历评估创建时间，毫秒时间戳 /// 必填：否 /// 示例值：1600843767338 /// @@ -130,7 +130,7 @@ public record Evaluation public string? CreateTime { get; set; } /// - /// 面试评估更新时间，毫秒时间戳 + /// 简历评估更新时间，毫秒时间戳 /// 必填：否 /// 示例值：1600843937733 /// diff --git a/src/Hire/GetHireV1InterviewRecordsAttachmentsResponseDto.cs b/src/Hire/GetHireV1InterviewRecordsAttachmentsResponseDto.cs index 0ac14cb..b585bf6 100644 --- a/src/Hire/GetHireV1InterviewRecordsAttachmentsResponseDto.cs +++ b/src/Hire/GetHireV1InterviewRecordsAttachmentsResponseDto.cs @@ -58,7 +58,8 @@ public record AttachmentInfo public string? Name { get; set; } /// - /// 附件媒体类型/MIME + /// 附件媒体类型/[MIME](https://baike.baidu.com/item/MIME/2900607?fr=ge_ala#2) + /// **说明**：该接口固定返回 `application/pdf` /// 必填：否 /// 示例值：application/pdf /// diff --git a/src/Hire/GetHireV1InterviewRecordsByInterviewRecordIdResponseDto.cs b/src/Hire/GetHireV1InterviewRecordsByInterviewRecordIdResponseDto.cs index e8af979..3bd7233 100644 --- a/src/Hire/GetHireV1InterviewRecordsByInterviewRecordIdResponseDto.cs +++ b/src/Hire/GetHireV1InterviewRecordsByInterviewRecordIdResponseDto.cs @@ -410,7 +410,7 @@ public record AttachmentV2 public string? Name { get; set; } /// - /// 图片附件类型（MIME） + /// 图片附件类型（[MIME](https://baike.baidu.com/item/MIME/2900607?fr=ge_ala#2)） /// 必填：否 /// 示例值：image/jpg /// @@ -476,7 +476,7 @@ public record I18n } /// - /// 打分题总分，仅当维度评价方式为「打分题(单选)」、「打分题(填空)」时可用 + /// 打分题总分，仅当维度评价方式为 `打分题(单选)`、`打分题(填空)` 时可用 /// 必填：否 /// 示例值：100 /// @@ -484,7 +484,7 @@ public record I18n public int? FullScore { get; set; } /// - /// 当维度评价方式为「描述题」时，从此取值 + /// 当维度评价方式为 `描述题` 时，从此取值 /// 必填：否 /// 示例值：这个候选人还不错 /// @@ -500,14 +500,14 @@ public record I18n public string? DimensionId { get; set; } /// - /// 当维度评价方式为「单选题」「/打分题(单选)」时，从此取值 + /// 当维度评价方式为 `单选题`/`打分题(单选)` 时，从此取值 /// 必填：否 /// [JsonPropertyName("dimension_score")] public InterviewDimensionScore? DimensionScore { get; set; } /// - /// 当维度评价方式为「单选题」「/打分题(单选)」时，从此取值 + /// 当维度评价方式为 `单选题`/`打分题(单选)` 时，从此取值 /// public record InterviewDimensionScore { @@ -549,7 +549,7 @@ public record I18n } /// - /// 选项对应的分数，维度评价为方式「打分题(单选)」时关注该字段 + /// 选项对应的分数，维度评价为方式 `打分题(单选)` 时关注该字段 /// 必填：否 /// 示例值：10 /// @@ -558,14 +558,14 @@ public record I18n } /// - /// 当维度评价方式为「多选题」时，从此取值 + /// 当维度评价方式为 `多选题` 时，从此取值 /// 必填：否 /// [JsonPropertyName("dimension_score_list")] public InterviewDimensionScore[]? DimensionScoreLists { get; set; } /// - /// 当维度评价方式为「打分题(填空)时」，从此取值 + /// 当维度评价方式为 `打分题(填空)时`，从此取值 /// 必填：否 /// 示例值：10 /// diff --git a/src/Hire/GetHireV1InterviewRegistrationSchemasResponseDto.cs b/src/Hire/GetHireV1InterviewRegistrationSchemasResponseDto.cs index 4ea6d3d..a7cc3a9 100644 --- a/src/Hire/GetHireV1InterviewRegistrationSchemasResponseDto.cs +++ b/src/Hire/GetHireV1InterviewRegistrationSchemasResponseDto.cs @@ -9,12 +9,12 @@ // // MIT // -// 获取面试登记表模板列表 响应体 +// 获取面试登记表列表 响应体 // ************************************************************************ namespace FeishuNetSdk.Hire; /// -/// 获取面试登记表模板列表 响应体 -/// 获取面试登记表模板列表。 +/// 获取面试登记表列表 响应体 +/// 获取面试登记表列表，可获取到的信息包括登记表名称、登记表模块、登记表字段 /// 接口ID：7063273947417247745 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/recruitment-related-configuration/interview-settings/list-3 /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2finterview_registration_schema%2flist @@ -22,19 +22,19 @@ namespace FeishuNetSdk.Hire; public record GetHireV1InterviewRegistrationSchemasResponseDto { /// - /// 列表 + /// 面试登记表列表 /// 必填：否 /// [JsonPropertyName("items")] public InterviewRegistrationSchema[]? Items { get; set; } /// - /// 列表 + /// 面试登记表列表 /// public record InterviewRegistrationSchema { /// - /// 面试登记表模板 ID + /// 面试登记表 ID /// 必填：否 /// 示例值：7044739584859326764 /// @@ -42,7 +42,7 @@ public record InterviewRegistrationSchema public string? Id { get; set; } /// - /// 面试登记表模板名称 + /// 面试登记表名称 /// 必填：否 /// 示例值：默认面试登记表 /// @@ -50,7 +50,9 @@ public record InterviewRegistrationSchema public string? Name { get; set; } /// - /// 是否用作面试登记表 + /// 是否用作全局面试登记表： + /// - `true`：全局面试登记表，全部职位都应用该登记表 + /// - `false`：非全局面试登记表，可按职位选择该登记表 /// 必填：否 /// 示例值：true /// @@ -90,17 +92,17 @@ public record CommonSchema public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：登记表模块 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：interview module /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -126,7 +128,7 @@ public record I18n public record CommonSchemaSetting { /// - /// 字段类型 + /// 字段类型，在模块信息中该字段将固定返回`11` /// 必填：否 /// 示例值：1 /// 可选值： @@ -160,14 +162,14 @@ public record CommonSchemaSetting public record CommonSchemaConfig { /// - /// 选项信息 + /// 选项信息，仅在类型object_type为单选、多选时有值 /// 必填：否 /// [JsonPropertyName("options")] public CommonSchemaOption[]? Options { get; set; } /// - /// 选项信息 + /// 选项信息，仅在类型object_type为单选、多选时有值 /// public record CommonSchemaOption { @@ -192,17 +194,17 @@ public record CommonSchemaOption public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：模块选项 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：module option /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -231,7 +233,9 @@ public record I18n } /// - /// 是否是自定义模块 + /// 是否是自定义模块： + /// - `true`：自定义模块 + /// - `false`：系统预置模块 /// 必填：否 /// 示例值：true /// @@ -239,7 +243,9 @@ public record I18n public bool? IsCustomized { get; set; } /// - /// 是否必填 + /// 是否必填： + /// - `true`：必填 + /// - `false`：非必填 /// 必填：否 /// 示例值：false /// @@ -247,7 +253,9 @@ public record I18n public bool? IsRequired { get; set; } /// - /// 是否可见 + /// 是否可见： + /// - `true`：可见 + /// - `false`：不可见 /// 必填：否 /// 示例值：true /// @@ -299,17 +307,17 @@ public record CommonSchemaChild public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：登记表字段 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：interview registration field /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -369,21 +377,21 @@ public record CommonSchemaSetting public record CommonSchemaConfig { /// - /// 选项信息 + /// 选项信息，仅在字段类型object_type为单选、多选时有值 /// 必填：否 /// [JsonPropertyName("options")] public CommonSchemaOption[]? Options { get; set; } /// - /// 选项信息 + /// 选项信息，仅在字段类型object_type为单选、多选时有值 /// public record CommonSchemaOption { /// /// 选项 ID /// 必填：否 - /// 示例值：test + /// 示例值：1 /// [JsonPropertyName("key")] public string? Key { get; set; } @@ -401,17 +409,17 @@ public record CommonSchemaOption public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：选项A /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：option A /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -448,7 +456,9 @@ public record I18n public string? ParentId { get; set; } /// - /// 是否是自定义字段 + /// 是否是自定义字段： + /// - `true`：自定义字段 + /// - `false`：系统预置字段 /// 必填：否 /// 示例值：true /// @@ -456,7 +466,9 @@ public record I18n public bool? IsCustomized { get; set; } /// - /// 是否必填 + /// 是否必填： + /// - `true`：必填 + /// - `false`：非必填 /// 必填：否 /// 示例值：false /// @@ -464,7 +476,9 @@ public record I18n public bool? IsRequired { get; set; } /// - /// 是否可见 + /// 是否可见： + /// - `true`：可见 + /// - `false`：不可见 /// 必填：否 /// 示例值：true /// diff --git a/src/Hire/GetHireV1InterviewersResponseDto.cs b/src/Hire/GetHireV1InterviewersResponseDto.cs new file mode 100644 index 0000000..737fe7a --- /dev/null +++ b/src/Hire/GetHireV1InterviewersResponseDto.cs @@ -0,0 +1,72 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-08-28 +// +// Last Modified By : yxr +// Last Modified On : 2024-08-28 +// ************************************************************************ +// +// MIT +// +// 查询面试官信息列表 响应体 +// ************************************************************************ +namespace FeishuNetSdk.Hire; +/// +/// 查询面试官信息列表 响应体 +/// 分页查询面试官列表，接口只会返回执行过「更新面试官信息」用户的数据，通过接口查询不到的数据则默认为「未认证」面试官。接口默认按更新时间、user_id顺序进行顺序拉取。 +/// 接口ID：7372229724359835649 +/// 文档地址：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/interviewer/list +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2finterviewer%2flist +/// +public record GetHireV1InterviewersResponseDto +{ + /// + /// 面试官信息 + /// 必填：否 + /// + [JsonPropertyName("items")] + public Interviewer[]? Items { get; set; } + + /// + /// 面试官信息 + /// + public record Interviewer + { + /// + /// 面试官userID + /// 必填：否 + /// 示例值：ou_7dab8a3d3cdcc9da365777c7ad535d62 + /// + [JsonPropertyName("user_id")] + public string? UserId { get; set; } + + /// + /// 认证状态 + /// 必填：否 + /// 示例值：1 + /// 可选值： + /// 1：未认证 + /// 2：已认证 + /// + /// + [JsonPropertyName("verify_status")] + public int? VerifyStatus { get; set; } + } + + /// + /// 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token + /// 必填：否 + /// 示例值：eVQrYzJBNDNONlk4VFZBZVlSdzlKdFJ4bVVHVExENDNKVHoxaVdiVnViQT0= + /// + [JsonPropertyName("page_token")] + public string? PageToken { get; set; } + + /// + /// 是否还有更多项 + /// 必填：否 + /// 示例值：true + /// + [JsonPropertyName("has_more")] + public bool? HasMore { get; set; } +} diff --git a/src/Hire/GetHireV1JobProcessesResponseDto.cs b/src/Hire/GetHireV1JobProcessesResponseDto.cs index f5235ac..a6f4b7a 100644 --- a/src/Hire/GetHireV1JobProcessesResponseDto.cs +++ b/src/Hire/GetHireV1JobProcessesResponseDto.cs @@ -38,14 +38,14 @@ public record GetHireV1JobProcessesResponseDto public string? PageToken { get; set; } /// - /// 列表 + /// 流程列表 /// 必填：否 /// [JsonPropertyName("items")] public JobProcesses[]? Items { get; set; } /// - /// 列表 + /// 流程列表 /// public record JobProcesses { diff --git a/src/Hire/GetHireV1JobRequirementSchemasResponseDto.cs b/src/Hire/GetHireV1JobRequirementSchemasResponseDto.cs index 8822ade..e0d3daa 100644 --- a/src/Hire/GetHireV1JobRequirementSchemasResponseDto.cs +++ b/src/Hire/GetHireV1JobRequirementSchemasResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 获取招聘需求模板列表 响应体 -/// 获取招聘需求模板列表，包含需求模板ID，以及模板里的字段定义等。 +/// 获取招聘需求模板列表，包含需求模板ID，以及模板里的字段定义等。招聘需求模板可参考「飞书招聘」-「设置」-「招聘需求字段管理」。 /// 接口ID：6989078472837234691 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/recruitment-related-configuration/job_requirement/list /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2fjob_requirement_schema%2flist @@ -245,6 +245,8 @@ public record I18n /// /// 是否是自定义模块 + /// - true：自定义模块 + /// - false：系统预制模块 /// 必填：否 /// 示例值：true /// @@ -454,6 +456,8 @@ public record I18n /// /// 是否是自定义字段 + /// - true：自定义字段 + /// - false：系统预制字段 /// 必填：否 /// 示例值：true /// diff --git a/src/Hire/GetHireV1JobRequirementsResponseDto.cs b/src/Hire/GetHireV1JobRequirementsResponseDto.cs index 48c0ba4..eccde53 100644 --- a/src/Hire/GetHireV1JobRequirementsResponseDto.cs +++ b/src/Hire/GetHireV1JobRequirementsResponseDto.cs @@ -264,7 +264,7 @@ public record I18n public int? RequiredDegree { get; set; } /// - /// 最高薪资，单位：千 + /// 月薪范围-最高薪资，单位：K /// 必填：否 /// 示例值：123 /// @@ -272,7 +272,7 @@ public record I18n public string? MaxSalary { get; set; } /// - /// 最低薪资，单位：千 + /// 月薪范围-最低薪资，单位：K /// 必填：否 /// 示例值：11 /// diff --git a/src/Hire/GetHireV1JobSchemasResponseDto.cs b/src/Hire/GetHireV1JobSchemasResponseDto.cs index e040b46..3f3e759 100644 --- a/src/Hire/GetHireV1JobSchemasResponseDto.cs +++ b/src/Hire/GetHireV1JobSchemasResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 获取职位模板 响应体 -/// 获取社招、校招职位模板中的职位字段，包括系统默认字段和自定义字段。 +/// 获取社招、校招职位模板中的职位字段，返回结果包括系统默认字段和自定义字段。招聘管理员可在「飞书招聘」-「设置」-「职位管理」-「职位字段管理」中修改职位模板。 /// 接口ID：6989078472837251075 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/recruitment-related-configuration/job/list /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2fjob_schema%2flist @@ -22,14 +22,14 @@ namespace FeishuNetSdk.Hire; public record GetHireV1JobSchemasResponseDto { /// - /// 数据列表 + /// 职位模板列表 /// 必填：否 /// [JsonPropertyName("items")] public JobSchema[]? Items { get; set; } /// - /// 数据列表 + /// 职位模板列表 /// public record JobSchema { @@ -54,17 +54,17 @@ public record JobSchema public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：社招模板 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：Social Job Template /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -115,17 +115,17 @@ public record CommonSchema public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：基础信息 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：Basic info /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -151,7 +151,7 @@ public record I18n public record CommonSchemaSetting { /// - /// 字段类型 + /// 类型，目前仅支持`11` /// 必填：否 /// 示例值：1 /// 可选值： @@ -173,14 +173,14 @@ public record CommonSchemaSetting public int? ObjectType { get; set; } /// - /// 配置信息 + /// 模块配置信息 /// 必填：否 /// [JsonPropertyName("config")] public CommonSchemaConfig? Config { get; set; } /// - /// 配置信息 + /// 模块配置信息 /// public record CommonSchemaConfig { @@ -199,7 +199,7 @@ public record CommonSchemaOption /// /// 选项 ID /// 必填：否 - /// 示例值：test + /// 示例值：1 /// [JsonPropertyName("key")] public string? Key { get; set; } @@ -217,17 +217,17 @@ public record CommonSchemaOption public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：选项A /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：Option A /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -257,6 +257,9 @@ public record I18n /// /// 是否是自定义模块 + /// **可选值有**： + /// * `true`：自定义模块 + /// * `false`：系统默认模块 /// 必填：否 /// 示例值：true /// @@ -265,6 +268,9 @@ public record I18n /// /// 是否必填 + /// **可选值有**： + /// * `true`：必填 + /// * `false`：非必填 /// 必填：否 /// 示例值：false /// @@ -316,17 +322,17 @@ public record CommonSchemaChild public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：职位类型 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：Job type /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -352,7 +358,7 @@ public record I18n public record CommonSchemaSetting { /// - /// 字段类型 + /// 字段类型，目前仅支持`1`/`2`/`3`/`4`/`5`/`9`/`10` /// 必填：否 /// 示例值：1 /// 可选值： @@ -374,33 +380,33 @@ public record CommonSchemaSetting public int? ObjectType { get; set; } /// - /// 配置信息 + /// 字段配置信息 /// 必填：否 /// [JsonPropertyName("config")] public CommonSchemaConfig? Config { get; set; } /// - /// 配置信息 + /// 字段配置信息 /// public record CommonSchemaConfig { /// - /// 选项信息 + /// 选项信息，当`object_type `为`3`（单选）或`4`（多选）时有值 /// 必填：否 /// [JsonPropertyName("options")] public CommonSchemaOption[]? Options { get; set; } /// - /// 选项信息 + /// 选项信息，当`object_type `为`3`（单选）或`4`（多选）时有值 /// public record CommonSchemaOption { /// /// 选项 ID /// 必填：否 - /// 示例值：test + /// 示例值：111 /// [JsonPropertyName("key")] public string? Key { get; set; } @@ -418,17 +424,17 @@ public record CommonSchemaOption public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：类型A /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：Type A /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -457,7 +463,7 @@ public record I18n } /// - /// 所属模块 ID + /// 所属模块 ID，对应外层`object_list.id`字段 /// 必填：否 /// 示例值：6949805467799537964 /// @@ -466,6 +472,9 @@ public record I18n /// /// 是否是自定义字段 + /// **可选值有**： + /// * `true`：自定义字段 + /// * `false`：系统默认字段 /// 必填：否 /// 示例值：true /// @@ -474,6 +483,9 @@ public record I18n /// /// 是否必填 + /// **可选值有**： + /// * `true`：必填 + /// * `false`：非必填 /// 必填：否 /// 示例值：false /// diff --git a/src/Hire/GetHireV1JobTypesResponseDto.cs b/src/Hire/GetHireV1JobTypesResponseDto.cs index 2d98cee..ea1684c 100644 --- a/src/Hire/GetHireV1JobTypesResponseDto.cs +++ b/src/Hire/GetHireV1JobTypesResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 获取职位类别列表 响应体 -/// 获取职位类别列表，用于在操作职位/招聘需求时获取职位类别枚举，默认以创建时间升序排序，返回值中包含从属关系，可在获取全量数据后自行构建职位类别树，所有节点均可用于回填职位/招聘需求中的职位类别字段 +/// 获取招聘系统预置的职位类别列表，可用于操作职位（如[新建职位](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job/combined_create)），操作招聘需求（如[创建招聘需求](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_requirement/create)）时回填职位类别字段。返回列表默认按创建时间升序排序，且包含节点的层级关系（节点的父节点 ID），可在获取全量数据后自行构建职位类别树。 /// 接口ID：7287407243900895234 /// 文档地址：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_type/list /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2fjob_type%2flist @@ -25,6 +25,7 @@ public record GetHireV1JobTypesResponseDto /// 职位类别列表 /// 必填：否 /// 最大长度：100 + /// 最小长度：0 /// [JsonPropertyName("items")] public JobTypeInfo[]? Items { get; set; } @@ -35,7 +36,7 @@ public record GetHireV1JobTypesResponseDto public record JobTypeInfo { /// - /// 职位类别ID + /// 职位类别 ID /// 必填：是 /// 示例值：6930815272790114324 /// @@ -72,7 +73,7 @@ public record I18n } /// - /// 父级职位类别ID + /// 父级职位类别 ID /// 必填：否 /// 示例值：6930815272790114323 /// diff --git a/src/Hire/GetHireV1JobsResponseDto.cs b/src/Hire/GetHireV1JobsResponseDto.cs index 32b8782..94988b2 100644 --- a/src/Hire/GetHireV1JobsResponseDto.cs +++ b/src/Hire/GetHireV1JobsResponseDto.cs @@ -151,7 +151,7 @@ public record JobRecruitmentType public record JobDepartment { /// - /// 部门 ID，与入参中的`department_id_type`类型一致，详情请查看：[批量查询部门](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/department/list) + /// 部门 ID，与入参中的`department_id_type`类型一致 /// 必填：否 /// 示例值：od-xxxx /// @@ -225,7 +225,7 @@ public record JobCity public record JobLevel { /// - /// 职级 ID，与入参`job_level_id_type` 类型一致，详情请查看：[获取租户职级列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/job_level/list) + /// 职级 ID，与入参`job_level_id_type` 类型一致 /// 必填：否 /// 示例值：7379609334215919883 /// @@ -318,7 +318,7 @@ public record JobHighlight public record JobJobCategory { /// - /// 职位序列 ID，与入参`job_family_id_type` 类型一致，详情请查看：[获取租户序列列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/job_family/list) + /// 职位序列 ID，与入参`job_family_id_type` 类型一致 /// 必填：否 /// 示例值：7379609334215919883 /// @@ -555,7 +555,7 @@ public record I18n public long? ExpiryTime { get; set; } /// - /// 最低薪资，单位：千 + /// 最低薪资，单位：K /// 必填：否 /// 示例值：10 /// @@ -563,7 +563,7 @@ public record I18n public int? MinSalary { get; set; } /// - /// 最高薪资，单位：千 + /// 最高薪资，单位：K /// 必填：否 /// 示例值：20 /// diff --git a/src/Hire/GetHireV1MinutesResponseDto.cs b/src/Hire/GetHireV1MinutesResponseDto.cs new file mode 100644 index 0000000..44b72ce --- /dev/null +++ b/src/Hire/GetHireV1MinutesResponseDto.cs @@ -0,0 +1,122 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-08-28 +// +// Last Modified By : yxr +// Last Modified On : 2024-08-28 +// ************************************************************************ +// +// MIT +// +// 获取面试速记明细 响应体 +// ************************************************************************ +namespace FeishuNetSdk.Hire; +/// +/// 获取面试速记明细 响应体 +/// 获取指定面试的面试速记明细记录 +/// 接口ID：7397616200375304220 +/// 文档地址：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/minutes/get +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2fminutes%2fget +/// +public record GetHireV1MinutesResponseDto +{ + /// + /// 面试速记 + /// 必填：否 + /// + [JsonPropertyName("minutes")] + public GetHireV1MinutesResponseDtoMinutes? Minutes { get; set; } + + /// + /// 面试速记 + /// + public record GetHireV1MinutesResponseDtoMinutes + { + /// + /// 速记句子列表 + /// 必填：否 + /// + [JsonPropertyName("sentences")] + public Sentence[]? Sentences { get; set; } + + /// + /// 速记句子列表 + /// + public record Sentence + { + /// + /// 速记句子文本 + /// 必填：否 + /// 示例值：你好，可以做一下自我介绍么？ + /// + [JsonPropertyName("content")] + public string? Content { get; set; } + + /// + /// 句子开始讲话的时间，毫秒时间戳 + /// 必填：否 + /// 示例值：1720967514994 + /// + [JsonPropertyName("speak_time")] + public string? SpeakTime { get; set; } + + /// + /// 句子说话人的用户类型 + /// 必填：否 + /// 示例值：1 + /// 可选值： + /// 1：面试官 + /// 2：候选人 + /// + /// + [JsonPropertyName("user_type")] + public int? UserType { get; set; } + + /// + /// 句子说话人名字 + /// 必填：否 + /// + [JsonPropertyName("speaker_name")] + public I18n? SpeakerName { get; set; } + + /// + /// 句子说话人名字 + /// + public record I18n + { + /// + /// 说话人的中文名称 + /// 必填：否 + /// 示例值：张三 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 说话人的英文名称 + /// 必填：否 + /// 示例值：Zhang San + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + } + } + + /// + /// 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token + /// 必填：否 + /// 示例值：NzM5MTgyNjQyNDY2MDc4OTU0OA== + /// + [JsonPropertyName("page_token")] + public string? PageToken { get; set; } + + /// + /// 是否还有更多项 + /// 必填：否 + /// 示例值：true + /// + [JsonPropertyName("has_more")] + public bool? HasMore { get; set; } +} diff --git a/src/Hire/GetHireV1QuestionnairesResponseDto.cs b/src/Hire/GetHireV1QuestionnairesResponseDto.cs index 273847c..f7abc80 100644 --- a/src/Hire/GetHireV1QuestionnairesResponseDto.cs +++ b/src/Hire/GetHireV1QuestionnairesResponseDto.cs @@ -269,12 +269,12 @@ public record QuestionFiveStartScoringResult public string? LowestScoreEnDesc { get; set; } /// - /// 评分分数 + /// 评分分数（整数） /// 必填：否 /// 示例值：4 /// [JsonPropertyName("score_result")] - public float? ScoreResult { get; set; } + public int? ScoreResult { get; set; } } /// @@ -297,7 +297,7 @@ public record QuestionFiveStartScoringResult public bool? HasAnswers { get; set; } /// - /// 满意度问卷更新时间 + /// 满意度问卷更新时间，毫秒时间戳 /// 必填：否 /// 示例值：1644412504000 /// diff --git a/src/Hire/GetHireV1ReferralWebsitesJobPostsByJobPostIdResponseDto.cs b/src/Hire/GetHireV1ReferralWebsitesJobPostsByJobPostIdResponseDto.cs index 8fea8cc..0d5435a 100644 --- a/src/Hire/GetHireV1ReferralWebsitesJobPostsByJobPostIdResponseDto.cs +++ b/src/Hire/GetHireV1ReferralWebsitesJobPostsByJobPostIdResponseDto.cs @@ -42,7 +42,7 @@ public record PortalJobPost public string? Id { get; set; } /// - /// 职位广告名称 + /// 职位名称 /// 必填：否 /// 示例值：高级工程师招聘 /// @@ -66,7 +66,7 @@ public record PortalJobPost public string? JobCode { get; set; } /// - /// 职位到期时间，毫秒时间戳，「null」代表「长期有效」 + /// 职位到期时间，毫秒时间戳，空代表「长期有效」 /// 必填：否 /// 示例值：1722837278000 /// @@ -98,19 +98,19 @@ public record PortalJobPost public int? JobProcessType { get; set; } /// - /// 职位雇佣类型，请参考[枚举常量介绍](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/enum) + /// 雇佣类型，请参考[枚举常量介绍](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/enum) /// 必填：否 /// [JsonPropertyName("job_recruitment_type")] public IdNameObject? JobRecruitmentType { get; set; } /// - /// 职位雇佣类型，请参考[枚举常量介绍](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/enum) + /// 雇佣类型，请参考[枚举常量介绍](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/enum) /// public record IdNameObject { /// - /// 职位雇佣类型ID + /// 雇佣类型ID /// 必填：否 /// 示例值：101 /// @@ -118,14 +118,14 @@ public record IdNameObject public string? Id { get; set; } /// - /// 职位雇佣类型名称 + /// 雇佣类型名称 /// 必填：否 /// [JsonPropertyName("name")] public I18n? Name { get; set; } /// - /// 职位雇佣类型名称 + /// 雇佣类型名称 /// public record I18n { @@ -155,7 +155,7 @@ public record I18n public IdNameObject? JobDepartment { get; set; } /// - /// 职位类型 + /// 职位类别 /// 必填：否 /// [JsonPropertyName("job_type")] @@ -297,7 +297,7 @@ public record I18n } /// - /// 月薪范围-最低薪资，单位：K + /// 月薪范围-最低薪资，单位：K，精度：整数 /// 必填：否 /// 示例值：5 /// @@ -305,7 +305,7 @@ public record I18n public string? MinSalary { get; set; } /// - /// 月薪范围-最高薪资，单位：K + /// 月薪范围-最高薪资，单位：K，精度：整数 /// 必填：否 /// 示例值：20 /// diff --git a/src/Hire/GetHireV1ReferralWebsitesJobPostsResponseDto.cs b/src/Hire/GetHireV1ReferralWebsitesJobPostsResponseDto.cs index a52a472..9334cd9 100644 --- a/src/Hire/GetHireV1ReferralWebsitesJobPostsResponseDto.cs +++ b/src/Hire/GetHireV1ReferralWebsitesJobPostsResponseDto.cs @@ -42,7 +42,7 @@ public record PortalJobPost public string? Id { get; set; } /// - /// 职位广告名称 + /// 职位名称 /// 必填：否 /// 示例值：高级工程师招聘 /// @@ -66,7 +66,7 @@ public record PortalJobPost public string? JobCode { get; set; } /// - /// 职位到期时间，毫秒时间戳，「null」代表「长期有效」 + /// 职位到期时间，毫秒时间戳，空代表「长期有效」 /// 必填：否 /// 示例值：1722837278000 /// @@ -98,19 +98,19 @@ public record PortalJobPost public int? JobProcessType { get; set; } /// - /// 职位雇佣类型，请参考[枚举常量介绍](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/enum) + /// 雇佣类型，请参考[枚举常量介绍](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/enum) /// 必填：否 /// [JsonPropertyName("job_recruitment_type")] public IdNameObject? JobRecruitmentType { get; set; } /// - /// 职位雇佣类型，请参考[枚举常量介绍](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/enum) + /// 雇佣类型，请参考[枚举常量介绍](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/enum) /// public record IdNameObject { /// - /// 职位雇佣类型ID + /// 雇佣类型ID /// 必填：否 /// 示例值：101 /// @@ -118,14 +118,14 @@ public record IdNameObject public string? Id { get; set; } /// - /// 职位雇佣类型名称 + /// 雇佣类型名称 /// 必填：否 /// [JsonPropertyName("name")] public I18n? Name { get; set; } /// - /// 职位雇佣类型名称 + /// 雇佣类型名称 /// public record I18n { @@ -297,7 +297,7 @@ public record I18n } /// - /// 月薪范围-最低薪资，单位：K + /// 月薪范围-最低薪资，单位：K，精度：整数 /// 必填：否 /// 示例值：5 /// @@ -305,7 +305,7 @@ public record I18n public string? MinSalary { get; set; } /// - /// 月薪范围-最高薪资，单位：K + /// 月薪范围-最高薪资，单位：K，精度：整数 /// 必填：否 /// 示例值：50 /// diff --git a/src/Hire/GetHireV1ReferralsGetByApplicationResponseDto.cs b/src/Hire/GetHireV1ReferralsGetByApplicationResponseDto.cs index 1e45c59..dd6d4f2 100644 --- a/src/Hire/GetHireV1ReferralsGetByApplicationResponseDto.cs +++ b/src/Hire/GetHireV1ReferralsGetByApplicationResponseDto.cs @@ -50,7 +50,7 @@ public record GetHireV1ReferralsGetByApplicationResponseDtoReferral public string ApplicationId { get; set; } = string.Empty; /// - /// 创建时间，毫秒时间戳 + /// 创建时间(int64类型)，毫秒时间戳 /// 必填：是 /// 示例值：1618899376474 /// @@ -86,19 +86,19 @@ public record IdNameObject public string? Id { get; set; } /// - /// 内推人名称 + /// 内推人姓名 /// 必填：否 /// [JsonPropertyName("name")] public I18n? Name { get; set; } /// - /// 内推人名称 + /// 内推人姓名 /// public record I18n { /// - /// 中文名称 + /// 中文姓名 /// 必填：否 /// 示例值：张三 /// @@ -106,7 +106,7 @@ public record I18n public string? ZhCn { get; set; } /// - /// 英文名称 + /// 英文姓名 /// 必填：否 /// 示例值：zhangsan /// diff --git a/src/Hire/GetHireV1RegistrationSchemasResponseDto.cs b/src/Hire/GetHireV1RegistrationSchemasResponseDto.cs index 908a736..7522f1e 100644 --- a/src/Hire/GetHireV1RegistrationSchemasResponseDto.cs +++ b/src/Hire/GetHireV1RegistrationSchemasResponseDto.cs @@ -9,12 +9,12 @@ // // MIT // -// 获取信息登记表模板列表 响应体 +// 获取信息登记表列表 响应体 // ************************************************************************ namespace FeishuNetSdk.Hire; /// -/// 获取信息登记表模板列表 响应体 -/// 获取信息登记表模板列表 +/// 获取信息登记表列表 响应体 +/// 根据适用场景获取信息登记表列表，可获取到的信息包括登记表名称、登记表模块、登记表字段等 /// 接口ID：7259225956346232860 /// 文档地址：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/registration_schema/list /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2fregistration_schema%2flist @@ -34,7 +34,7 @@ public record GetHireV1RegistrationSchemasResponseDto public record RegistrationSchema { /// - /// 信息登记表模板 ID + /// 信息登记表 ID /// 必填：否 /// 示例值：7044739584859326764 /// @@ -42,7 +42,7 @@ public record RegistrationSchema public string? Id { get; set; } /// - /// 信息登记表模板名称 + /// 信息登记表名称 /// 必填：否 /// 示例值：默认信息登记表 /// @@ -89,17 +89,17 @@ public record CommonSchema public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：简历 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：Resume /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -125,7 +125,7 @@ public record I18n public record CommonSchemaSetting { /// - /// 字段类型 + /// 字段类型，在模块信息中该字段将固定返回`11` /// 必填：否 /// 示例值：1 /// 可选值： @@ -159,21 +159,21 @@ public record CommonSchemaSetting public record CommonSchemaConfig { /// - /// 选项信息 + /// 选项信息，仅在类型`object_type`为单选、多选时有值 /// 必填：否 /// [JsonPropertyName("options")] public CommonSchemaOption[]? Options { get; set; } /// - /// 选项信息 + /// 选项信息，仅在类型`object_type`为单选、多选时有值 /// public record CommonSchemaOption { /// /// 选项 ID /// 必填：否 - /// 示例值：test + /// 示例值：1 /// [JsonPropertyName("key")] public string? Key { get; set; } @@ -191,17 +191,17 @@ public record CommonSchemaOption public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：模块选项 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：module option /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -230,7 +230,9 @@ public record I18n } /// - /// 是否是自定义模块 + /// 是否是自定义模块： + /// - `true`：自定义模块 + /// - `false`：系统预置模块 /// 必填：否 /// 示例值：true /// @@ -238,7 +240,9 @@ public record I18n public bool? IsCustomized { get; set; } /// - /// 是否必填 + /// 是否必填： + /// - `true`：必填 + /// - `false`：非必填 /// 必填：否 /// 示例值：false /// @@ -246,7 +250,9 @@ public record I18n public bool? IsRequired { get; set; } /// - /// 是否可见 + /// 是否可见： + /// - `true`：可见 + /// - `false`：不可见 /// 必填：否 /// 示例值：true /// @@ -298,17 +304,17 @@ public record CommonSchemaChild public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：简历自定义字段 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：resume custom field /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -368,21 +374,21 @@ public record CommonSchemaSetting public record CommonSchemaConfig { /// - /// 选项信息 + /// 选项信息，仅在字段类型object_type为单选、多选时有值 /// 必填：否 /// [JsonPropertyName("options")] public CommonSchemaOption[]? Options { get; set; } /// - /// 选项信息 + /// 选项信息，仅在字段类型object_type为单选、多选时有值 /// public record CommonSchemaOption { /// /// 选项 ID /// 必填：否 - /// 示例值：test + /// 示例值：1 /// [JsonPropertyName("key")] public string? Key { get; set; } @@ -400,17 +406,17 @@ public record CommonSchemaOption public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：字段选项 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：option for field /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -439,7 +445,7 @@ public record I18n } /// - /// 所属模块 ID + /// 所属模块 ID，即外层的object.id /// 必填：否 /// 示例值：6949805467799537964 /// @@ -447,7 +453,9 @@ public record I18n public string? ParentId { get; set; } /// - /// 是否是自定义字段 + /// 是否是自定义字段： + /// - `true`：自定义字段 + /// - `false`：系统预置字段 /// 必填：否 /// 示例值：true /// @@ -455,7 +463,9 @@ public record I18n public bool? IsCustomized { get; set; } /// - /// 是否必填 + /// 是否必填： + /// - `true`：必填 + /// - `false`：非必填 /// 必填：否 /// 示例值：false /// @@ -463,7 +473,9 @@ public record I18n public bool? IsRequired { get; set; } /// - /// 是否可见 + /// 是否可见： + /// - `true`：可见 + /// - `false`：不可见 /// 必填：否 /// 示例值：true /// diff --git a/src/Hire/GetHireV1RolesByRoleIdResponseDto.cs b/src/Hire/GetHireV1RolesByRoleIdResponseDto.cs index 70d7bbe..a393563 100644 --- a/src/Hire/GetHireV1RolesByRoleIdResponseDto.cs +++ b/src/Hire/GetHireV1RolesByRoleIdResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 获取角色详情 响应体 -/// 获取角色详情信息，包括名称、描述、权限列表等（适用于新版权限，关于新旧权限主要差异：新权限体系中区分了校社招，并将权限点区分了功能权限、字段权限、数据权限）。 +/// 切到新版权限系统后，可通过此接口获取角色详情信息，包括名称、描述、权限列表等 /// 接口ID：7351241605105090564 /// 文档地址：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/role/get /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2frole%2fget @@ -34,7 +34,7 @@ public record GetHireV1RolesByRoleIdResponseDto public record RoleDetail { /// - /// 角色ID + /// 角色 ID /// 必填：否 /// 示例值：6930815272790114324 /// @@ -56,7 +56,7 @@ public record I18n /// /// 角色中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：招聘 HRBP /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } @@ -64,7 +64,7 @@ public record I18n /// /// 角色英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：Recruitment HRBP /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -78,7 +78,7 @@ public record I18n public I18n? Description { get; set; } /// - /// 更新时间 + /// 更新时间，毫秒时间戳 /// 必填：否 /// 示例值：1716535727510 /// @@ -86,7 +86,7 @@ public record I18n public string? ModifyTime { get; set; } /// - /// 停启用状态 + /// 角色启用状态 /// 必填：否 /// 示例值：1 /// 可选值： @@ -111,7 +111,7 @@ public record I18n public int? RoleType { get; set; } /// - /// 适用范围 + /// 角色适用范围 /// 必填：否 /// 示例值：1 /// 可选值： @@ -125,6 +125,8 @@ public record I18n /// /// 是否在角色上配置业务管理范围 + /// - `true`：配置了业务管理范围 + /// - `false`：未配置业务管理范围 /// 必填：否 /// 示例值：true /// @@ -132,14 +134,14 @@ public record I18n public bool? HasBusinessManagementScope { get; set; } /// - /// 社招权限配置 + /// 社招权限配置，仅当`scope_of_application`为“社招”或“都包含”时有值 /// 必填：否 /// [JsonPropertyName("socail_permission_collection")] public PermissionCollection? SocailPermissionCollection { get; set; } /// - /// 社招权限配置 + /// 社招权限配置，仅当`scope_of_application`为“社招”或“都包含”时有值 /// public record PermissionCollection { @@ -156,9 +158,9 @@ public record PermissionCollection public record IdNameObject { /// - /// 权限点ID + /// 权限点 ID /// 必填：否 - /// 示例值：6930815272790114325 + /// 示例值：10101000 /// [JsonPropertyName("id")] public string? Id { get; set; } @@ -178,7 +180,7 @@ public record I18n /// /// 权限点中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：查看人才 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } @@ -186,7 +188,7 @@ public record I18n /// /// 权限点英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：View talent /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -213,9 +215,9 @@ public record I18n public record DataPermission { /// - /// 权限点ID + /// 权限点 ID /// 必填：否 - /// 示例值：6930815272790114324 + /// 示例值：30203005 /// [JsonPropertyName("id")] public string? Id { get; set; } @@ -235,7 +237,7 @@ public record I18n /// /// 权限点中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：私密备注 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } @@ -243,7 +245,7 @@ public record I18n /// /// 权限点英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：Private notes /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -288,7 +290,20 @@ public record BusinessManagementScope public record EntityInfo { /// - /// 实体code + /// 实体code，枚举如下 + /// - `talent`：人才 + /// - `application`：投递 + /// - `interview`：面试 + /// - `interview_appointment_project`：预约面试 + /// - `jobfair`：集中面试 + /// - `exam_session`：集中笔试 + /// - `offer`：Offer + /// - `job`：职位 + /// - `job_recruitment`：招聘需求 + /// - `reward`：内推奖励 + /// - `info_session`：宣讲会 + /// - `bi`：BI + /// - `subject`：对应项目 /// 必填：否 /// 示例值：application /// @@ -310,7 +325,7 @@ public record I18n /// /// 实体中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：投递 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } @@ -318,7 +333,7 @@ public record I18n /// /// 实体英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：Application /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -338,32 +353,32 @@ public record I18n public record PermissionGroupInfo { /// - /// 权限点ID列表 + /// 权限点 ID列表 /// 必填：否 /// [JsonPropertyName("permission_ids")] public string[]? PermissionIds { get; set; } /// - /// 管理范围 + /// 管理范围规则 /// 必填：否 /// [JsonPropertyName("scope_rule")] public PermissionScopeRule? ScopeRule { get; set; } /// - /// 管理范围 + /// 管理范围规则 /// public record PermissionScopeRule { /// - /// 管理范围 + /// 规则类型 /// 必填：否 - /// 示例值：0 + /// 示例值：1 /// 可选值： /// 0：无数据权限 /// 1：全部数据权限 - /// 2：按规则制定范围 + /// 2：按规则指定范围，当前系统暂不支持返回详细规则 /// /// [JsonPropertyName("rule_type")] @@ -374,7 +389,7 @@ public record PermissionScopeRule } /// - /// 校招权限配置 + /// 校招权限配置，仅当`scope_of_application`为“校招”或“都包含”时有值 /// 必填：否 /// [JsonPropertyName("campus_permission_collection")] diff --git a/src/Hire/GetHireV1TalentObjectsQueryResponseDto.cs b/src/Hire/GetHireV1TalentObjectsQueryResponseDto.cs index 7f3d320..9957139 100644 --- a/src/Hire/GetHireV1TalentObjectsQueryResponseDto.cs +++ b/src/Hire/GetHireV1TalentObjectsQueryResponseDto.cs @@ -198,7 +198,9 @@ public record I18n } /// - /// 是否是自定义模块，`true` 为自定义模块， `false` 为系统预置模块 + /// 是否是自定义模块 + /// - `true` 为自定义模块 + /// - `false` 为系统预置模块 /// 必填：否 /// 示例值：true /// @@ -408,7 +410,9 @@ public record I18n public string? ParentId { get; set; } /// - /// 是否是自定义字段，`true` 为自定义字段， `false` 为系统预置字段 + /// 是否是自定义字段 + /// - `true` 为自定义字段 + /// - `false` 为系统预置字段 /// 必填：否 /// 示例值：true /// diff --git a/src/Hire/GetHireV1TalentPoolsResponseDto.cs b/src/Hire/GetHireV1TalentPoolsResponseDto.cs index 29b6a0f..df69c4e 100644 --- a/src/Hire/GetHireV1TalentPoolsResponseDto.cs +++ b/src/Hire/GetHireV1TalentPoolsResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 获取人才库列表 响应体 -/// 获取人才库列表，可获取的信息包括人才库ID、人才库名称等。 +/// 获取人才库列表，可获取的信息包括人才库 ID、人才库名称等。 /// 接口ID：7218853190452428804 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/candidate-management/talent_pool/search /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2ftalent_pool%2fsearch @@ -54,7 +54,7 @@ public record TalentPool public record I18n { /// - /// 中文名称 + /// 人才库中文名称 /// 必填：否 /// 示例值：公共人才库 /// @@ -62,7 +62,7 @@ public record I18n public string? ZhCn { get; set; } /// - /// 英文名称 + /// 人才库英文名称 /// 必填：否 /// 示例值：Common Talent Pool /// diff --git a/src/Hire/GetHireV1TalentsResponseDto.cs b/src/Hire/GetHireV1TalentsResponseDto.cs index f28342a..8e122a0 100644 --- a/src/Hire/GetHireV1TalentsResponseDto.cs +++ b/src/Hire/GetHireV1TalentsResponseDto.cs @@ -284,7 +284,7 @@ public record TalentCityInfo public long? Birthday { get; set; } /// - /// 创建人，与入参 `user_id_type` 类型一致 + /// 创建人 ID，与入参 `user_id_type` 类型一致 /// 必填：否 /// 示例值：ou_4c5ec7005d5e476175d5edfd3f1e5206 /// diff --git a/src/Hire/GetHireV1UserRolesResponseDto.cs b/src/Hire/GetHireV1UserRolesResponseDto.cs new file mode 100644 index 0000000..92e18b6 --- /dev/null +++ b/src/Hire/GetHireV1UserRolesResponseDto.cs @@ -0,0 +1,214 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-08-28 +// +// Last Modified By : yxr +// Last Modified On : 2024-08-28 +// ************************************************************************ +// +// MIT +// +// 获取用户角色列表 响应体 +// ************************************************************************ +namespace FeishuNetSdk.Hire; +/// +/// 获取用户角色列表 响应体 +/// 切到新版权限系统后，可通过该接口获取用户角色列表，基于用户ID、角色ID等条件进行筛选，并通过page_size与page_token进行分页。 +/// 接口ID：7044464966434390044 +/// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/recruitment-related-configuration/auth/list-2 +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2fuser_role%2flist +/// +public record GetHireV1UserRolesResponseDto +{ + /// + /// 用户角色列表 + /// 必填：否 + /// + [JsonPropertyName("items")] + public UserRole[]? Items { get; set; } + + /// + /// 用户角色列表 + /// + public record UserRole + { + /// + /// 用户 ID，与入参 `user_id_type` 类型一致 + /// 必填：否 + /// 示例值：7326856229396906012 + /// + [JsonPropertyName("user_id")] + public string? UserId { get; set; } + + /// + /// 角色 ID，可通过接口 [获取角色列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/role/list) 获取 + /// 必填：否 + /// 示例值：101 + /// + [JsonPropertyName("role_id")] + public string? RoleId { get; set; } + + /// + /// 修改时间，毫秒时间戳 + /// 必填：否 + /// 示例值：1618500278663 + /// + [JsonPropertyName("modify_time")] + public string? ModifyTime { get; set; } + + /// + /// 角色名称 + /// 必填：否 + /// + [JsonPropertyName("role_name")] + public I18n? RoleName { get; set; } + + /// + /// 角色名称 + /// + public record I18n + { + /// + /// 角色中文名称 + /// 必填：否 + /// 示例值：招聘 HRBP + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 角色英文名称 + /// 必填：否 + /// 示例值：Recruitment HRBP + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 角色描述 + /// 必填：否 + /// + [JsonPropertyName("role_description")] + public I18n? RoleDescription { get; set; } + + /// + /// 业务管理范围 + /// 必填：否 + /// + [JsonPropertyName("business_management_scopes")] + public UserBusinessManagementScope[]? BusinessManagementScopes { get; set; } + + /// + /// 业务管理范围 + /// + public record UserBusinessManagementScope + { + /// + /// 实体 + /// 必填：否 + /// + [JsonPropertyName("entity")] + public EntityInfo? Entity { get; set; } + + /// + /// 实体 + /// + public record EntityInfo + { + /// + /// 实体code，枚举如下 + /// - `talent`：人才 + /// - `application`：投递 + /// - `interview`：面试 + /// - `interview_appointment_project`：预约面试 + /// - `jobfair`：集中面试 + /// - `exam_session`：集中笔试 + /// - `offer`：Offer + /// - `job`：职位 + /// - `job_recruitment`：招聘需求 + /// - `reward`：内推奖励 + /// - `info_session`：宣讲会 + /// - `bi`：BI + /// - `subject`：对应项目 + /// 必填：否 + /// 示例值：application + /// + [JsonPropertyName("code")] + public string? Code { get; set; } + + /// + /// 实体名称 + /// 必填：否 + /// + [JsonPropertyName("name")] + public I18n? Name { get; set; } + + /// + /// 实体名称 + /// + public record I18n + { + /// + /// 实体中文名称 + /// 必填：否 + /// 示例值：测试 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 实体英文名称 + /// 必填：否 + /// 示例值：test + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + } + + /// + /// 管理范围规则 + /// 必填：否 + /// + [JsonPropertyName("scope_rule")] + public PermissionScopeRule? ScopeRule { get; set; } + + /// + /// 管理范围规则 + /// + public record PermissionScopeRule + { + /// + /// 规则类型 + /// 必填：否 + /// 示例值：1 + /// 可选值： + /// 0：无数据权限 + /// 1：全部数据权限 + /// 2：按规则制定范围 + /// + /// + [JsonPropertyName("rule_type")] + public int? RuleType { get; set; } + } + } + } + + /// + /// 是否还有更多项 + /// 必填：否 + /// 示例值：true + /// + [JsonPropertyName("has_more")] + public bool? HasMore { get; set; } + + /// + /// 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token + /// 必填：否 + /// 示例值：eyJvZmZzZXQiOjEwLCJ0aW1lc3RhbXAiOjE2Mjc1NTUyMjM2NzIsImlkIjpudWxsfQ== + /// + [JsonPropertyName("page_token")] + public string? PageToken { get; set; } +} diff --git a/src/Hire/GetHireV1WebsitesByWebsiteIdJobPostsResponseDto.cs b/src/Hire/GetHireV1WebsitesByWebsiteIdJobPostsResponseDto.cs index 3b79278..c44033e 100644 --- a/src/Hire/GetHireV1WebsitesByWebsiteIdJobPostsResponseDto.cs +++ b/src/Hire/GetHireV1WebsitesByWebsiteIdJobPostsResponseDto.cs @@ -9,11 +9,11 @@ // // MIT // -// 获取招聘官网下的职位列表 响应体 +// 获取招聘官网下的职位广告列表 响应体 // ************************************************************************ namespace FeishuNetSdk.Hire; /// -/// 获取招聘官网下的职位列表 响应体 +/// 获取招聘官网下的职位广告列表 响应体 /// 获取招聘官网下的职位信息列表。 /// ## 注意事项 /// 该接口暂不支持获取自定义数据。你可使用「获取招聘官网下职位广告详情」接口获取。 diff --git a/src/Hire/PatchHireV1EcoAccountCustomFieldsBatchUpdateBodyDto.cs b/src/Hire/PatchHireV1EcoAccountCustomFieldsBatchUpdateBodyDto.cs index 55c5a81..8a75b86 100644 --- a/src/Hire/PatchHireV1EcoAccountCustomFieldsBatchUpdateBodyDto.cs +++ b/src/Hire/PatchHireV1EcoAccountCustomFieldsBatchUpdateBodyDto.cs @@ -66,7 +66,7 @@ public record EcoAccountCustomFieldData public record I18n { /// - /// 中文名称 + /// 自定义字段中文名称 /// 必填：否 /// 示例值：账号token /// @@ -74,7 +74,7 @@ public record I18n public string? ZhCn { get; set; } /// - /// 英文名称 + /// 自定义字段英文名称 /// 必填：否 /// 示例值：Account token /// diff --git a/src/Hire/PatchHireV1EcoExamPapersBatchUpdateBodyDto.cs b/src/Hire/PatchHireV1EcoExamPapersBatchUpdateBodyDto.cs index 5c55115..244eab6 100644 --- a/src/Hire/PatchHireV1EcoExamPapersBatchUpdateBodyDto.cs +++ b/src/Hire/PatchHireV1EcoExamPapersBatchUpdateBodyDto.cs @@ -9,12 +9,12 @@ // // MIT // -// 更新试卷 请求体 +// 更新试卷列表 请求体 // ************************************************************************ namespace FeishuNetSdk.Hire; /// -/// 更新试卷 请求体 -/// 更新指定帐号可用的试卷列表 +/// 更新试卷列表 请求体 +/// 飞书招聘的笔试服务商，可通过该接口更新客户笔试账号下的试卷列表。 /// 接口ID：7195815979079532545 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/ecological-docking/eco_exam_paper/batch_update /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2feco_exam_paper%2fbatch_update @@ -22,7 +22,7 @@ namespace FeishuNetSdk.Hire; public record PatchHireV1EcoExamPapersBatchUpdateBodyDto { /// - /// 账号 ID，可在「账号绑定」事件中获取 + /// 笔试账号 ID，可通过[账号绑定](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/eco_account/events/created)事件获取 /// 必填：是 /// 示例值：7147998241542539527 /// @@ -42,7 +42,7 @@ public record PatchHireV1EcoExamPapersBatchUpdateBodyDto public record EcoExamPaperData { /// - /// 试卷 ID + /// 试卷 ID。账号下已有的试卷 ID /// 必填：是 /// 示例值：7147998241542539527 /// 最小长度：1 @@ -60,7 +60,7 @@ public record EcoExamPaperData public string Name { get; set; } = string.Empty; /// - /// 考试时长（分钟） + /// 笔试时长（分钟） /// 必填：否 /// 示例值：30 /// @@ -76,7 +76,8 @@ public record EcoExamPaperData public int? QuestionCount { get; set; } /// - /// 开始时间，留空或不传表示不限制开始时间 + /// 笔试开始时间，毫秒时间戳。留空或不传表示不限制开始时间。 + /// **注意**：若传值且`end_time`不为空，则开始时间必须小于结束时间 /// 必填：否 /// 示例值：1658676234053 /// @@ -84,7 +85,8 @@ public record EcoExamPaperData public string? StartTime { get; set; } /// - /// 结束时间，留空或不传表示不限制结束时间 + /// 笔试结束时间，毫秒时间戳。留空或不传表示不限制结束时间 + /// **注意**：若传值且`start_time `不为空，则结束时间必须大于开始时间 /// 必填：否 /// 示例值：1672444800000 /// diff --git a/src/Hire/PatchHireV1EmployeesByEmployeeIdBodyDto.cs b/src/Hire/PatchHireV1EmployeesByEmployeeIdBodyDto.cs index 4bb8a76..cea48c3 100644 --- a/src/Hire/PatchHireV1EmployeesByEmployeeIdBodyDto.cs +++ b/src/Hire/PatchHireV1EmployeesByEmployeeIdBodyDto.cs @@ -4,17 +4,17 @@ // Created : 2024-06-24 // // Last Modified By : yxr -// Last Modified On : 2024-06-24 +// Last Modified On : 2024-08-28 // ************************************************************************ // // MIT // -// 更新入职状态 请求体 +// 更新员工状态 请求体 // ************************************************************************ namespace FeishuNetSdk.Hire; /// -/// 更新入职状态 请求体 -/// 根据员工 ID 更新员工转正、离职状态。 +/// 更新员工状态 请求体 +/// 根据员工 ID 更新员工招聘系统内的转正、离职状态。 /// 接口ID：6959374328975900674 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/candidate-management/delivery-process-management/onboard/patch /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2femployee%2fpatch @@ -22,7 +22,7 @@ namespace FeishuNetSdk.Hire; public record PatchHireV1EmployeesByEmployeeIdBodyDto { /// - /// 修改状态操作 + /// 修改状态操作类型 /// 必填：是 /// 示例值：1 /// 可选值： @@ -34,45 +34,45 @@ public record PatchHireV1EmployeesByEmployeeIdBodyDto public int Operation { get; set; } /// - /// 转正信息，操作员工转正时必填 + /// 转正信息，操作类型operation为`转正`时必填 /// 必填：否 /// [JsonPropertyName("conversion_info")] public EmployeeConversionInfo? ConversionInfo { get; set; } /// - /// 转正信息，操作员工转正时必填 + /// 转正信息，操作类型operation为`转正`时必填 /// public record EmployeeConversionInfo { /// - /// 实际转正日期 + /// 实际转正日期，毫秒时间戳 /// 必填：否 /// 示例值：1637596800000 /// [JsonPropertyName("actual_conversion_time")] - public int? ActualConversionTime { get; set; } + public long? ActualConversionTime { get; set; } } /// - /// 离职信息，操作员工离职时必填 + /// 离职信息，操作类型operation为`离职`时必填 /// 必填：否 /// [JsonPropertyName("overboard_info")] public EmployeeOverboardInfo? OverboardInfo { get; set; } /// - /// 离职信息，操作员工离职时必填 + /// 离职信息，操作类型operation为`离职`时必填 /// public record EmployeeOverboardInfo { /// - /// 实际离职日期 + /// 实际离职日期，毫秒时间戳 /// 必填：否 /// 示例值：1637596800000 /// [JsonPropertyName("actual_overboard_time")] - public int? ActualOverboardTime { get; set; } + public long? ActualOverboardTime { get; set; } /// /// 离职原因 diff --git a/src/Hire/PatchHireV1EmployeesByEmployeeIdResponseDto.cs b/src/Hire/PatchHireV1EmployeesByEmployeeIdResponseDto.cs index f9402ef..ab1b2a9 100644 --- a/src/Hire/PatchHireV1EmployeesByEmployeeIdResponseDto.cs +++ b/src/Hire/PatchHireV1EmployeesByEmployeeIdResponseDto.cs @@ -4,17 +4,17 @@ // Created : 2024-06-24 // // Last Modified By : yxr -// Last Modified On : 2024-06-24 +// Last Modified On : 2024-08-28 // ************************************************************************ // // MIT // -// 更新入职状态 响应体 +// 更新员工状态 响应体 // ************************************************************************ namespace FeishuNetSdk.Hire; /// -/// 更新入职状态 响应体 -/// 根据员工 ID 更新员工转正、离职状态。 +/// 更新员工状态 响应体 +/// 根据员工 ID 更新员工招聘系统内的转正、离职状态。 /// 接口ID：6959374328975900674 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/candidate-management/delivery-process-management/onboard/patch /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2femployee%2fpatch @@ -42,7 +42,7 @@ public record PatchHireV1EmployeesByEmployeeIdResponseDtoEmployee public string? Id { get; set; } /// - /// 投递ID + /// 投递ID，详情请查看：[获取投递信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/get) /// 必填：否 /// 示例值：7073372582620416300 /// @@ -74,36 +74,36 @@ public record PatchHireV1EmployeesByEmployeeIdResponseDtoEmployee public int? ConversionStatus { get; set; } /// - /// 实际入职时间 + /// 实际入职时间，毫秒时间戳 /// 必填：否 /// 示例值：1637596800000 /// [JsonPropertyName("onboard_time")] - public int? OnboardTime { get; set; } + public long? OnboardTime { get; set; } /// - /// 预期转正时间 + /// 预期转正时间，毫秒时间戳 /// 必填：否 /// 示例值：1637596800000 /// [JsonPropertyName("expected_conversion_time")] - public int? ExpectedConversionTime { get; set; } + public long? ExpectedConversionTime { get; set; } /// - /// 实际转正时间 + /// 实际转正时间，毫秒时间戳 /// 必填：否 /// 示例值：1637596800000 /// [JsonPropertyName("actual_conversion_time")] - public int? ActualConversionTime { get; set; } + public long? ActualConversionTime { get; set; } /// - /// 离职时间 + /// 离职时间，毫秒时间戳 /// 必填：否 /// 示例值：1637596800000 /// [JsonPropertyName("overboard_time")] - public int? OverboardTime { get; set; } + public long? OverboardTime { get; set; } /// /// 离职原因 @@ -114,7 +114,7 @@ public record PatchHireV1EmployeesByEmployeeIdResponseDtoEmployee public string? OverboardNote { get; set; } /// - /// 办公地点 + /// 办公地点，详情请查看：[查询地点列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query) /// 必填：否 /// 示例值：CT_2 /// @@ -122,7 +122,7 @@ public record PatchHireV1EmployeesByEmployeeIdResponseDtoEmployee public string? OnboardCityCode { get; set; } /// - /// 入职部门 + /// 入职部门ID，与入参中的`department_id_type`类型一致，详情请查看：[获取单个部门信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/get) /// 必填：否 /// 示例值：6966123381141866028 /// @@ -130,7 +130,7 @@ public record PatchHireV1EmployeesByEmployeeIdResponseDtoEmployee public string? Department { get; set; } /// - /// 直属上级 + /// 直属上级用户ID，与入参`user_id_type`类型一致 /// 必填：否 /// 示例值：ou-xxx /// @@ -138,7 +138,7 @@ public record PatchHireV1EmployeesByEmployeeIdResponseDtoEmployee public string? Leader { get; set; } /// - /// 序列 + /// 序列ID，与入参`job_family_id_type` 类型一致 /// 必填：否 /// 示例值：6937934036379650311 /// @@ -146,7 +146,7 @@ public record PatchHireV1EmployeesByEmployeeIdResponseDtoEmployee public string? Sequence { get; set; } /// - /// 职级 + /// 职级ID，与入参`job_level_id_type` 类型一致 /// 必填：否 /// 示例值：7006234385490345986 /// @@ -154,11 +154,19 @@ public record PatchHireV1EmployeesByEmployeeIdResponseDtoEmployee public string? Level { get; set; } /// - /// 员工类型 + /// 员工类型ID，与入参`employee_type_id_type` 类型一致 /// 必填：否 /// 示例值：1 /// [JsonPropertyName("employee_type")] public string? EmployeeType { get; set; } + + /// + /// 招聘需求ID + /// 必填：否 + /// 示例值：123123123213 + /// + [JsonPropertyName("job_requirement_id")] + public string? JobRequirementId { get; set; } } } diff --git a/src/Hire/PatchHireV1InterviewersByInterviewerIdBodyDto.cs b/src/Hire/PatchHireV1InterviewersByInterviewerIdBodyDto.cs new file mode 100644 index 0000000..015e7ae --- /dev/null +++ b/src/Hire/PatchHireV1InterviewersByInterviewerIdBodyDto.cs @@ -0,0 +1,48 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-08-28 +// +// Last Modified By : yxr +// Last Modified On : 2024-08-28 +// ************************************************************************ +// +// MIT +// +// 更新面试官信息 请求体 +// ************************************************************************ +namespace FeishuNetSdk.Hire; +/// +/// 更新面试官信息 请求体 +/// 用于更新面试官认证信息 +/// 接口ID：7372229724359852033 +/// 文档地址：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/interviewer/patch +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2finterviewer%2fpatch +/// +public record PatchHireV1InterviewersByInterviewerIdBodyDto +{ + /// + /// 面试官信息 + /// 必填：是 + /// + [JsonPropertyName("interviewer")] + public PatchHireV1InterviewersByInterviewerIdBodyDtoInterviewer Interviewer { get; set; } = new(); + + /// + /// 面试官信息 + /// + public record PatchHireV1InterviewersByInterviewerIdBodyDtoInterviewer + { + /// + /// 认证状态 + /// 必填：否 + /// 示例值：1 + /// 可选值： + /// 1：未认证 + /// 2：已认证 + /// + /// + [JsonPropertyName("verify_status")] + public int? VerifyStatus { get; set; } + } +} diff --git a/src/Hire/PatchHireV1InterviewersByInterviewerIdResponseDto.cs b/src/Hire/PatchHireV1InterviewersByInterviewerIdResponseDto.cs new file mode 100644 index 0000000..825df88 --- /dev/null +++ b/src/Hire/PatchHireV1InterviewersByInterviewerIdResponseDto.cs @@ -0,0 +1,56 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-08-28 +// +// Last Modified By : yxr +// Last Modified On : 2024-08-28 +// ************************************************************************ +// +// MIT +// +// 更新面试官信息 响应体 +// ************************************************************************ +namespace FeishuNetSdk.Hire; +/// +/// 更新面试官信息 响应体 +/// 用于更新面试官认证信息 +/// 接口ID：7372229724359852033 +/// 文档地址：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/interviewer/patch +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2finterviewer%2fpatch +/// +public record PatchHireV1InterviewersByInterviewerIdResponseDto +{ + /// + /// 面试官信息 + /// 必填：否 + /// + [JsonPropertyName("interviewer")] + public PatchHireV1InterviewersByInterviewerIdResponseDtoInterviewer? Interviewer { get; set; } + + /// + /// 面试官信息 + /// + public record PatchHireV1InterviewersByInterviewerIdResponseDtoInterviewer + { + /// + /// 面试官userID + /// 必填：否 + /// 示例值：ou_7dab8a3d3cdcc9da365777c7ad535d62 + /// + [JsonPropertyName("user_id")] + public string? UserId { get; set; } + + /// + /// 认证状态 + /// 必填：否 + /// 示例值：1 + /// 可选值： + /// 1：未认证 + /// 2：已认证 + /// + /// + [JsonPropertyName("verify_status")] + public int? VerifyStatus { get; set; } + } +} diff --git a/src/Hire/PostHireV1AgenciesProtectBodyDto.cs b/src/Hire/PostHireV1AgenciesProtectBodyDto.cs index 37e9cea..c9ce871 100644 --- a/src/Hire/PostHireV1AgenciesProtectBodyDto.cs +++ b/src/Hire/PostHireV1AgenciesProtectBodyDto.cs @@ -46,7 +46,7 @@ public record PostHireV1AgenciesProtectBodyDto public string ConsultantId { get; set; } = string.Empty; /// - /// 保护期创建时间，毫秒时间戳 + /// 保护期创建时间（int64类型），毫秒时间戳 /// 必填：是 /// 示例值：1610695587000 /// @@ -54,7 +54,7 @@ public record PostHireV1AgenciesProtectBodyDto public long ProtectCreateTime { get; set; } /// - /// 保护期过期时间，毫秒时间戳 + /// 保护期过期时间（int64类型），毫秒时间戳 /// 必填：是 /// 示例值：1626333987000 /// diff --git a/src/Hire/PostHireV1AgenciesProtectionPeriodSearchBodyDto.cs b/src/Hire/PostHireV1AgenciesProtectionPeriodSearchBodyDto.cs index 49ebe3f..8e45138 100644 --- a/src/Hire/PostHireV1AgenciesProtectionPeriodSearchBodyDto.cs +++ b/src/Hire/PostHireV1AgenciesProtectionPeriodSearchBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 查询猎头保护期信息 请求体 -/// 查询指定人才的猎头保护期列表，包含保护期起止时间，以及猎头供应商、猎头顾问信息等。若人才已经入职，还会返回入职时所在的保护期信息。 +/// 查询指定人才的猎头保护期信息列表，包含保护期起止时间、猎头供应商、猎头顾问信息等。若人才已经入职，还会返回入职时所在的保护期信息。 /// 接口ID：7307160083569655811 /// 文档地址：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/agency/protect_search /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2fagency%2fprotect_search @@ -22,7 +22,7 @@ namespace FeishuNetSdk.Hire; public record PostHireV1AgenciesProtectionPeriodSearchBodyDto { /// - /// 人才ID，可通过[通过手机号或邮箱获取人才 ID](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent/batch_get_id)、[获取人才列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent/list)接口获取 + /// 人才 ID，可通过[通过手机号或邮箱获取人才 ID](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent/batch_get_id)、[获取人才列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent/list)接口获取 /// 必填：是 /// 示例值：6930815272790114324 /// diff --git a/src/Hire/PostHireV1AgenciesProtectionPeriodSearchResponseDto.cs b/src/Hire/PostHireV1AgenciesProtectionPeriodSearchResponseDto.cs index 0f381bd..8c1fbf7 100644 --- a/src/Hire/PostHireV1AgenciesProtectionPeriodSearchResponseDto.cs +++ b/src/Hire/PostHireV1AgenciesProtectionPeriodSearchResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 查询猎头保护期信息 响应体 -/// 查询指定人才的猎头保护期列表，包含保护期起止时间，以及猎头供应商、猎头顾问信息等。若人才已经入职，还会返回入职时所在的保护期信息。 +/// 查询指定人才的猎头保护期信息列表，包含保护期起止时间、猎头供应商、猎头顾问信息等。若人才已经入职，还会返回入职时所在的保护期信息。 /// 接口ID：7307160083569655811 /// 文档地址：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/agency/protect_search /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2fagency%2fprotect_search @@ -62,7 +62,7 @@ public record AgencyProtection public int? ProtectionType { get; set; } /// - /// 如保护期类型为 职位保护期（`2`）时，返回职位保护所在的投递id，详情请参考：[获取投递信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/get) + /// 如保护期类型为 职位保护期（`2`）时，返回职位保护所在的投递 ID，详情请参考：[获取投递信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/get) /// 必填：否 /// 示例值：6930815272790114323 /// @@ -86,7 +86,7 @@ public record AgencyProtection public string? ExpireTime { get; set; } /// - /// 猎头供应商 ID + /// 猎头供应商 ID，详情请参考：[获取猎头供应商信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/agency/get) /// 必填：否 /// 示例值：6930815272790114324 /// @@ -123,8 +123,8 @@ public record I18n } /// - /// 猎头顾问ID，与`user_id_type`类型一致。 - /// **注意**：由于猎头顾问位于猎头供应商租户里，不在该接口调用方租户里，无法直接通过此ID查询猎头顾问信息。 + /// 猎头顾问 ID，与`user_id_type`类型一致。 + /// **注意**：由于猎头顾问位于猎头供应商租户，不在本接口调用方租户里，若需获取猎头信息，需切换租户至猎头供应商租户后通过[获取单个用户信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/get)访问猎头顾问详情 /// 必填：否 /// 示例值：6930815272790114324 /// diff --git a/src/Hire/PostHireV1ApplicationsByApplicationIdTransferOnboardBodyDto.cs b/src/Hire/PostHireV1ApplicationsByApplicationIdTransferOnboardBodyDto.cs index f41f2b0..f8467cf 100644 --- a/src/Hire/PostHireV1ApplicationsByApplicationIdTransferOnboardBodyDto.cs +++ b/src/Hire/PostHireV1ApplicationsByApplicationIdTransferOnboardBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 操作候选人入职 请求体 -/// 根据投递 ID 操作候选人入职并创建员工。投递须处于「待入职」阶段，可通过「转移阶段」接口变更投递状态。 +/// 根据投递 ID 操作候选人入职并创建员工。后续可通过接口进一步获取入职信息，详情参考：[通过员工 ID 获取入职信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/employee/get) /// 接口ID：6964286393804800028 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/candidate-management/delivery-process-management/onboard/transfer_onboard /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2fapplication%2ftransfer_onboard @@ -22,23 +22,23 @@ namespace FeishuNetSdk.Hire; public record PostHireV1ApplicationsByApplicationIdTransferOnboardBodyDto { /// - /// 实际入职时间 + /// 实际入职时间，毫秒时间戳 /// 必填：否 /// 示例值：1616428800000 /// [JsonPropertyName("actual_onboard_time")] - public int? ActualOnboardTime { get; set; } + public long? ActualOnboardTime { get; set; } /// - /// 预期转正时间 + /// 预期转正时间，毫秒时间戳 /// 必填：否 /// 示例值：1616428800000 /// [JsonPropertyName("expected_conversion_time")] - public int? ExpectedConversionTime { get; set; } + public long? ExpectedConversionTime { get; set; } /// - /// 招聘需求 ID + /// 招聘需求 ID，可通过接口 [获取招聘需求列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_requirement/list) 获取。入职完成后招聘需求的「已入职」人数会加1 /// 必填：否 /// 示例值：6960663240925956402 /// @@ -46,15 +46,16 @@ public record PostHireV1ApplicationsByApplicationIdTransferOnboardBodyDto public string? JobRequirementId { get; set; } /// - /// 操作人 UserID + /// 操作人ID，与入参 `user_id_type` 类型一致 /// 必填：否 - /// 示例值：ou-xxx + /// 示例值：7326856229396906012 /// [JsonPropertyName("operator_id")] public string? OperatorId { get; set; } /// - /// 候选人办公地点 ID ，枚举可通过接口「获取地址列表」获取，将用于候选人内推奖规则判断 + /// 候选人办公地点 ID，将用于候选人内推奖规则判断，数据源可通过接口[获取地址列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/list) + /// 获取 /// 必填：否 /// 示例值：CT_2 /// @@ -62,7 +63,7 @@ public record PostHireV1ApplicationsByApplicationIdTransferOnboardBodyDto public string? OnboardCityCode { get; set; } /// - /// 候选人入职部门 ID ，枚举可通过接口「获取部门信息列表」获取，将用于候选人内推奖规则判断 + /// 候选人入职部门 ID ，将用于候选人内推奖规则判断，可通过接口[搜索部门](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/search)获取，与入参 `department_id_type ` 类型一致 /// 必填：否 /// 示例值：6966123381141866028 /// @@ -70,15 +71,15 @@ public record PostHireV1ApplicationsByApplicationIdTransferOnboardBodyDto public string? Department { get; set; } /// - /// 候选人直属上级 UserID ，将用于候选人内推奖规则判断 + /// 候选人直属上级 UserID ，将用于候选人内推奖规则判断，与入参 `user_id_type` 类型一致 /// 必填：否 - /// 示例值：ou-xxx + /// 示例值：7326856229396906012 /// [JsonPropertyName("leader")] public string? Leader { get; set; } /// - /// 候选人序列 ID ，枚举可通过接口「获取职务分类列表」获取，将用于候选人内推奖规则判断 + /// 候选人序列 ID ，将用于候选人内推奖规则判断，与入参 `job_family_id_type ` 类型一致 /// 必填：否 /// 示例值：7006234385490345986 /// @@ -86,7 +87,7 @@ public record PostHireV1ApplicationsByApplicationIdTransferOnboardBodyDto public string? Sequence { get; set; } /// - /// 候选人职级 ID ，枚举可通过接口「获取职级列表」获取，将用于候选人内推奖规则判断 + /// 候选人职级 ID ，将用于候选人内推奖规则判断，与入参 `job_level_id_type ` 类型一致 /// 必填：否 /// 示例值：6937934036379650311 /// @@ -94,7 +95,7 @@ public record PostHireV1ApplicationsByApplicationIdTransferOnboardBodyDto public string? Level { get; set; } /// - /// 候选人入职人员类型 ID，可通过接口人力资源管理平台「获取员工类型列表」获取，将用于候选人内推奖规则判断 + /// 候选人入职人员类型 ID，将用于候选人内推奖规则判断，与入参 `employee_type_id_type ` 类型一致 /// 必填：否 /// 示例值：1 /// diff --git a/src/Hire/PostHireV1ApplicationsByApplicationIdTransferOnboardResponseDto.cs b/src/Hire/PostHireV1ApplicationsByApplicationIdTransferOnboardResponseDto.cs index d833af2..2f2bd3b 100644 --- a/src/Hire/PostHireV1ApplicationsByApplicationIdTransferOnboardResponseDto.cs +++ b/src/Hire/PostHireV1ApplicationsByApplicationIdTransferOnboardResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 操作候选人入职 响应体 -/// 根据投递 ID 操作候选人入职并创建员工。投递须处于「待入职」阶段，可通过「转移阶段」接口变更投递状态。 +/// 根据投递 ID 操作候选人入职并创建员工。后续可通过接口进一步获取入职信息，详情参考：[通过员工 ID 获取入职信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/employee/get) /// 接口ID：6964286393804800028 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/candidate-management/delivery-process-management/onboard/transfer_onboard /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2fapplication%2ftransfer_onboard diff --git a/src/Hire/PostHireV1EcoAccountCustomFieldsBodyDto.cs b/src/Hire/PostHireV1EcoAccountCustomFieldsBodyDto.cs index f50eaa7..1111fdf 100644 --- a/src/Hire/PostHireV1EcoAccountCustomFieldsBodyDto.cs +++ b/src/Hire/PostHireV1EcoAccountCustomFieldsBodyDto.cs @@ -69,7 +69,7 @@ public record EcoAccountCustomFieldData public record I18n { /// - /// 中文名称 + /// 自定义字段中文名称 /// 必填：否 /// 示例值：账号token /// @@ -77,7 +77,7 @@ public record I18n public string? ZhCn { get; set; } /// - /// 英文名称 + /// 自定义字段英文名称 /// 必填：否 /// 示例值：Account token /// diff --git a/src/Hire/PostHireV1EcoBackgroundCheckPackagesBatchDeleteBodyDto.cs b/src/Hire/PostHireV1EcoBackgroundCheckPackagesBatchDeleteBodyDto.cs index 82df257..f24dc71 100644 --- a/src/Hire/PostHireV1EcoBackgroundCheckPackagesBatchDeleteBodyDto.cs +++ b/src/Hire/PostHireV1EcoBackgroundCheckPackagesBatchDeleteBodyDto.cs @@ -24,7 +24,7 @@ public record PostHireV1EcoBackgroundCheckPackagesBatchDeleteBodyDto /// /// 背调账号 ID，可通过[账号绑定](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/eco_account/events/created)事件获取 /// 必填：是 - /// 示例值：xd_bc_001 + /// 示例值：6995842370159937061 /// [JsonPropertyName("account_id")] public string AccountId { get; set; } = string.Empty; diff --git a/src/Hire/PostHireV1EcoExamPapersBatchDeleteBodyDto.cs b/src/Hire/PostHireV1EcoExamPapersBatchDeleteBodyDto.cs index 00256c4..82688d5 100644 --- a/src/Hire/PostHireV1EcoExamPapersBatchDeleteBodyDto.cs +++ b/src/Hire/PostHireV1EcoExamPapersBatchDeleteBodyDto.cs @@ -9,12 +9,12 @@ // // MIT // -// 删除试卷 请求体 +// 删除试卷列表 请求体 // ************************************************************************ namespace FeishuNetSdk.Hire; /// -/// 删除试卷 请求体 -/// 删除指定帐号的指定试卷列表，删除不影响已创建的笔试，删除不存在的试卷时不会报错 +/// 删除试卷列表 请求体 +/// 飞书招聘的笔试服务商，可通过该接口删除客户笔试帐号下的试卷列表。删除操作不影响已安排的笔试，删除不存在的试卷时不会报错。 /// 接口ID：7195815976042577922 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/ecological-docking/eco_exam_paper/batch_delete /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2feco_exam_paper%2fbatch_delete @@ -22,7 +22,7 @@ namespace FeishuNetSdk.Hire; public record PostHireV1EcoExamPapersBatchDeleteBodyDto { /// - /// 背调账号 ID，可在「账号绑定」事件中获取 + /// 笔试账号 ID，可通过[账号绑定](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/eco_account/events/created)事件获取 /// 必填：是 /// 示例值：7147998241542539527 /// @@ -30,7 +30,7 @@ public record PostHireV1EcoExamPapersBatchDeleteBodyDto public string AccountId { get; set; } = string.Empty; /// - /// 试卷 ID 列表 + /// 试卷 ID 列表。通过[创建试卷列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/eco_exam_paper/create)传入的 ID /// 必填：是 /// 示例值：["7147998241542539512"] /// diff --git a/src/Hire/PostHireV1EcoExamPapersBodyDto.cs b/src/Hire/PostHireV1EcoExamPapersBodyDto.cs index 4905888..480cdcf 100644 --- a/src/Hire/PostHireV1EcoExamPapersBodyDto.cs +++ b/src/Hire/PostHireV1EcoExamPapersBodyDto.cs @@ -9,12 +9,12 @@ // // MIT // -// 推送试卷列表 请求体 +// 创建试卷列表 请求体 // ************************************************************************ namespace FeishuNetSdk.Hire; /// -/// 推送试卷列表 请求体 -/// 定制指定帐号可用的试卷列表 +/// 创建试卷列表 请求体 +/// 飞书招聘的笔试服务商，在完成[账号绑定](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/eco_account/events/created)后，可通过本接口在客户的笔试帐号下创建试卷列表。若客户的笔试账号为「未激活」、「停用」状态，则试卷创建成功后，客户的账号将变为「正常」状态，可正常安排笔试。 /// 接口ID：7195815976042561538 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/ecological-docking/eco_exam_paper/create /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2feco_exam_paper%2fcreate @@ -22,7 +22,7 @@ namespace FeishuNetSdk.Hire; public record PostHireV1EcoExamPapersBodyDto { /// - /// 账号 ID，可在「账号绑定」事件中获取 + /// 笔试账号 ID，可通过[账号绑定](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/eco_account/events/created)事件获取 /// 必填：是 /// 示例值：7147998241542539527 /// @@ -42,7 +42,7 @@ public record PostHireV1EcoExamPapersBodyDto public record EcoExamPaperData { /// - /// 试卷 ID + /// 试卷 ID。由调用方自定义 /// 必填：是 /// 示例值：7147998241542539527 /// 最小长度：1 @@ -76,7 +76,8 @@ public record EcoExamPaperData public int? QuestionCount { get; set; } /// - /// 开始时间，留空或不传表示不限制开始时间 + /// 笔试开始时间，毫秒时间戳。留空或不传表示不限制开始时间。 + /// **注意**：若传值且`end_time`不为空，则开始时间必须小于结束时间 /// 必填：否 /// 示例值：1658676234053 /// @@ -84,7 +85,8 @@ public record EcoExamPaperData public string? StartTime { get; set; } /// - /// 结束时间，留空或不传表示不限制结束时间 + /// 笔试结束时间，毫秒时间戳。留空或不传表示不限制结束时间 + /// **注意**：若传值且`start_time `不为空，则结束时间必须大于开始时间 /// 必填：否 /// 示例值：1672444800000 /// diff --git a/src/Hire/PostHireV1EcoExamsByExamIdLoginInfoBodyDto.cs b/src/Hire/PostHireV1EcoExamsByExamIdLoginInfoBodyDto.cs index bb9bb2f..81044fb 100644 --- a/src/Hire/PostHireV1EcoExamsByExamIdLoginInfoBodyDto.cs +++ b/src/Hire/PostHireV1EcoExamsByExamIdLoginInfoBodyDto.cs @@ -14,7 +14,8 @@ namespace FeishuNetSdk.Hire; /// /// 回传笔试安排结果 请求体 -/// 回传笔试安排结果，如果安排成功需返回笔试链接和登录凭证 +/// 飞书招聘的笔试服务商，在收到[创建笔试](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/eco_exam/events/created)事件并安排笔试后，应通过本接口 +/// 回传笔试安排结果。若安排成功，须返回笔试链接；若笔试链接需要登录鉴权，则须返回登录凭证（`username`，`password`)。 /// 接口ID：7195815979079401473 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/ecological-docking/eco_exam/login_info /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2feco_exam%2flogin_info @@ -22,7 +23,9 @@ namespace FeishuNetSdk.Hire; public record PostHireV1EcoExamsByExamIdLoginInfoBodyDto { /// - /// 状态码，0-成功 非零-错误码 + /// 状态码。 + /// * 0：成功 + /// * 非0：服务商内部的失败错误码 /// 必填：否 /// 示例值：0 /// @@ -30,7 +33,7 @@ public record PostHireV1EcoExamsByExamIdLoginInfoBodyDto public int? Result { get; set; } /// - /// 成功或失败的描述信息 + /// 安排成功或失败的描述信息 /// 必填：否 /// 示例值：success /// @@ -50,7 +53,7 @@ public record PostHireV1EcoExamsByExamIdLoginInfoBodyDto public record EcoExamLoginInfo { /// - /// 笔试链接。如果返回的链接是附带候选人唯一标识且无需登录鉴权的，可只返回此地址 + /// 笔试链接。若返回的链接已经附带候选人唯一标识且无需登录鉴权，可只返回此链接 /// 必填：是 /// 示例值：https://xxxx/xxxx/xxxx /// @@ -58,7 +61,8 @@ public record EcoExamLoginInfo public string ExamUrl { get; set; } = string.Empty; /// - /// 用户名 + /// 登录用户名。 + /// **注意**：若笔试链接需要登录鉴权，须返回此登录凭证 /// 必填：否 /// 示例值：waxsdfbhg /// @@ -66,7 +70,8 @@ public record EcoExamLoginInfo public string? Username { get; set; } /// - /// 密码 + /// 登录密码。 + /// **注意**：若笔试链接需要登录鉴权，须返回此登录凭证 /// 必填：否 /// 示例值：xxxxxx /// diff --git a/src/Hire/PostHireV1EcoExamsByExamIdUpdateResultBodyDto.cs b/src/Hire/PostHireV1EcoExamsByExamIdUpdateResultBodyDto.cs index 75d4a5c..6511413 100644 --- a/src/Hire/PostHireV1EcoExamsByExamIdUpdateResultBodyDto.cs +++ b/src/Hire/PostHireV1EcoExamsByExamIdUpdateResultBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 回传笔试结果 请求体 -/// 回传笔试结果。回传笔试结果后，若需更新笔试结果，可再次调用该接口更新笔试结果，更新后的数据将覆盖原数据。用户若已在飞书招聘完成阅卷，不再支持回传笔试结果。 +/// 飞书招聘的笔试服务商，可通过该接口回传候选人的笔试结果。回传笔试结果后，候选人在飞书招聘内的笔试状态将变为「已作答」。 /// 接口ID：7195815979079467009 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/ecological-docking/eco_exam/update_result /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2feco_exam%2fupdate_result @@ -22,7 +22,7 @@ namespace FeishuNetSdk.Hire; public record PostHireV1EcoExamsByExamIdUpdateResultBodyDto { /// - /// 笔试结果，推荐传"0"-"100" 的数字(字符串格式)，如"60"， "90"， 该字段表示该场笔试考生考试的成绩 + /// 笔试结果。表示该场笔试考生的笔试成绩，推荐传 "0"-"100" 的数字（字符串格式），如 "60"、"90" 等 /// 必填：是 /// 示例值：60.5 /// @@ -30,7 +30,7 @@ public record PostHireV1EcoExamsByExamIdUpdateResultBodyDto public string Result { get; set; } = string.Empty; /// - /// 笔试结果时间 + /// 笔试结果时间，毫秒时间戳 /// 必填：否 /// 示例值：1658676234053 /// @@ -52,7 +52,7 @@ public record EcoExamResultReport /// /// 报告名称 /// 必填：是 - /// 示例值：阶段报告.pdf + /// 示例值：张三的笔试结果.pdf /// [JsonPropertyName("name")] public string Name { get; set; } = string.Empty; @@ -66,7 +66,7 @@ public record EcoExamResultReport public string Url { get; set; } = string.Empty; /// - /// 作答完成时间(毫秒时间戳) + /// 作答完成时间，毫秒时间戳 /// 必填：否 /// 示例值：1658676234053 /// @@ -87,7 +87,7 @@ public record EcoExamResultReport public record EcoExamResultDetail { /// - /// 评价 ID + /// 评价项 ID，由调用方自定义 /// 必填：否 /// 示例值：pj001 /// @@ -95,7 +95,8 @@ public record EcoExamResultDetail public string? Id { get; set; } /// - /// 评价名称 + /// 评价项名称，由调用方自定义。 + /// 单次调用支持传入多个相同的评价项名称，结果将在「飞书招聘」-「候选人详情」-「笔试卡片」中并列展示 /// 必填：是 /// 示例值：基本功 /// @@ -103,7 +104,7 @@ public record EcoExamResultDetail public string Name { get; set; } = string.Empty; /// - /// 评价结果 + /// 评价结果，由调用方自定义 /// 必填：是 /// 示例值：优秀 /// diff --git a/src/Hire/PostHireV1ExternalInterviewsBodyDto.cs b/src/Hire/PostHireV1ExternalInterviewsBodyDto.cs index db46446..2bff961 100644 --- a/src/Hire/PostHireV1ExternalInterviewsBodyDto.cs +++ b/src/Hire/PostHireV1ExternalInterviewsBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 创建外部面试 请求体 -/// 导入来自其他系统的面试信息，创建为外部面试。 +/// 创建外部面试，可用于导入来自其他系统的面试信息。 /// 接口ID：6992822583076339715 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/get-candidates/import-external-system-information/create-3 /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2fexternal_interview%2fcreate @@ -24,13 +24,13 @@ public record PostHireV1ExternalInterviewsBodyDto /// /// 外部系统面试主键 （仅用于幂等） /// 必填：否 - /// 示例值：123 + /// 示例值：7396034232747641132 /// [JsonPropertyName("external_id")] public string? ExternalId { get; set; } /// - /// 外部投递 ID + /// 外部投递 ID，可通过[获取外部投递信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/external_application/list)接口获取 /// 必填：是 /// 示例值：6960663240925956437 /// @@ -51,7 +51,7 @@ public record PostHireV1ExternalInterviewsBodyDto public int? ParticipateStatus { get; set; } /// - /// 开始时间 + /// 开始时间，毫秒时间戳（字段类型为：int64） /// 必填：否 /// 示例值：1618500278638 /// @@ -59,10 +59,126 @@ public record PostHireV1ExternalInterviewsBodyDto public long? BeginTime { get; set; } /// - /// 结束时间 + /// 结束时间，毫秒时间戳（字段类型为：int64） /// 必填：否 /// 示例值：1618500278639 /// [JsonPropertyName("end_time")] public long? EndTime { get; set; } + + /// + /// 面试评价列表 + /// 必填：否 + /// + [JsonPropertyName("interview_assessments")] + public ExternalInterviewAssessment[]? InterviewAssessments { get; set; } + + /// + /// 面试评价列表 + /// + public record ExternalInterviewAssessment + { + /// + /// 面试官姓名 + /// 必填：否 + /// 示例值：张三 + /// + [JsonPropertyName("username")] + public string? Username { get; set; } + + /// + /// 面试结论 + /// 必填：否 + /// 示例值：1 + /// 可选值： + /// 1：不通过 + /// 2：通过 + /// 3：待定 + /// + /// + [JsonPropertyName("conclusion")] + public int? Conclusion { get; set; } + + /// + /// 评价维度列表 + /// 必填：否 + /// + [JsonPropertyName("assessment_dimension_list")] + public ExternalInterviewAssessmentDimension[]? AssessmentDimensionLists { get; set; } + + /// + /// 评价维度列表 + /// + public record ExternalInterviewAssessmentDimension + { + /// + /// 打分题分数（当维度类型为「打分题」时使用） + /// 必填：否 + /// 示例值：99 + /// + [JsonPropertyName("score")] + public int? Score { get; set; } + + /// + /// 单选选项（当维度类型为「单选题」时使用） + /// 必填：否 + /// 示例值：选项1 + /// + [JsonPropertyName("option")] + public string? Option { get; set; } + + /// + /// 多选选项（当维度类型为「多选题」时使用） + /// 必填：否 + /// + [JsonPropertyName("options")] + public string[]? Options { get; set; } + + /// + /// 描述内容（当维度类型为「描述题」时使用） + /// 必填：否 + /// 示例值：不错的面试内容 + /// + [JsonPropertyName("content")] + public string? Content { get; set; } + + /// + /// 维度类型 + /// 必填：否 + /// 示例值：1 + /// 可选值： + /// 1：打分题 + /// 2：单选题 + /// 3：描述题 + /// 4：多选题 + /// + /// + [JsonPropertyName("assessment_type")] + public int? AssessmentType { get; set; } + + /// + /// 维度标题 + /// 必填：否 + /// 示例值：面试测试 + /// + [JsonPropertyName("title")] + public string? Title { get; set; } + + /// + /// 维度描述 + /// 必填：否 + /// 示例值：这是一次测试 + /// + [JsonPropertyName("description")] + public string? Description { get; set; } + } + + /// + /// 综合评价 + /// 必填：否 + /// 示例值：第一次面试 + /// + [JsonPropertyName("content")] + public string? Content { get; set; } + } } diff --git a/src/Hire/PostHireV1ExternalInterviewsResponseDto.cs b/src/Hire/PostHireV1ExternalInterviewsResponseDto.cs index a4cf082..f65ac26 100644 --- a/src/Hire/PostHireV1ExternalInterviewsResponseDto.cs +++ b/src/Hire/PostHireV1ExternalInterviewsResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 创建外部面试 响应体 -/// 导入来自其他系统的面试信息，创建为外部面试。 +/// 创建外部面试，可用于导入来自其他系统的面试信息。 /// 接口ID：6992822583076339715 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/get-candidates/import-external-system-information/create-3 /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2fexternal_interview%2fcreate @@ -63,7 +63,7 @@ public record PostHireV1ExternalInterviewsResponseDtoExternalInterview public int? ParticipateStatus { get; set; } /// - /// 开始时间 + /// 开始时间，毫秒时间戳（字段类型为：int64） /// 必填：否 /// 示例值：1618500278638 /// @@ -71,11 +71,135 @@ public record PostHireV1ExternalInterviewsResponseDtoExternalInterview public long? BeginTime { get; set; } /// - /// 结束时间 + /// 结束时间，毫秒时间戳（字段类型为：int64） /// 必填：否 /// 示例值：1618500278639 /// [JsonPropertyName("end_time")] public long? EndTime { get; set; } + + /// + /// 面试评价列表 + /// 必填：否 + /// + [JsonPropertyName("interview_assessments")] + public ExternalInterviewAssessment[]? InterviewAssessments { get; set; } + + /// + /// 面试评价列表 + /// + public record ExternalInterviewAssessment + { + /// + /// 外部面评 ID + /// 必填：否 + /// 示例值：6989181065243969836 + /// + [JsonPropertyName("id")] + public string? Id { get; set; } + + /// + /// 面试官姓名 + /// 必填：否 + /// 示例值：张三 + /// + [JsonPropertyName("username")] + public string? Username { get; set; } + + /// + /// 面试结果 + /// 必填：否 + /// 示例值：1 + /// 可选值： + /// 1：不通过 + /// 2：通过 + /// 3：待定 + /// + /// + [JsonPropertyName("conclusion")] + public int? Conclusion { get; set; } + + /// + /// 评价维度列表 + /// 必填：否 + /// + [JsonPropertyName("assessment_dimension_list")] + public ExternalInterviewAssessmentDimension[]? AssessmentDimensionLists { get; set; } + + /// + /// 评价维度列表 + /// + public record ExternalInterviewAssessmentDimension + { + /// + /// 打分题分数（当维度类型为「打分题」时使用） + /// 必填：否 + /// 示例值：99 + /// + [JsonPropertyName("score")] + public int? Score { get; set; } + + /// + /// 单选选项（当维度类型为「单选题」时使用） + /// 必填：否 + /// 示例值：选项1 + /// + [JsonPropertyName("option")] + public string? Option { get; set; } + + /// + /// 多选选项（当维度类型为「多选题」时使用） + /// 必填：否 + /// + [JsonPropertyName("options")] + public string[]? Options { get; set; } + + /// + /// 描述内容（当维度类型为「描述题」时使用） + /// 必填：否 + /// 示例值：第一次面试记录 + /// + [JsonPropertyName("content")] + public string? Content { get; set; } + + /// + /// 维度类型 + /// 必填：否 + /// 示例值：1 + /// 可选值： + /// 1：打分题 + /// 2：单选题 + /// 3：描述题 + /// 4：多选题 + /// + /// + [JsonPropertyName("assessment_type")] + public int? AssessmentType { get; set; } + + /// + /// 维度标题 + /// 必填：否 + /// 示例值：性格测试 + /// + [JsonPropertyName("title")] + public string? Title { get; set; } + + /// + /// 维度描述 + /// 必填：否 + /// 示例值：这是性格测试相关的 + /// + [JsonPropertyName("description")] + public string? Description { get; set; } + } + + /// + /// 综合评价 + /// 必填：否 + /// 示例值：内容输出 + /// + [JsonPropertyName("content")] + public string? Content { get; set; } + } } } diff --git a/src/Hire/PostHireV1JobRequirementsBodyDto.cs b/src/Hire/PostHireV1JobRequirementsBodyDto.cs index 60a6e7b..2c18fa1 100644 --- a/src/Hire/PostHireV1JobRequirementsBodyDto.cs +++ b/src/Hire/PostHireV1JobRequirementsBodyDto.cs @@ -115,7 +115,7 @@ public record PostHireV1JobRequirementsBodyDto public int? Category { get; set; } /// - /// 需求部门ID，需与`department_id_type`类型一致 + /// 需求部门 ID，需与`department_id_type`类型一致 /// 必填：否 /// 示例值：od-4e6ac4d14bcd5071a37a39de902c7141 /// @@ -194,7 +194,7 @@ public record PostHireV1JobRequirementsBodyDto public int? RequiredDegree { get; set; } /// - /// 最高薪资，单位：K + /// 月薪范围-最高薪资，单位：K /// 必填：否 /// 示例值：10 /// @@ -202,7 +202,7 @@ public record PostHireV1JobRequirementsBodyDto public string? MaxSalary { get; set; } /// - /// 最低薪资，单位：K + /// 月薪范围-最低薪资，单位：K /// 必填：否 /// 示例值：5 /// @@ -210,7 +210,7 @@ public record PostHireV1JobRequirementsBodyDto public string? MinSalary { get; set; } /// - /// 工作地址ID，可通过[获取地址列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/list)获取 + /// 工作地址 ID，可通过[获取地址列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/list)获取 /// 必填：否 /// 示例值：7265901641899311105 /// @@ -247,15 +247,15 @@ public record JobRequirementCustomizedData /// /// 自定义字段 value - /// - 若字段类型为单行文本/多行文本，格式为"简单文本"； - /// - 若字段类型为单选，传值内容为选项的 ID，格式为"6890840516938696974"； - /// - 若字段类型为多选，传值内容为选项的ID 列表，格式为"[\"6890840516938696974\", \"6890840516938696975\" ]"； - /// - 若字段类型为时间，格式为"1609430400000" - /// - 若字段类型为时间段，格式为"["1609430400000", \"1612108800000\" ]"，单位是毫秒时间戳； - /// - 若字段类型为年份选择，格式为"1609430400000"，单位是毫秒时间戳； - /// - 若字段类型为月份选择，格式为"1625068800000"，单位是毫秒时间戳； - /// - 若字段类型为数字，传值格式为"1"; - /// - 若字段类型为富文本，传值举例"富文本" + /// - 单选：`"1"` + /// - 多选：`"[\"1\", \"2\"]"` + /// - 单行：`"单行文本"` + /// - 多行：`"多行文本"` + /// - 数字：`"1"` + /// - 月份选择：`"1627379423000"` + /// - 年份选择：`"1627379423000"` + /// - 日期选择：`"1627379423000"` + /// - 时间段：`"[\"1577808000000\", \"1612108800000\"]"` /// 必填：否 /// 示例值：简单文本 /// diff --git a/src/Hire/PostHireV1JobRequirementsResponseDto.cs b/src/Hire/PostHireV1JobRequirementsResponseDto.cs index ae470de..ca4107a 100644 --- a/src/Hire/PostHireV1JobRequirementsResponseDto.cs +++ b/src/Hire/PostHireV1JobRequirementsResponseDto.cs @@ -94,7 +94,7 @@ public record JobRequirementDto public record IdNameObject { /// - /// 职位性质ID + /// 职位性质 ID /// 必填：否 /// 示例值：101 /// @@ -132,28 +132,28 @@ public record I18n } /// - /// 人员类型，与`employee_type_id_type`类型一致 + /// 人员类型 /// 必填：否 /// [JsonPropertyName("employee_type")] public IdNameObject? EmployeeType { get; set; } /// - /// 最高职级，与`job_level_id_type`类型一致 + /// 最高职级 /// 必填：否 /// [JsonPropertyName("max_level")] public IdNameObject? MaxLevel { get; set; } /// - /// 最低职级，与`job_level_id_type`类型一致 + /// 最低职级 /// 必填：否 /// [JsonPropertyName("min_level")] public IdNameObject? MinLevel { get; set; } /// - /// 职位序列，与`job_family_id_type`类型一致 + /// 职位序列 /// 必填：否 /// [JsonPropertyName("sequence")] @@ -172,28 +172,28 @@ public record I18n public int? Category { get; set; } /// - /// 需求部门，与`department_id_type`类型一致 + /// 需求部门 /// 必填：否 /// [JsonPropertyName("department")] public IdNameObject? Department { get; set; } /// - /// 需求负责人，与`user_id_type`类型一致 + /// 需求负责人 /// 必填：否 /// [JsonPropertyName("recruiter_list")] public IdNameObject[]? RecruiterLists { get; set; } /// - /// 需求用人经理，与`user_id_type`类型一致 + /// 需求用人经理 /// 必填：否 /// [JsonPropertyName("jr_hiring_managers")] public IdNameObject[]? JrHiringManagers { get; set; } /// - /// 直属上级，与`user_id_type`类型一致 + /// 直属上级 /// 必填：否 /// [JsonPropertyName("direct_leader_list")] @@ -248,7 +248,7 @@ public record I18n public int? RequiredDegree { get; set; } /// - /// 最高薪资，单位：K + /// 最高月薪，单位：K /// 必填：否 /// 示例值：10 /// @@ -256,7 +256,7 @@ public record I18n public string? MaxSalary { get; set; } /// - /// 最低薪资，单位：K + /// 最低月薪，单位：K /// 必填：否 /// 示例值：5 /// @@ -291,7 +291,7 @@ public record I18n public record JobRequirementCustomizedDataDto { /// - /// 自定义字段 ID + /// 自定义字段 ID，详情请参考：[获取招聘需求模板](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_requirement_schema/list) /// 必填：否 /// 示例值：123123123 /// @@ -497,7 +497,7 @@ public record JobRequirementCustomizedTimeRange public record JobTypeInfo { /// - /// 职位类别ID + /// 职位类别 ID /// 必填：是 /// 示例值：6930815272790114324 /// @@ -534,7 +534,7 @@ public record I18n } /// - /// 父级职位类别ID + /// 父级职位类别 ID /// 必填：否 /// 示例值：6930815272790114323 /// diff --git a/src/Hire/PostHireV1JobRequirementsSearchResponseDto.cs b/src/Hire/PostHireV1JobRequirementsSearchResponseDto.cs index adb73ce..84db58a 100644 --- a/src/Hire/PostHireV1JobRequirementsSearchResponseDto.cs +++ b/src/Hire/PostHireV1JobRequirementsSearchResponseDto.cs @@ -248,7 +248,7 @@ public record I18n public int? RequiredDegree { get; set; } /// - /// 最高薪资，单位：千 + /// 月薪范围-最高薪资，单位：K /// 必填：否 /// 示例值：123 /// @@ -256,7 +256,7 @@ public record I18n public string? MaxSalary { get; set; } /// - /// 最低薪资，单位：千 + /// 月薪范围-最低薪资，单位：K /// 必填：否 /// 示例值：11 /// diff --git a/src/Hire/PostHireV1JobsByJobIdCombinedUpdateBodyDto.cs b/src/Hire/PostHireV1JobsByJobIdCombinedUpdateBodyDto.cs index eac00ff..ea81506 100644 --- a/src/Hire/PostHireV1JobsByJobIdCombinedUpdateBodyDto.cs +++ b/src/Hire/PostHireV1JobsByJobIdCombinedUpdateBodyDto.cs @@ -61,6 +61,7 @@ public record PostHireV1JobsByJobIdCombinedUpdateBodyDto /// /// 自定义字段 + /// - 注意：更新时会全量覆盖 /// 必填：否 /// [JsonPropertyName("customized_data_list")] @@ -68,11 +69,12 @@ public record PostHireV1JobsByJobIdCombinedUpdateBodyDto /// /// 自定义字段 + /// - 注意：更新时会全量覆盖 /// public record CombinedJobObjectValueMap { /// - /// 自定义字段 ID，详情请查看：[获取职位模板](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_schema/list) + /// 自定义字段 ID，可通过[获取职位模板](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_schema/list)接口获取 /// 必填：否 /// 示例值：6960663240925956549 /// @@ -89,7 +91,7 @@ public record CombinedJobObjectValueMap } /// - /// 最低职级 ID，需与入参`job_level_id_type` 类型一致，可通过 [获取租户职级列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/job_level/list) 接口获取 + /// 最低职级 ID，需与入参`job_level_id_type` 类型一致 /// 必填：否 /// 示例值：6960663240925956547 /// @@ -97,7 +99,7 @@ public record CombinedJobObjectValueMap public string? MinLevelId { get; set; } /// - /// 最低薪资，单位：千 + /// 最低薪资，单位：K /// 必填：否 /// 示例值：1000 /// @@ -182,7 +184,7 @@ public record JobManager public string? JobFunctionId { get; set; } /// - /// 部门 ID，需与入参中的`department_id_type`类型一致，可通过[批量查询部门](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/department/list)接口获取 + /// 部门 ID，需与入参中的`department_id_type`类型一致 /// 必填：否 /// 示例值：od-b2fafdce6fc5800b574ba5b0e2798b36 /// @@ -206,7 +208,7 @@ public record JobManager public bool IsNeverExpired { get; set; } /// - /// 最高薪资，单位：千 + /// 最高薪资，单位：K /// 必填：否 /// 示例值：2000 /// @@ -246,7 +248,7 @@ public record JobManager public string JobTypeId { get; set; } = string.Empty; /// - /// 最高职级 ID，需与入参`job_level_id_type` 类型一致，可通过 [获取租户职级列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/job_level/list) 接口获取 + /// 最高职级 ID，需与入参`job_level_id_type` 类型一致 /// 必填：否 /// 示例值：6960663240925956548 /// @@ -273,7 +275,7 @@ public record JobManager public int? RequiredDegree { get; set; } /// - /// 序列 ID，需与入参`job_family_id_type` 类型一致，可通过 [获取租户序列列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/job_family/list) 接口获取 + /// 序列 ID，需与入参`job_family_id_type` 类型一致 /// 必填：否 /// 示例值：6960663240925956550 /// diff --git a/src/Hire/PostHireV1JobsByJobIdCombinedUpdateResponseDto.cs b/src/Hire/PostHireV1JobsByJobIdCombinedUpdateResponseDto.cs index a88bb66..ef52dfc 100644 --- a/src/Hire/PostHireV1JobsByJobIdCombinedUpdateResponseDto.cs +++ b/src/Hire/PostHireV1JobsByJobIdCombinedUpdateResponseDto.cs @@ -160,7 +160,7 @@ public record JobRecruitmentType public record JobDepartment { /// - /// 部门 ID，与入参中的`department_id_type`类型一致，详情请查看：[批量查询部门](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/department/list) + /// 部门 ID，与入参中的`department_id_type`类型一致 /// 必填：否 /// 示例值：7281257045172308287 /// @@ -758,7 +758,7 @@ public record I18n public long? ExpiryTime { get; set; } /// - /// 最低薪资，单位：千 + /// 最低薪资，单位：K /// 必填：否 /// 示例值：10 /// @@ -766,7 +766,7 @@ public record I18n public int? MinSalary { get; set; } /// - /// 最高薪资，单位：千 + /// 最高薪资，单位：K /// 必填：否 /// 示例值：20 /// diff --git a/src/Hire/PostHireV1JobsByJobIdOpenBodyDto.cs b/src/Hire/PostHireV1JobsByJobIdOpenBodyDto.cs index e896bf6..6efe811 100644 --- a/src/Hire/PostHireV1JobsByJobIdOpenBodyDto.cs +++ b/src/Hire/PostHireV1JobsByJobIdOpenBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 重启职位 请求体 -/// 支持开启职位。 +/// 对于已关闭的职位，可通过本接口重启职位。 /// 接口ID：7012986483075530753 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/recruitment-related-configuration/job/open /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2fjob%2fopen @@ -22,15 +22,19 @@ namespace FeishuNetSdk.Hire; public record PostHireV1JobsByJobIdOpenBodyDto { /// - /// 到期日期 + /// 到期日期，毫秒时间戳（int64类型） + /// **注意**：当`is_never_expired`为`false`时该字段必填且大于当前时间 /// 必填：否 - /// 示例值：1598844859612 + /// 示例值：1830259120000 /// [JsonPropertyName("expiry_time")] public long? ExpiryTime { get; set; } /// /// 是否长期有效 + /// **可选值有**： + /// * `true`：长期有效 + /// * `false`：指定到期日期 /// 必填：是 /// 示例值：true /// diff --git a/src/Hire/PostHireV1JobsCombinedCreateBodyDto.cs b/src/Hire/PostHireV1JobsCombinedCreateBodyDto.cs index 6d6d7b4..a91ff4a 100644 --- a/src/Hire/PostHireV1JobsCombinedCreateBodyDto.cs +++ b/src/Hire/PostHireV1JobsCombinedCreateBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 新建职位 请求体 -/// 创建一个新的职位 +/// 创建一个新的职位。 /// ## 注意事项 /// - 调用此接口前，需先打开「飞书招聘」-「设置」-「职位管理」-「职位设置」-「通过API同步职位开关」开关。 /// - 字段是否必填，将以「飞书招聘」-「设置」-「职位管理」-「职位字段管理」中的设置为准。 @@ -88,7 +88,7 @@ public record CombinedJobObjectValueMap } /// - /// 最低职级 ID，需与入参`job_level_id_type` 类型一致，通过[获取租户职级列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/job_level/list)接口获取 + /// 最低职级 ID，需与入参`job_level_id_type` 类型一致 /// 必填：否 /// 示例值：7281257045172308287 /// @@ -96,7 +96,7 @@ public record CombinedJobObjectValueMap public string? MinLevelId { get; set; } /// - /// 最低薪资，单位：千 + /// 最低月薪，单位：K /// 必填：否 /// 示例值：1000 /// @@ -193,7 +193,7 @@ public record JobManager public string? JobFunctionId { get; set; } /// - /// 部门 ID，需与入参中的`department_id_type`类型一致，可通过[批量查询部门](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/department/list)接口获取 + /// 部门 ID，需与入参中的`department_id_type`类型一致 /// 必填：是 /// 示例值：od-b2fafdce6fc5800b574ba5b0e2798b36 /// @@ -217,7 +217,7 @@ public record JobManager public bool IsNeverExpired { get; set; } /// - /// 最高薪资，单位：千 + /// 最高月薪，单位：K /// 必填：否 /// 示例值：2000 /// @@ -249,7 +249,7 @@ public record JobManager public string[]? HighlightList { get; set; } /// - /// 职位类别ID，可通过[获取职位类别列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_type/list)接口获取 + /// 职位类别 ID，可通过[获取职位类别列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_type/list)接口获取 /// 必填：是 /// 示例值：6960663240925956551 /// @@ -257,7 +257,7 @@ public record JobManager public string JobTypeId { get; set; } = string.Empty; /// - /// 最高职级 ID，需与入参`job_level_id_type` 类型一致，通过[获取租户职级列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/job_level/list)接口获取 + /// 最高职级 ID，需与入参`job_level_id_type` 类型一致 /// 必填：否 /// 示例值：6960663240925956548 /// @@ -292,7 +292,7 @@ public record JobManager public int? RequiredDegree { get; set; } /// - /// 序列 ID，需与入参`job_family_id_type` 类型一致，可通过[获取租户序列列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/job_family/list)接口获取 + /// 序列 ID，需与入参`job_family_id_type` 类型一致 /// 必填：否 /// 示例值：6960663240925956550 /// diff --git a/src/Hire/PostHireV1JobsCombinedCreateResponseDto.cs b/src/Hire/PostHireV1JobsCombinedCreateResponseDto.cs index fd71d5c..9da17e5 100644 --- a/src/Hire/PostHireV1JobsCombinedCreateResponseDto.cs +++ b/src/Hire/PostHireV1JobsCombinedCreateResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 新建职位 响应体 -/// 创建一个新的职位 +/// 创建一个新的职位。 /// ## 注意事项 /// - 调用此接口前，需先打开「飞书招聘」-「设置」-「职位管理」-「职位设置」-「通过API同步职位开关」开关。 /// - 字段是否必填，将以「飞书招聘」-「设置」-「职位管理」-「职位字段管理」中的设置为准。 @@ -159,7 +159,7 @@ public record JobRecruitmentType public record JobDepartment { /// - /// 部门 ID，与入参中的`department_id_type`类型一致，详情请查看[批量查询部门](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/department/list) + /// 部门 ID，与入参中的`department_id_type`类型一致 /// 必填：否 /// 示例值：7281257045172308287 /// @@ -233,7 +233,7 @@ public record JobCity public record JobLevel { /// - /// 职级 ID，与入参`job_level_id_type` 类型一致，详情请查看[获取租户职级列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/job_level/list) + /// 职级 ID，与入参`job_level_id_type` 类型一致 /// 必填：否 /// 示例值：7281257045172308287 /// @@ -326,7 +326,7 @@ public record JobHighlight public record PostHireV1JobsCombinedCreateResponseDtoJobJobCategory { /// - /// 职位序列 ID，与入参`job_family_id_type` 类型一致，详情请查看[获取租户序列列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/job_family/list) + /// 职位序列 ID，与入参`job_family_id_type` 类型一致 /// 必填：否 /// 示例值：7281257045172308287 /// @@ -757,7 +757,7 @@ public record I18n public long? ExpiryTime { get; set; } /// - /// 最低薪资，单位：千 + /// 最低月薪，单位：K /// 必填：否 /// 示例值：10 /// @@ -765,7 +765,7 @@ public record I18n public int? MinSalary { get; set; } /// - /// 最高薪资，单位：千 + /// 最高月薪，单位：K /// 必填：否 /// 示例值：20 /// diff --git a/src/Hire/PostHireV1ReferralsSearchBodyDto.cs b/src/Hire/PostHireV1ReferralsSearchBodyDto.cs index 14c10e6..6c47fe1 100644 --- a/src/Hire/PostHireV1ReferralsSearchBodyDto.cs +++ b/src/Hire/PostHireV1ReferralsSearchBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 查询人才内推信息 请求体 -/// 根据人才查询内推信息列表，包含内推人信息、内推时间、投递ID等，按内推投递的`创建时间`从小到大排序返回。 +/// 根据人才查询内推信息列表，包含内推人信息、内推时间、投递 ID等，按内推投递的`创建时间`从小到大排序返回。 /// 接口ID：7307160083569704963 /// 文档地址：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/referral/search /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2freferral%2fsearch @@ -22,7 +22,7 @@ namespace FeishuNetSdk.Hire; public record PostHireV1ReferralsSearchBodyDto { /// - /// 人才ID ，可通过[通过手机号或邮箱获取人才 ID](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent/batch_get_id)获取 + /// 人才 ID ，可通过[批量获取人才ID](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent/batch_get_id)获取 /// 必填：是 /// 示例值：6930815272790114324 /// @@ -30,7 +30,7 @@ public record PostHireV1ReferralsSearchBodyDto public string TalentId { get; set; } = string.Empty; /// - /// 内推记录最早创建时间，毫秒时间戳。若不填，默认为全部，但最多返回200条 + /// 内推记录最早创建时间，毫秒时间戳。若不填，默认为指定人才下的全部记录，但最多返回200条 /// 必填：否 /// 示例值：1701226882718 /// @@ -38,7 +38,7 @@ public record PostHireV1ReferralsSearchBodyDto public string? StartTime { get; set; } /// - /// 内推记录最晚创建时间，毫秒时间戳。若不填，默认为全部，但最多返回200条 + /// 内推记录最晚创建时间，毫秒时间戳。默认为指定人才下的全部记录，但最多返回200条 /// 必填：否 /// 示例值：1701226882719 /// diff --git a/src/Hire/PostHireV1ReferralsSearchResponseDto.cs b/src/Hire/PostHireV1ReferralsSearchResponseDto.cs index 445a42c..da28588 100644 --- a/src/Hire/PostHireV1ReferralsSearchResponseDto.cs +++ b/src/Hire/PostHireV1ReferralsSearchResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 查询人才内推信息 响应体 -/// 根据人才查询内推信息列表，包含内推人信息、内推时间、投递ID等，按内推投递的`创建时间`从小到大排序返回。 +/// 根据人才查询内推信息列表，包含内推人信息、内推时间、投递 ID等，按内推投递的`创建时间`从小到大排序返回。 /// 接口ID：7307160083569704963 /// 文档地址：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/referral/search /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2freferral%2fsearch @@ -42,9 +42,9 @@ public record ReferralInfo public string? Id { get; set; } /// - /// 投递 ID 列表，详情请查看[获取投递信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/get)。通常情况下1次内推仅有1个投递ID，即内推原始投递ID（列表中的第一个ID）。 - /// 若投递发生过转移，还会包含「转移到其他职位后的投递 ID。 - /// 但不包含投递结束后被HR复捞(加入职位）的投递 ID。 + /// 投递 ID 列表，详情请查看[获取投递信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/get)。通常情况下1次内推仅有1个投递 ID，即内推原始投递 ID（列表中的第一个 ID）。 + /// 若投递发生过转移，还会包含「转移到其他职位后的投递 ID」。 + /// 但不包含投递结束后被HR复捞（加入职位）的投递 ID。 /// 必填：否 /// [JsonPropertyName("application_ids")] @@ -71,7 +71,7 @@ public record ReferralInfo public record IdNameObject { /// - /// 内推人ID，跟`user_id_type`类型一致 + /// 内推人 ID，跟`user_id_type`类型一致 /// 必填：否 /// 示例值：6930815272790114324 /// diff --git a/src/Hire/PostHireV1TalentPoolsByTalentPoolIdTalentRelationshipBodyDto.cs b/src/Hire/PostHireV1TalentPoolsByTalentPoolIdTalentRelationshipBodyDto.cs index 0833d28..b20fc46 100644 --- a/src/Hire/PostHireV1TalentPoolsByTalentPoolIdTalentRelationshipBodyDto.cs +++ b/src/Hire/PostHireV1TalentPoolsByTalentPoolIdTalentRelationshipBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 将人才加入人才库 请求体 -/// 将人才加入人才库 +/// 将人才加入人才库。 /// 接口ID：7218853190452445188 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/candidate-management/talent_pool/move_talent /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2ftalent_pool%2fmove_talent diff --git a/src/Hire/PostHireV1TalentPoolsByTalentPoolIdTalentRelationshipResponseDto.cs b/src/Hire/PostHireV1TalentPoolsByTalentPoolIdTalentRelationshipResponseDto.cs index d0b1ddd..fd55dc8 100644 --- a/src/Hire/PostHireV1TalentPoolsByTalentPoolIdTalentRelationshipResponseDto.cs +++ b/src/Hire/PostHireV1TalentPoolsByTalentPoolIdTalentRelationshipResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 将人才加入人才库 响应体 -/// 将人才加入人才库 +/// 将人才加入人才库。 /// 接口ID：7218853190452445188 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/candidate-management/talent_pool/move_talent /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2ftalent_pool%2fmove_talent diff --git a/src/Hire/PostHireV1TalentsBatchGetIdBodyDto.cs b/src/Hire/PostHireV1TalentsBatchGetIdBodyDto.cs index fd3e348..139ec5c 100644 --- a/src/Hire/PostHireV1TalentsBatchGetIdBodyDto.cs +++ b/src/Hire/PostHireV1TalentsBatchGetIdBodyDto.cs @@ -9,12 +9,12 @@ // // MIT // -// 通过手机号或邮箱获取人才 ID 请求体 +// 批量获取人才简要信息 请求体 // ************************************************************************ namespace FeishuNetSdk.Hire; /// -/// 通过手机号或邮箱获取人才 ID 请求体 -/// 通过手机号或邮箱获取人才 ID。 +/// 批量获取人才简要信息 请求体 +/// 批量获取人才简要信息，包括人才 ID、手机号、邮箱、证件号等。 /// 接口ID：7125370772851458076 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/candidate-management/talent/batch_get_id /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2ftalent%2fbatch_get_id @@ -22,7 +22,7 @@ namespace FeishuNetSdk.Hire; public record PostHireV1TalentsBatchGetIdBodyDto { /// - /// 手机国家区号，默认值：86，即中国大陆地区 + /// 国际区号，遵守国际统一标准，请参考[百度百科-国际长途电话区号](https://baike.baidu.com/item/%E5%9B%BD%E9%99%85%E9%95%BF%E9%80%94%E7%94%B5%E8%AF%9D%E5%8C%BA%E5%8F%B7%E8%A1%A8/12803495?fr=ge_ala)。传入手机号但没传区号的情况下，默认为中国大陆区号："86" /// 必填：否 /// 示例值：86 /// @@ -30,7 +30,7 @@ public record PostHireV1TalentsBatchGetIdBodyDto public string? MobileCode { get; set; } /// - /// 手机号，区号均采用 mobile_code 参数的值，最多 100 个 + /// 手机号列表 /// 必填：否 /// 示例值：182900291190 /// @@ -38,7 +38,7 @@ public record PostHireV1TalentsBatchGetIdBodyDto public string[]? MobileNumberList { get; set; } /// - /// 邮箱信息列表，最多 100 个 + /// 邮箱列表 /// 必填：否 /// 示例值：foo@bytedance.com /// @@ -46,7 +46,8 @@ public record PostHireV1TalentsBatchGetIdBodyDto public string[]? EmailList { get; set; } /// - /// 证件类型，可参考招聘枚举常量文档下的 IdentificationType 枚举定义 + /// 证件类型，枚举定义详见文档：[枚举常量介绍](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/enum) + /// 的 IdentificationType。传入证件号的情况下必须传入该参数 /// 必填：否 /// 示例值：1 /// @@ -54,7 +55,7 @@ public record PostHireV1TalentsBatchGetIdBodyDto public int? IdentificationType { get; set; } /// - /// 证件号 + /// 证件号列表 /// 必填：否 /// 示例值：130xxxxxxx /// diff --git a/src/Hire/PostHireV1TalentsBatchGetIdResponseDto.cs b/src/Hire/PostHireV1TalentsBatchGetIdResponseDto.cs index 4b7f914..8d000db 100644 --- a/src/Hire/PostHireV1TalentsBatchGetIdResponseDto.cs +++ b/src/Hire/PostHireV1TalentsBatchGetIdResponseDto.cs @@ -9,12 +9,12 @@ // // MIT // -// 通过手机号或邮箱获取人才 ID 响应体 +// 批量获取人才简要信息 响应体 // ************************************************************************ namespace FeishuNetSdk.Hire; /// -/// 通过手机号或邮箱获取人才 ID 响应体 -/// 通过手机号或邮箱获取人才 ID。 +/// 批量获取人才简要信息 响应体 +/// 批量获取人才简要信息，包括人才 ID、手机号、邮箱、证件号等。 /// 接口ID：7125370772851458076 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/candidate-management/talent/batch_get_id /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2ftalent%2fbatch_get_id @@ -34,7 +34,7 @@ public record PostHireV1TalentsBatchGetIdResponseDto public record TalentBatchInfo { /// - /// 人才 ID + /// 人才 ID，详情请查看：[获取人才信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent/get) /// 必填：否 /// 示例值：6891560630172518670 /// @@ -42,7 +42,7 @@ public record TalentBatchInfo public string? TalentId { get; set; } /// - /// 手机国家区号 + /// 国际区号，遵守国际统一标准，请参考[百度百科-国际长途电话区号](https://baike.baidu.com/item/%E5%9B%BD%E9%99%85%E9%95%BF%E9%80%94%E7%94%B5%E8%AF%9D%E5%8C%BA%E5%8F%B7%E8%A1%A8/12803495?fr=ge_ala) /// 必填：否 /// 示例值：86 /// @@ -66,7 +66,8 @@ public record TalentBatchInfo public string? Email { get; set; } /// - /// 证件类型，可参考招聘枚举常量 IdentificationType 枚举定义 + /// 证件类型，枚举定义详见文档：[枚举常量介绍](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/enum) + /// 的 IdentificationType /// 必填：否 /// 示例值：1 /// @@ -76,7 +77,7 @@ public record TalentBatchInfo /// /// 证件号 /// 必填：否 - /// 示例值：130xxxxxxxxx + /// 示例值：510403xxxxxxxx /// [JsonPropertyName("identification_number")] public string? IdentificationNumber { get; set; } diff --git a/src/Hire/PostHireV1TalentsByTalentIdOnboardStatusBodyDto.cs b/src/Hire/PostHireV1TalentsByTalentIdOnboardStatusBodyDto.cs index 1cdc126..e2bc12c 100644 --- a/src/Hire/PostHireV1TalentsByTalentIdOnboardStatusBodyDto.cs +++ b/src/Hire/PostHireV1TalentsByTalentIdOnboardStatusBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 更新人才在职状态 请求体 -/// 更新人才的在职状态，可进行的操作包括入职与离职 +/// 更新人才的在职状态，可进行的操作包括入职与离职。 /// ## 注意事项 /// - 通过该接口对人才进行入职、离职操作后，人才详情与列表会对应展示已入职、已离职标签 /// - 已入职的人才不能进行入职操作，已离职的人才不能进行入职操作 diff --git a/src/Hire/PostHireV1TalentsCombinedCreateBodyDto.cs b/src/Hire/PostHireV1TalentsCombinedCreateBodyDto.cs index b5513c8..e14ecfe 100644 --- a/src/Hire/PostHireV1TalentsCombinedCreateBodyDto.cs +++ b/src/Hire/PostHireV1TalentsCombinedCreateBodyDto.cs @@ -42,7 +42,7 @@ public record PostHireV1TalentsCombinedCreateBodyDto public string? ResumeSourceId { get; set; } /// - /// 文件夹 ID 列表，获取文件夹 ID 请参考[获取人才文件夹列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_folder/list) + /// 文件夹 ID 列表，可通过[获取人才文件夹列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_folder/list)接口获取 /// 必填：否 /// 示例值：["7025517823176132908"] /// 最大长度：100 @@ -63,7 +63,7 @@ public record PostHireV1TalentsCombinedCreateBodyDto /// 必填：否 /// 示例值：1 /// 可选值： - /// 1：员工体系 + /// 1：员工 /// 3：系统 /// /// @@ -79,14 +79,14 @@ public record PostHireV1TalentsCombinedCreateBodyDto public string? ResumeAttachmentId { get; set; } /// - /// 基础信息 + /// 基本信息 /// 必填：是 /// [JsonPropertyName("basic_info")] public TalentCombinedBasicInfo BasicInfo { get; set; } = new(); /// - /// 基础信息 + /// 基本信息 /// public record TalentCombinedBasicInfo { @@ -99,7 +99,7 @@ public record TalentCombinedBasicInfo public string Name { get; set; } = string.Empty; /// - /// 手机号 + /// 手机 /// 必填：否 /// 示例值：182900291190 /// @@ -214,14 +214,16 @@ public record TalentIdentificationInfo public string? HometownCityCode { get; set; } /// - /// 自定义字段列表，无效字段，请勿使用 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// 必填：否 /// [JsonPropertyName("customized_data")] public TalentCustomizedDataObjectValue[]? CustomizedDatas { get; set; } /// - /// 自定义字段列表，无效字段，请勿使用 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// public record TalentCustomizedDataObjectValue { @@ -370,14 +372,16 @@ public record TalentCombinedEducationInfo public int? AcademicRanking { get; set; } /// - /// 教育经历自定义字段，无效字段，请勿使用 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// 必填：否 /// [JsonPropertyName("customized_data")] public TalentCustomizedDataObjectValue[]? CustomizedDatas { get; set; } /// - /// 教育经历自定义字段，无效字段，请勿使用 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// public record TalentCustomizedDataObjectValue { @@ -496,14 +500,16 @@ public record TalentCombinedCareerInfo public int? CareerType { get; set; } /// - /// 工作经历自定义字段，无效字段，请勿使用 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// 必填：否 /// [JsonPropertyName("customized_data")] public TalentCustomizedDataObjectValue[]? CustomizedDatas { get; set; } /// - /// 工作经历自定义字段，无效字段，请勿使用 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// public record TalentCustomizedDataObjectValue { @@ -618,14 +624,16 @@ public record TalentCombinedProjectInfo public string? EndTime { get; set; } /// - /// 项目自定义字段，无效字段，请勿使用 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// 必填：否 /// [JsonPropertyName("customized_data")] public TalentCustomizedDataObjectValue[]? CustomizedDatas { get; set; } /// - /// 项目自定义字段，无效字段，请勿使用 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// public record TalentCustomizedDataObjectValue { @@ -716,14 +724,16 @@ public record TalentCombinedWorkInfo public string? AttachmentId { get; set; } /// - /// 作品自定义字段，无效字段，请勿使用 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// 必填：否 /// [JsonPropertyName("customized_data")] public TalentCustomizedDataObjectValue[]? CustomizedDatas { get; set; } /// - /// 作品自定义字段，无效字段，请勿使用 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// public record TalentCustomizedDataObjectValue { @@ -814,14 +824,16 @@ public record TalentCombinedAwardInfo public string? Desc { get; set; } /// - /// 获奖自定义字段，无效字段，请勿使用 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// 必填：否 /// [JsonPropertyName("customized_data")] public TalentCustomizedDataObjectValue[]? CustomizedDatas { get; set; } /// - /// 获奖自定义字段，无效字段，请勿使用 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// public record TalentCustomizedDataObjectValue { @@ -942,14 +954,16 @@ public record TalentCombinedLanguageInfo public int? Proficiency { get; set; } /// - /// 语言能力自定义字段，无效字段，请勿使用 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// 必填：否 /// [JsonPropertyName("customized_data")] public TalentCustomizedDataObjectValue[]? CustomizedDatas { get; set; } /// - /// 语言能力自定义字段，无效字段，请勿使用 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// public record TalentCustomizedDataObjectValue { @@ -1016,7 +1030,7 @@ public record TalentCombinedSnsInfo public string? Id { get; set; } /// - /// 社交账号名称 + /// SNS 名称 /// 必填：否 /// 示例值：1 /// 可选值： @@ -1037,7 +1051,7 @@ public record TalentCombinedSnsInfo public int? SnsType { get; set; } /// - /// 个人主页 URL + /// URL/ID /// 必填：否 /// 示例值：https://www.a.com /// @@ -1045,14 +1059,16 @@ public record TalentCombinedSnsInfo public string? Link { get; set; } /// - /// 社交账号自定义字段，无效字段，请勿使用 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// 必填：否 /// [JsonPropertyName("customized_data")] public TalentCustomizedDataObjectValue[]? CustomizedDatas { get; set; } /// - /// 社交账号自定义字段，无效字段，请勿使用 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// public record TalentCustomizedDataObjectValue { @@ -1098,7 +1114,7 @@ public record TalentCustomizedDataObjectValueChild } /// - /// 意向地点 + /// 意向地点，可通过[查询地点列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query)接口获取 /// 必填：否 /// 示例值：["CT_2"] /// 最大长度：100 @@ -1135,14 +1151,16 @@ public record TalentSelfEvaluation public string? Content { get; set; } /// - /// 自我评价自定义字段，无效字段，请勿使用 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// 必填：否 /// [JsonPropertyName("customized_data")] public TalentCustomizedDataObjectValue[]? CustomizedDatas { get; set; } /// - /// 自我评价自定义字段，无效字段，请勿使用 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// public record TalentCustomizedDataObjectValue { @@ -1188,14 +1206,16 @@ public record TalentCustomizedDataObjectValueChild } /// - /// 自定义模块 + /// 自定义模块列表 + /// **注意**：`children` 字段为二维数组，请参考请求体示例 /// 必填：否 /// [JsonPropertyName("customized_data")] public TalentCustomizedDataObjectValue[]? CustomizedDatas { get; set; } /// - /// 自定义模块 + /// 自定义模块列表 + /// **注意**：`children` 字段为二维数组，请参考请求体示例 /// public record TalentCustomizedDataObjectValue { diff --git a/src/Hire/PostHireV1TalentsCombinedCreateResponseDto.cs b/src/Hire/PostHireV1TalentsCombinedCreateResponseDto.cs index 6405632..dd9969b 100644 --- a/src/Hire/PostHireV1TalentsCombinedCreateResponseDto.cs +++ b/src/Hire/PostHireV1TalentsCombinedCreateResponseDto.cs @@ -45,7 +45,7 @@ public record PostHireV1TalentsCombinedCreateResponseDto /// 必填：否 /// 示例值：1 /// 可选值： - /// 1：员工体系 + /// 1：员工 /// 3：系统 /// /// diff --git a/src/Hire/PostHireV1TalentsCombinedUpdateBodyDto.cs b/src/Hire/PostHireV1TalentsCombinedUpdateBodyDto.cs index 22bd8d0..8d8025a 100644 --- a/src/Hire/PostHireV1TalentsCombinedUpdateBodyDto.cs +++ b/src/Hire/PostHireV1TalentsCombinedUpdateBodyDto.cs @@ -9,12 +9,15 @@ // // MIT // -// 更新人才信息 请求体 +// 更新人才 请求体 // ************************************************************************ namespace FeishuNetSdk.Hire; /// -/// 更新人才信息 请求体 -/// 用于在企业内更新一个人才。姓名为系统预设的必填字段，邮箱/电话字段请在飞书招聘标准简历模板设置中确认是否必填。可配合「获取人才字段接口」获取自定义字段信息。 +/// 更新人才 请求体 +/// 用于在企业内更新一个人才。支持自定义字段数据，可配合[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query) +/// 接口获取自定义字段信息使用。 +/// ## 注意事项 +/// 请求参数中邮箱/电话字段请在「飞书招聘」-「设置」-「候选人信息管理」-「标准简历设置」中确认是否必填。 /// 接口ID：7034053347989487644 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/candidate-management/talent/combined_update /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2ftalent%2fcombined_update @@ -22,9 +25,9 @@ namespace FeishuNetSdk.Hire; public record PostHireV1TalentsCombinedUpdateBodyDto { /// - /// 人才 ID + /// 人才 ID，可通过[获取人才列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent/list)接口获取 /// 必填：是 - /// 示例值：1 + /// 示例值：7158793341499426348 /// [JsonPropertyName("talent_id")] public string TalentId { get; set; } = string.Empty; @@ -38,7 +41,7 @@ public record PostHireV1TalentsCombinedUpdateBodyDto public string? InitSourceId { get; set; } /// - /// 文件夹 ID 列表 + /// 文件夹 ID 列表，可通过[获取人才文件夹列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_folder/list)接口获取 /// 必填：否 /// 示例值：["702551782317613290"] /// 最大长度：100 @@ -47,9 +50,9 @@ public record PostHireV1TalentsCombinedUpdateBodyDto public string[]? FolderIdList { get; set; } /// - /// 更新人 ID + /// 更新人 ID，与入参 `user_id_type` 类型一致 /// 必填：否 - /// 示例值：ou_xxx + /// 示例值：ou_84aad35d084aa403a838cf73ee18467 /// [JsonPropertyName("operator_id")] public string? OperatorId { get; set; } @@ -59,7 +62,7 @@ public record PostHireV1TalentsCombinedUpdateBodyDto /// 必填：否 /// 示例值：1 /// 可选值： - /// 1：员工体系 + /// 1：员工 /// 3：系统 /// /// @@ -67,35 +70,35 @@ public record PostHireV1TalentsCombinedUpdateBodyDto public int? OperatorAccountType { get; set; } /// - /// 简历附件id + /// 简历附件 ID，如何创建附件请参考[创建附件](https://open.feishu.cn/document/ukTMukTMukTM/uIDN1YjLyQTN24iM0UjN/create_attachment) /// 必填：否 - /// 示例值：12345 + /// 示例值：7383906146040678700 /// [JsonPropertyName("resume_attachment_id")] public string? ResumeAttachmentId { get; set; } /// - /// 基础信息 + /// 基本信息 /// 必填：是 /// [JsonPropertyName("basic_info")] public TalentCombinedBasicInfo BasicInfo { get; set; } = new(); /// - /// 基础信息 + /// 基本信息 /// public record TalentCombinedBasicInfo { /// /// 名字 /// 必填：是 - /// 示例值：测试 + /// 示例值：张三 /// [JsonPropertyName("name")] public string Name { get; set; } = string.Empty; /// - /// 手机号 + /// 手机 /// 必填：否 /// 示例值：182900291190 /// @@ -103,7 +106,7 @@ public record TalentCombinedBasicInfo public string? Mobile { get; set; } /// - /// 手机国家代码 + /// 手机国家代码，可通过[查询地点列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query)接口获取 /// 必填：否 /// 示例值：CN_1 /// @@ -157,15 +160,15 @@ public record TalentIdentificationInfo } /// - /// 开始工作时间 + /// 开始工作时间，毫秒时间戳 /// 必填：否 - /// 示例值：293016767159 + /// 示例值：1686832459000 /// [JsonPropertyName("start_work_time")] public string? StartWorkTime { get; set; } /// - /// 出生日期 + /// 出生日期时间，毫秒时间戳 /// 必填：否 /// 示例值：293016767159 /// @@ -186,7 +189,7 @@ public record TalentIdentificationInfo public int? Gender { get; set; } /// - /// 国籍编码 + /// 国籍编码，可通过[查询地点列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query)获取 /// 必填：否 /// 示例值：CN_112 /// @@ -194,7 +197,7 @@ public record TalentIdentificationInfo public string? NationalityId { get; set; } /// - /// 所在地点编码 + /// 所在地点编码，可通过[查询地点列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query)获取 /// 必填：否 /// 示例值：CT_159 /// @@ -202,7 +205,7 @@ public record TalentIdentificationInfo public string? CurrentCityCode { get; set; } /// - /// 家乡编码 + /// 家乡编码，可通过[查询地点列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query)获取 /// 必填：否 /// 示例值：CT_159 /// @@ -211,6 +214,7 @@ public record TalentIdentificationInfo /// /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// 必填：否 /// [JsonPropertyName("customized_data")] @@ -218,11 +222,13 @@ public record TalentIdentificationInfo /// /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// public record TalentCustomizedDataObjectValue { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query) + /// 接口获取 /// 必填：否 /// 示例值：6934193211960330504 /// @@ -242,7 +248,8 @@ public record TalentCustomizedDataObjectValue public record TalentCustomizedDataObjectValueChild { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query) + /// 接口获取 /// 必填：否 /// 示例值：6934193211960330504 /// @@ -250,7 +257,7 @@ public record TalentCustomizedDataObjectValueChild public string? ObjectId { get; set; } /// - /// 自定义字段值 + /// 自定义字段值，请参考本文「自定义字段数据格式说明」 /// 必填：否 /// 示例值：张三 /// @@ -262,6 +269,7 @@ public record TalentCustomizedDataObjectValueChild /// /// 教育经历 + /// **注意**：更新时会全量覆盖 /// 必填：否 /// 最大长度：100 /// @@ -270,11 +278,12 @@ public record TalentCustomizedDataObjectValueChild /// /// 教育经历 + /// **注意**：更新时会全量覆盖 /// public record TalentCombinedEducationInfo { /// - /// ID + /// 教育经历 ID，无效字段，请勿使用 /// 必填：否 /// 示例值：6891560630172518670 /// @@ -303,7 +312,7 @@ public record TalentCombinedEducationInfo /// /// 学校 /// 必填：否 - /// 示例值：湘港大学 + /// 示例值：香港大学 /// [JsonPropertyName("school")] public string? School { get; set; } @@ -317,7 +326,7 @@ public record TalentCombinedEducationInfo public string? FieldOfStudy { get; set; } /// - /// 开始时间 + /// 教育经历开始时间，毫秒时间戳 /// 必填：否 /// 示例值：293016767159 /// @@ -325,7 +334,7 @@ public record TalentCombinedEducationInfo public string? StartTime { get; set; } /// - /// 结束时间 + /// 教育经历结束时间，毫秒时间戳 /// 必填：否 /// 示例值：293016767159 /// @@ -364,19 +373,22 @@ public record TalentCombinedEducationInfo public int? AcademicRanking { get; set; } /// - /// 自定义字段 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// 必填：否 /// [JsonPropertyName("customized_data")] public TalentCustomizedDataObjectValue[]? CustomizedDatas { get; set; } /// - /// 自定义字段 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// public record TalentCustomizedDataObjectValue { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query) + /// 接口获取 /// 必填：否 /// 示例值：6934193211960330504 /// @@ -396,7 +408,8 @@ public record TalentCustomizedDataObjectValue public record TalentCustomizedDataObjectValueChild { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query) + /// 接口获取 /// 必填：否 /// 示例值：6934193211960330504 /// @@ -404,7 +417,7 @@ public record TalentCustomizedDataObjectValueChild public string? ObjectId { get; set; } /// - /// 自定义字段值 + /// 自定义字段值，请参考本文「自定义字段数据格式说明」 /// 必填：否 /// 示例值：张三 /// @@ -416,6 +429,7 @@ public record TalentCustomizedDataObjectValueChild /// /// 工作经历 + /// **注意**：更新时会全量覆盖 /// 必填：否 /// 最大长度：100 /// @@ -424,11 +438,12 @@ public record TalentCustomizedDataObjectValueChild /// /// 工作经历 + /// **注意**：更新时会全量覆盖 /// public record TalentCombinedCareerInfo { /// - /// ID + /// 工作经历 ID，无效字段，请勿使用 /// 必填：否 /// 示例值：6891560630172518670 /// @@ -438,7 +453,7 @@ public record TalentCombinedCareerInfo /// /// 公司名称 /// 必填：否 - /// 示例值：测试公司 + /// 示例值：明日科技公司 /// [JsonPropertyName("company")] public string? Company { get; set; } @@ -452,7 +467,7 @@ public record TalentCombinedCareerInfo public string? Title { get; set; } /// - /// 描述 + /// 工作经历描述 /// 必填：否 /// 示例值：测试 /// @@ -460,7 +475,7 @@ public record TalentCombinedCareerInfo public string? Desc { get; set; } /// - /// 开始时间 + /// 工作经历开始时间，毫秒时间戳 /// 必填：否 /// 示例值：293016767159 /// @@ -468,7 +483,7 @@ public record TalentCombinedCareerInfo public string? StartTime { get; set; } /// - /// 结束时间 + /// 工作经历结束时间，毫秒时间戳 /// 必填：否 /// 示例值：293016767159 /// @@ -476,7 +491,7 @@ public record TalentCombinedCareerInfo public string? EndTime { get; set; } /// - /// 经历类型 + /// 工作经历类型 /// 必填：否 /// 示例值：1 /// 可选值： @@ -488,19 +503,22 @@ public record TalentCombinedCareerInfo public int? CareerType { get; set; } /// - /// 自定义字段 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// 必填：否 /// [JsonPropertyName("customized_data")] public TalentCustomizedDataObjectValue[]? CustomizedDatas { get; set; } /// - /// 自定义字段 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// public record TalentCustomizedDataObjectValue { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query) + /// 接口获取 /// 必填：否 /// 示例值：6934193211960330504 /// @@ -520,7 +538,8 @@ public record TalentCustomizedDataObjectValue public record TalentCustomizedDataObjectValueChild { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query) + /// 接口获取 /// 必填：否 /// 示例值：6934193211960330504 /// @@ -528,7 +547,7 @@ public record TalentCustomizedDataObjectValueChild public string? ObjectId { get; set; } /// - /// 自定义字段值 + /// 自定义字段值，请参考本文「自定义字段数据格式说明」 /// 必填：否 /// 示例值：张三 /// @@ -540,6 +559,7 @@ public record TalentCustomizedDataObjectValueChild /// /// 项目经历 + /// **注意**：更新时会全量覆盖 /// 必填：否 /// 最大长度：100 /// @@ -548,11 +568,12 @@ public record TalentCustomizedDataObjectValueChild /// /// 项目经历 + /// **注意**：更新时会全量覆盖 /// public record TalentCombinedProjectInfo { /// - /// ID + /// 项目经历 ID，无效字段，请勿使用 /// 必填：否 /// 示例值：6891560630172518670 /// @@ -562,7 +583,7 @@ public record TalentCombinedProjectInfo /// /// 项目名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：系统稳定性提升项目 /// [JsonPropertyName("name")] public string? Name { get; set; } @@ -570,7 +591,7 @@ public record TalentCombinedProjectInfo /// /// 项目角色 /// 必填：否 - /// 示例值：test + /// 示例值：研发人员 /// [JsonPropertyName("role")] public string? Role { get; set; } @@ -584,15 +605,15 @@ public record TalentCombinedProjectInfo public string? Link { get; set; } /// - /// 描述 + /// 项目描述 /// 必填：否 - /// 示例值：xxx + /// 示例值：该项目目标是提升整个系统的稳定性，达到行业一流水准。 /// [JsonPropertyName("desc")] public string? Desc { get; set; } /// - /// 开始时间 + /// 项目开始时间，毫秒时间戳 /// 必填：否 /// 示例值：293016767159 /// @@ -600,7 +621,7 @@ public record TalentCombinedProjectInfo public string? StartTime { get; set; } /// - /// 结束时间 + /// 项目结束时间，毫秒时间戳 /// 必填：否 /// 示例值：293016767159 /// @@ -608,19 +629,22 @@ public record TalentCombinedProjectInfo public string? EndTime { get; set; } /// - /// 自定义字段 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// 必填：否 /// [JsonPropertyName("customized_data")] public TalentCustomizedDataObjectValue[]? CustomizedDatas { get; set; } /// - /// 自定义字段 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// public record TalentCustomizedDataObjectValue { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query) + /// 接口获取 /// 必填：否 /// 示例值：6934193211960330504 /// @@ -640,7 +664,8 @@ public record TalentCustomizedDataObjectValue public record TalentCustomizedDataObjectValueChild { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query) + /// 接口获取 /// 必填：否 /// 示例值：6934193211960330504 /// @@ -648,7 +673,7 @@ public record TalentCustomizedDataObjectValueChild public string? ObjectId { get; set; } /// - /// 自定义字段值 + /// 自定义字段值，请参考本文「自定义字段数据格式说明」 /// 必填：否 /// 示例值：张三 /// @@ -660,6 +685,7 @@ public record TalentCustomizedDataObjectValueChild /// /// 作品 + /// **注意**：更新时会全量覆盖 /// 必填：否 /// 最大长度：100 /// @@ -668,11 +694,12 @@ public record TalentCustomizedDataObjectValueChild /// /// 作品 + /// **注意**：更新时会全量覆盖 /// public record TalentCombinedWorkInfo { /// - /// ID + /// 作品 ID，无效字段，请勿使用 /// 必填：否 /// 示例值：6891560630172518670 /// @@ -688,7 +715,7 @@ public record TalentCombinedWorkInfo public string? Link { get; set; } /// - /// 描述 + /// 作品描述 /// 必填：否 /// 示例值：个人设计作品 /// @@ -696,7 +723,7 @@ public record TalentCombinedWorkInfo public string? Desc { get; set; } /// - /// 附件 ID + /// 作品附件 ID /// 必填：否 /// 示例值：12345678 /// @@ -704,19 +731,22 @@ public record TalentCombinedWorkInfo public string? AttachmentId { get; set; } /// - /// 自定义字段 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// 必填：否 /// [JsonPropertyName("customized_data")] public TalentCustomizedDataObjectValue[]? CustomizedDatas { get; set; } /// - /// 自定义字段 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// public record TalentCustomizedDataObjectValue { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query) + /// 接口获取 /// 必填：否 /// 示例值：6934193211960330504 /// @@ -736,7 +766,8 @@ public record TalentCustomizedDataObjectValue public record TalentCustomizedDataObjectValueChild { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query) + /// 接口获取 /// 必填：否 /// 示例值：6934193211960330504 /// @@ -744,7 +775,7 @@ public record TalentCustomizedDataObjectValueChild public string? ObjectId { get; set; } /// - /// 自定义字段值 + /// 自定义字段值，请参考本文「自定义字段数据格式说明」 /// 必填：否 /// 示例值：张三 /// @@ -756,6 +787,7 @@ public record TalentCustomizedDataObjectValueChild /// /// 获奖 + /// **注意**：更新时会全量覆盖 /// 必填：否 /// 最大长度：100 /// @@ -764,11 +796,12 @@ public record TalentCustomizedDataObjectValueChild /// /// 获奖 + /// **注意**：更新时会全量覆盖 /// public record TalentCombinedAwardInfo { /// - /// ID + /// 获奖 ID，无效字段，请勿使用 /// 必填：否 /// 示例值：6891560630172518670 /// @@ -784,7 +817,7 @@ public record TalentCombinedAwardInfo public string? Title { get; set; } /// - /// 获奖时间 + /// 获奖时间，毫秒时间戳 /// 必填：否 /// 示例值：293016767159 /// @@ -792,7 +825,7 @@ public record TalentCombinedAwardInfo public string? AwardTime { get; set; } /// - /// 描述 + /// 获奖描述 /// 必填：否 /// 示例值：最优秀的新人奖 /// @@ -800,19 +833,22 @@ public record TalentCombinedAwardInfo public string? Desc { get; set; } /// - /// 自定义字段 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// 必填：否 /// [JsonPropertyName("customized_data")] public TalentCustomizedDataObjectValue[]? CustomizedDatas { get; set; } /// - /// 自定义字段 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// public record TalentCustomizedDataObjectValue { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query) + /// 接口获取 /// 必填：否 /// 示例值：6934193211960330504 /// @@ -832,7 +868,8 @@ public record TalentCustomizedDataObjectValue public record TalentCustomizedDataObjectValueChild { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query) + /// 接口获取 /// 必填：否 /// 示例值：6934193211960330504 /// @@ -840,7 +877,7 @@ public record TalentCustomizedDataObjectValueChild public string? ObjectId { get; set; } /// - /// 自定义字段值 + /// 自定义字段值，请参考本文「自定义字段数据格式说明」 /// 必填：否 /// 示例值：张三 /// @@ -852,6 +889,7 @@ public record TalentCustomizedDataObjectValueChild /// /// 语言能力 + /// **注意**：更新时会全量覆盖 /// 必填：否 /// 最大长度：100 /// @@ -860,11 +898,12 @@ public record TalentCustomizedDataObjectValueChild /// /// 语言能力 + /// **注意**：更新时会全量覆盖 /// public record TalentCombinedLanguageInfo { /// - /// ID + /// 语言能力 ID，无效字段，请勿使用 /// 必填：否 /// 示例值：6891560630172518670 /// @@ -872,7 +911,7 @@ public record TalentCombinedLanguageInfo public string? Id { get; set; } /// - /// 语言 + /// 语言类型 /// 必填：否 /// 示例值：1 /// 可选值： @@ -901,13 +940,17 @@ public record TalentCombinedLanguageInfo /// 23：越南语 /// 24：普通话 /// 25：粤语 + /// 26：印尼语 + /// 27：马来语 + /// 28：泰语 + /// 29：塞尔维亚语 /// /// [JsonPropertyName("language")] public int? Language { get; set; } /// - /// 精通程度 + /// 语言精通程度 /// 必填：否 /// 示例值：1 /// 可选值： @@ -922,19 +965,22 @@ public record TalentCombinedLanguageInfo public int? Proficiency { get; set; } /// - /// 自定义字段 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// 必填：否 /// [JsonPropertyName("customized_data")] public TalentCustomizedDataObjectValue[]? CustomizedDatas { get; set; } /// - /// 自定义字段 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// public record TalentCustomizedDataObjectValue { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query) + /// 接口获取 /// 必填：否 /// 示例值：6934193211960330504 /// @@ -954,7 +1000,8 @@ public record TalentCustomizedDataObjectValue public record TalentCustomizedDataObjectValueChild { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query) + /// 接口获取 /// 必填：否 /// 示例值：6934193211960330504 /// @@ -962,7 +1009,7 @@ public record TalentCustomizedDataObjectValueChild public string? ObjectId { get; set; } /// - /// 自定义字段值 + /// 自定义字段值，请参考本文「自定义字段数据格式说明」 /// 必填：否 /// 示例值：张三 /// @@ -974,6 +1021,7 @@ public record TalentCustomizedDataObjectValueChild /// /// 社交账号 + /// **注意**：更新时会全量覆盖 /// 必填：否 /// 最大长度：100 /// @@ -982,11 +1030,12 @@ public record TalentCustomizedDataObjectValueChild /// /// 社交账号 + /// **注意**：更新时会全量覆盖 /// public record TalentCombinedSnsInfo { /// - /// ID + /// 社交账号 ID，无效字段，请勿使用 /// 必填：否 /// 示例值：6891560630172518670 /// @@ -994,7 +1043,7 @@ public record TalentCombinedSnsInfo public string? Id { get; set; } /// - /// SNS名称 + /// SNS 名称 /// 必填：否 /// 示例值：1 /// 可选值： @@ -1023,19 +1072,22 @@ public record TalentCombinedSnsInfo public string? Link { get; set; } /// - /// 自定义字段 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// 必填：否 /// [JsonPropertyName("customized_data")] public TalentCustomizedDataObjectValue[]? CustomizedDatas { get; set; } /// - /// 自定义字段 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// public record TalentCustomizedDataObjectValue { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query) + /// 接口获取 /// 必填：否 /// 示例值：6934193211960330504 /// @@ -1055,7 +1107,8 @@ public record TalentCustomizedDataObjectValue public record TalentCustomizedDataObjectValueChild { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query) + /// 接口获取 /// 必填：否 /// 示例值：6934193211960330504 /// @@ -1063,7 +1116,7 @@ public record TalentCustomizedDataObjectValueChild public string? ObjectId { get; set; } /// - /// 自定义字段值 + /// 自定义字段值，请参考本文「自定义字段数据格式说明」 /// 必填：否 /// 示例值：张三 /// @@ -1074,7 +1127,7 @@ public record TalentCustomizedDataObjectValueChild } /// - /// 偏好城市 + /// 意向地点，可通过[查询地点列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query)接口获取 /// 必填：否 /// 示例值：["CT_2"] /// 最大长度：100 @@ -1095,7 +1148,7 @@ public record TalentCustomizedDataObjectValueChild public record TalentSelfEvaluation { /// - /// ID + /// 自我评价 ID，无效字段，请勿使用 /// 必填：否 /// 示例值：6891560630172518670 /// @@ -1103,7 +1156,7 @@ public record TalentSelfEvaluation public string? Id { get; set; } /// - /// 内容 + /// 自我评价内容 /// 必填：否 /// 示例值：自我评价：平常心 /// @@ -1111,19 +1164,22 @@ public record TalentSelfEvaluation public string? Content { get; set; } /// - /// 自定义字段 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// 必填：否 /// [JsonPropertyName("customized_data")] public TalentCustomizedDataObjectValue[]? CustomizedDatas { get; set; } /// - /// 自定义字段 + /// 自定义字段列表 + /// **注意**：`children` 字段无效，请参考请求体示例在当前层级传入 `object_id` 和 `value` /// public record TalentCustomizedDataObjectValue { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query) + /// 接口获取 /// 必填：否 /// 示例值：6934193211960330504 /// @@ -1143,7 +1199,8 @@ public record TalentCustomizedDataObjectValue public record TalentCustomizedDataObjectValueChild { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query) + /// 接口获取 /// 必填：否 /// 示例值：6934193211960330504 /// @@ -1151,7 +1208,7 @@ public record TalentCustomizedDataObjectValueChild public string? ObjectId { get; set; } /// - /// 自定义字段值 + /// 自定义字段值，请参考本文「自定义字段数据格式说明」 /// 必填：否 /// 示例值：张三 /// @@ -1162,19 +1219,26 @@ public record TalentCustomizedDataObjectValueChild } /// - /// 自定义模块 + /// 自定义模块列表 + /// **注意**： + /// - `children` 字段为二维数组，请参考请求体示例 + /// - 更新时会全量覆盖 /// 必填：否 /// [JsonPropertyName("customized_data")] public TalentCustomizedDataObjectValue[]? CustomizedDatas { get; set; } /// - /// 自定义模块 + /// 自定义模块列表 + /// **注意**： + /// - `children` 字段为二维数组，请参考请求体示例 + /// - 更新时会全量覆盖 /// public record TalentCustomizedDataObjectValue { /// - /// 自定义字段 ID + /// 自定义模块 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query) + /// 接口获取 /// 必填：否 /// 示例值：6934193211960330504 /// @@ -1194,7 +1258,8 @@ public record TalentCustomizedDataObjectValue public record TalentCustomizedDataObjectValueChild { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query) + /// 接口获取 /// 必填：否 /// 示例值：6934193211960330504 /// @@ -1202,7 +1267,7 @@ public record TalentCustomizedDataObjectValueChild public string? ObjectId { get; set; } /// - /// 自定义字段值 + /// 自定义字段值，请参考本文「自定义字段数据格式说明」 /// 必填：否 /// 示例值：张三 /// diff --git a/src/Hire/PostHireV1TalentsCombinedUpdateResponseDto.cs b/src/Hire/PostHireV1TalentsCombinedUpdateResponseDto.cs index d2824ea..178326a 100644 --- a/src/Hire/PostHireV1TalentsCombinedUpdateResponseDto.cs +++ b/src/Hire/PostHireV1TalentsCombinedUpdateResponseDto.cs @@ -9,12 +9,15 @@ // // MIT // -// 更新人才信息 响应体 +// 更新人才 响应体 // ************************************************************************ namespace FeishuNetSdk.Hire; /// -/// 更新人才信息 响应体 -/// 用于在企业内更新一个人才。姓名为系统预设的必填字段，邮箱/电话字段请在飞书招聘标准简历模板设置中确认是否必填。可配合「获取人才字段接口」获取自定义字段信息。 +/// 更新人才 响应体 +/// 用于在企业内更新一个人才。支持自定义字段数据，可配合[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query) +/// 接口获取自定义字段信息使用。 +/// ## 注意事项 +/// 请求参数中邮箱/电话字段请在「飞书招聘」-「设置」-「候选人信息管理」-「标准简历设置」中确认是否必填。 /// 接口ID：7034053347989487644 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/candidate-management/talent/combined_update /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2ftalent%2fcombined_update @@ -30,9 +33,9 @@ public record PostHireV1TalentsCombinedUpdateResponseDto public string? TalentId { get; set; } /// - /// 更新人 ID + /// 更新人 ID，与入参 `user_id_type` 类型一致 /// 必填：否 - /// 示例值：ou_xxx + /// 示例值：ou_84aad35d084aa403a838cf73ee18467 /// [JsonPropertyName("operator_id")] public string? OperatorId { get; set; } @@ -42,7 +45,7 @@ public record PostHireV1TalentsCombinedUpdateResponseDto /// 必填：否 /// 示例值：1 /// 可选值： - /// 1：员工体系 + /// 1：员工 /// 3：系统 /// /// diff --git a/src/Hire/PostHireV1TripartiteAgreementsBodyDto.cs b/src/Hire/PostHireV1TripartiteAgreementsBodyDto.cs index 5833815..4f6493b 100644 --- a/src/Hire/PostHireV1TripartiteAgreementsBodyDto.cs +++ b/src/Hire/PostHireV1TripartiteAgreementsBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 创建三方协议 请求体 -/// 在投递上创建三方协议。 +/// 在校招投递上创建三方协议。 /// ## 前提条件 /// - 在「飞书招聘」-「设置」-「候选人流程管理」-「三方协议设置」中勾选了「通过 API 维护三方协议」。 /// - 该投递为校招投递。 diff --git a/src/Hire/PostHireV1TripartiteAgreementsResponseDto.cs b/src/Hire/PostHireV1TripartiteAgreementsResponseDto.cs index 901729d..a6d5270 100644 --- a/src/Hire/PostHireV1TripartiteAgreementsResponseDto.cs +++ b/src/Hire/PostHireV1TripartiteAgreementsResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 创建三方协议 响应体 -/// 在投递上创建三方协议。 +/// 在校招投递上创建三方协议。 /// ## 前提条件 /// - 在「飞书招聘」-「设置」-「候选人流程管理」-「三方协议设置」中勾选了「通过 API 维护三方协议」。 /// - 该投递为校招投递。 diff --git a/src/Hire/PostHireV1WebsitesByWebsiteIdJobPostsSearchBodyDto.cs b/src/Hire/PostHireV1WebsitesByWebsiteIdJobPostsSearchBodyDto.cs index bc59963..7b630f3 100644 --- a/src/Hire/PostHireV1WebsitesByWebsiteIdJobPostsSearchBodyDto.cs +++ b/src/Hire/PostHireV1WebsitesByWebsiteIdJobPostsSearchBodyDto.cs @@ -9,11 +9,11 @@ // // MIT // -// 搜索招聘官网下的职位列表 请求体 +// 搜索招聘官网下的职位广告列表 请求体 // ************************************************************************ namespace FeishuNetSdk.Hire; /// -/// 搜索招聘官网下的职位列表 请求体 +/// 搜索招聘官网下的职位广告列表 请求体 /// 搜索招聘官网下的职位列表。 /// 接口ID：7021042393814450179 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/get-candidates/website/search @@ -22,7 +22,7 @@ namespace FeishuNetSdk.Hire; public record PostHireV1WebsitesByWebsiteIdJobPostsSearchBodyDto { /// - /// 职位类型列表，详情请参考：[获取职位类别列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_type/list) + /// 职位类别列表，详情请参考：[获取职位类别列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_type/list) /// 必填：否 /// 示例值：6916472453069883661 /// 最大长度：100 diff --git a/src/Hire/PostHireV1WebsitesByWebsiteIdJobPostsSearchResponseDto.cs b/src/Hire/PostHireV1WebsitesByWebsiteIdJobPostsSearchResponseDto.cs index 216ac93..63153ed 100644 --- a/src/Hire/PostHireV1WebsitesByWebsiteIdJobPostsSearchResponseDto.cs +++ b/src/Hire/PostHireV1WebsitesByWebsiteIdJobPostsSearchResponseDto.cs @@ -9,11 +9,11 @@ // // MIT // -// 搜索招聘官网下的职位列表 响应体 +// 搜索招聘官网下的职位广告列表 响应体 // ************************************************************************ namespace FeishuNetSdk.Hire; /// -/// 搜索招聘官网下的职位列表 响应体 +/// 搜索招聘官网下的职位广告列表 响应体 /// 搜索招聘官网下的职位列表。 /// 接口ID：7021042393814450179 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/get-candidates/website/search @@ -42,7 +42,7 @@ public record WebsiteJobPost public string? Id { get; set; } /// - /// 标题 + /// 职位名称 /// 必填：否 /// 示例值：职位1 /// @@ -155,7 +155,7 @@ public record I18n public IdNameObject? JobDepartment { get; set; } /// - /// 职位类型，详情请参考：[获取职位类别列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_type/list) + /// 职位类别，详情请参考：[获取职位类别列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_type/list) /// 必填：否 /// [JsonPropertyName("job_type")] diff --git a/src/Hire/PutHireV1JobRequirementsByJobRequirementIdBodyDto.cs b/src/Hire/PutHireV1JobRequirementsByJobRequirementIdBodyDto.cs index 351b486..bcfa5fb 100644 --- a/src/Hire/PutHireV1JobRequirementsByJobRequirementIdBodyDto.cs +++ b/src/Hire/PutHireV1JobRequirementsByJobRequirementIdBodyDto.cs @@ -186,7 +186,7 @@ public record PutHireV1JobRequirementsByJobRequirementIdBodyDto public int? RequiredDegree { get; set; } /// - /// 最高薪资，单位：K + /// 月薪范围-最高薪资，单位：K /// 必填：否 /// 示例值：10 /// @@ -194,7 +194,7 @@ public record PutHireV1JobRequirementsByJobRequirementIdBodyDto public string? MaxSalary { get; set; } /// - /// 最低薪资，单位：K + /// 月薪范围-最低薪资，单位：K /// 必填：否 /// 示例值：5 /// @@ -218,14 +218,16 @@ public record PutHireV1JobRequirementsByJobRequirementIdBodyDto public string? Description { get; set; } /// - /// 自定义字段，可通过[获取招聘需求模板](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_requirement_schema/list)获取，自定义字段是否必填需依据需求模板中自定义字段的定义 + /// 自定义字段，可通过[获取招聘需求模板](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_requirement_schema/list)获取，自定义字段是否必填需依据需求模板中自定义字段的定义。 + /// - 注意： 更新时会全量覆盖 /// 必填：否 /// [JsonPropertyName("customized_data_list")] public JobRequirementCustomizedData[]? CustomizedDataLists { get; set; } /// - /// 自定义字段，可通过[获取招聘需求模板](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_requirement_schema/list)获取，自定义字段是否必填需依据需求模板中自定义字段的定义 + /// 自定义字段，可通过[获取招聘需求模板](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_requirement_schema/list)获取，自定义字段是否必填需依据需求模板中自定义字段的定义。 + /// - 注意： 更新时会全量覆盖 /// public record JobRequirementCustomizedData { @@ -239,15 +241,15 @@ public record JobRequirementCustomizedData /// /// 自定义字段 value - /// 1. 若字段类型为单行文本/多行文本，格式为"简单文本"； - /// 2. 若字段类型为单选，传值内容为选项的 ID，格式为"6890840516938696974"； - /// 3. 若字段类型为多选，传值内容为选项的ID 列表，格式为"[\"6890840516938696974\", \"6890840516938696975\" ]"； - /// 4. 若字段类型为时间，格式为"1609430400000" - /// 5. 若字段类型为时间段，格式为"["1609430400000", \"1612108800000\" ]"，单位是毫秒时间戳； - /// 5. 若字段类型为年份选择，格式为"1609430400000"，单位是毫秒时间戳； - /// 6. 若字段类型为月份选择，格式为"1625068800000"，单位是毫秒时间戳； - /// 7. 若字段类型为数字，传值格式为"1"; - /// 8. 若字段类型为富文本，传值举例"富文本" + /// - 单选：`"1"` + /// - 多选：`"[\"1\", \"2\"]"` + /// - 单行：`"单行文本"` + /// - 多行：`"多行文本"` + /// - 数字：`"1"` + /// - 月份选择：`"1627379423000"` + /// - 年份选择：`"1627379423000"` + /// - 日期选择：`"1627379423000"` + /// - 时间段：`"[\"1577808000000\", \"1612108800000\"]"` /// 必填：否 /// 示例值：简单文本 /// diff --git a/src/Hire/PutHireV1TripartiteAgreementsByTripartiteAgreementIdBodyDto.cs b/src/Hire/PutHireV1TripartiteAgreementsByTripartiteAgreementIdBodyDto.cs index 6ab20c6..fb1e022 100644 --- a/src/Hire/PutHireV1TripartiteAgreementsByTripartiteAgreementIdBodyDto.cs +++ b/src/Hire/PutHireV1TripartiteAgreementsByTripartiteAgreementIdBodyDto.cs @@ -43,7 +43,8 @@ public record PutHireV1TripartiteAgreementsByTripartiteAgreementIdBodyDto public int State { get; set; } /// - /// 三方协议修改时间，毫秒时间戳，不可小于创建时间或者当前修改时间 + /// 三方协议修改时间，毫秒时间戳 + /// **注意**：不可小于创建时间或者上次修改时间 /// 必填：是 /// 示例值：1698292282661 /// diff --git a/src/IFeishuTenantApi.cs b/src/IFeishuTenantApi.cs index 0279931..79a076f 100644 --- a/src/IFeishuTenantApi.cs +++ b/src/IFeishuTenantApi.cs @@ -4,7 +4,7 @@ // Created : 2024-06-24 // // Last Modified By : yxr -// Last Modified On : 2024-08-24 +// Last Modified On : 2024-08-28 // ************************************************************************ // // MIT @@ -9492,11 +9492,11 @@ System.Threading.Tasks.Task PostHelpdeskV1EventsUnsubscribeAsync [PathQuery] string? employee_type_id_type = "people_admin_employee_type_id"); /// - /// 【招聘】更新入职状态 + /// 【招聘】更新员工状态 /// 接口ID：6959374328975900674 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/employee/patch /// Authorization：tenant_access_token - /// 根据员工 ID 更新员工转正、离职状态。 + /// 根据员工 ID 更新员工招聘系统内的转正、离职状态。 /// 权限要求： /// hire:employee /// @@ -9507,8 +9507,8 @@ System.Threading.Tasks.Task PostHelpdeskV1EventsUnsubscribeAsync /// /// 路径参数 /// 必填：是 - /// 员工ID - /// 示例值：123 + /// 员工ID，请参考：[通过投递 ID 获取入职信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/employee/get_by_application) + /// 示例值：6891613503971461384 /// /// /// 必填：否 @@ -9523,11 +9523,11 @@ System.Threading.Tasks.Task PostHelpdeskV1EventsUnsubscribeAsync /// /// /// 必填：否 - /// 此次调用中使用的部门 ID 的类型 + /// 指定查询结果中的部门 ID 类型。关于部门 ID 的详细介绍，可参见[部门资源介绍](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview)。 /// 示例值：department_id /// - /// open_department_id：以 open_department_id 来标识部门 - /// department_id：以 department_id 来标识部门 + /// open_department_id：以 open_department_id 来标识部门 由系统自动生成的部门 ID，ID 前缀固定为 `od-`，在租户内全局唯一。 + /// department_id：支持用户自定义配置的部门 ID。自定义配置时可复用已删除的 department_id，因此在未删除的部门范围内 department_id 具有唯一性。 /// people_admin_department_id：以 people_admin_department_id 来标识部门 /// /// 默认值：people_admin_department_id @@ -9538,7 +9538,7 @@ System.Threading.Tasks.Task PostHelpdeskV1EventsUnsubscribeAsync /// 示例值：6942778198054125570 /// /// people_admin_job_level_id：「人力系统管理后台」适用的职级 ID。人力系统管理后台逐步下线中，建议不继续使用此 ID。 - /// job_level_id：「飞书管理后台」适用的职级 ID，通过[「获取租户职级列表」](https://open.feishu.cn/document/server-docs/contact-v3/job_level/list)接口获取 + /// job_level_id：「飞书管理后台」适用的职级 ID，通过 [获取租户职级列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/job_level/list) 接口获取 /// /// 默认值：people_admin_job_level_id /// @@ -9548,7 +9548,7 @@ System.Threading.Tasks.Task PostHelpdeskV1EventsUnsubscribeAsync /// 示例值：6942778198054125571 /// /// people_admin_job_category_id：「人力系统管理后台」适用的序列 ID。人力系统管理后台逐步下线中，建议不继续使用此 ID。 - /// job_family_id：「飞书管理后台」适用的序列 ID，通过[「获取租户序列列表」](https://open.feishu.cn/document/server-docs/contact-v3/job_family/list)接口获取 + /// job_family_id：「飞书管理后台」适用的序列 ID，通过 [获取租户序列列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/job_family/list) 接口获取 /// /// 默认值：people_admin_job_category_id /// @@ -9558,7 +9558,7 @@ System.Threading.Tasks.Task PostHelpdeskV1EventsUnsubscribeAsync /// 示例值：1 /// /// people_admin_employee_type_id：「人力系统管理后台」适用的人员类型 ID。人力系统管理后台逐步下线中，建议不继续使用此 ID。 - /// employee_type_enum_id：「飞书管理后台」适用的人员类型 ID，通过[「查询人员类型」](https://open.feishu.cn/document/server-docs/contact-v3/employee_type_enum/list)接口获取 + /// employee_type_enum_id：「飞书管理后台」适用的人员类型 ID，通过 [查询人员类型](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/employee_type_enum/list)接口获取 /// /// 默认值：people_admin_employee_type_id /// @@ -10387,7 +10387,7 @@ System.Threading.Tasks.Task DeleteVcV1ReservesByReserveIdAsync( /// 接口ID：6964286393804800028 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/transfer_onboard /// Authorization：tenant_access_token - /// 根据投递 ID 操作候选人入职并创建员工。投递须处于「待入职」阶段，可通过「转移阶段」接口变更投递状态。 + /// 根据投递 ID 操作候选人入职并创建员工。后续可通过接口进一步获取入职信息，详情参考：[通过员工 ID 获取入职信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/employee/get) /// 权限要求： /// hire:application /// @@ -10398,7 +10398,7 @@ System.Threading.Tasks.Task DeleteVcV1ReservesByReserveIdAsync( /// /// 路径参数 /// 必填：是 - /// 投递ID + /// 投递ID，可通过接口 [获取投递列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/list) 获取 /// 示例值：7073372582620416300 /// /// @@ -10680,7 +10680,9 @@ System.Threading.Tasks.Task PostHireV1ApplicationsByApplicationI /// /// 路径参数 /// 必填：是 - /// 附件 ID，可通过[获取人才信息 V1](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent/get)接口获取人才的简历附件 ID/作品附件 ID/通用附件 ID。 + /// 附件 ID，获取方式如下： + /// - 简历附件 ID/作品附件 ID：通过[获取人才信息 V1](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent/get)接口获取 + /// - 通用附件 ID：通过[创建附件](https://open.feishu.cn/document/ukTMukTMukTM/uIDN1YjLyQTN24iM0UjN/create_attachment) 接口获取 /// 示例值：6960663240925956555 /// /// @@ -10690,7 +10692,7 @@ System.Threading.Tasks.Task PostHireV1ApplicationsByApplicationI /// /// 1：简历附件，人才上的简历附件。 /// 2：作品附件，人才上的作品附件。 - /// 3：通用附件，通过[创建附件](https://open.feishu.cn/document/ukTMukTMukTM/uIDN1YjLyQTN24iM0UjN/create_attachment) 接口创建的附件，或者业务接口中返回的非`简历附件`和`作品附件`类型的附件，如「自定义字段附件」、「Offer 附件」等。 + /// 3：通用附件，通过[创建附件](https://open.feishu.cn/document/ukTMukTMukTM/uIDN1YjLyQTN24iM0UjN/create_attachment) 接口创建的附件。 /// /// 默认值：1 /// @@ -13607,11 +13609,11 @@ System.Threading.Tasks.Task PostHireV1ApplicationsByApplicationI /// /// /// 必填：否 - /// 此次调用中使用的部门 ID 的类型 + /// 指定查询结果中的部门 ID 类型。关于部门 ID 的详细介绍，可参见[部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview)。 /// 示例值：department_id /// - /// open_department_id：以 open_department_id 来标识部门 - /// department_id：以 department_id 来标识部门 + /// open_department_id：由系统自动生成的部门 ID，ID 前缀固定为 od-，在租户内全局唯一。 + /// department_id：支持用户自定义配置的部门 ID。自定义配置时可复用已删除的 department_id，因此在未删除的部门范围内 department_id 具有唯一性。 /// /// 默认值：open_department_id /// @@ -13761,11 +13763,11 @@ System.Threading.Tasks.Task DeleteHireV1JobRequirementsByJobRequ /// /// /// 必填：否 - /// 此次调用中使用的部门 ID 类型。 + /// 指定查询结果中的部门 ID 类型。关于部门 ID 的详细介绍，可参见[部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview)。 /// 示例值："open_department_id" /// - /// open_department_id：【飞书】用来在具体某个应用中标识一个部门，同一个department_id 在不同应用中的 open_department_id 相同 - /// department_id：【飞书】用来标识租户内一个唯一的部门 + /// open_department_id：由系统自动生成的部门 ID，ID 前缀固定为 od-，在租户内全局唯一。 + /// department_id：支持用户自定义配置的部门 ID。自定义配置时可复用已删除的 department_id，因此在未删除的部门范围内 department_id 具有唯一性。 /// /// 默认值：open_department_id /// @@ -13819,7 +13821,7 @@ System.Threading.Tasks.Task DeleteHireV1JobRequirementsByJobRequ /// 接口ID：6989078472837234691 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_requirement_schema/list /// Authorization：tenant_access_token - /// 获取招聘需求模板列表，包含需求模板ID，以及模板里的字段定义等。 + /// 获取招聘需求模板列表，包含需求模板ID，以及模板里的字段定义等。招聘需求模板可参考「飞书招聘」-「设置」-「招聘需求字段管理」。 /// 权限要求： /// hire:job_requirement /// hire:job_requirement:readonly @@ -13847,7 +13849,7 @@ System.Threading.Tasks.Task DeleteHireV1JobRequirementsByJobRequ /// 接口ID：6989078472837251075 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_schema/list /// Authorization：tenant_access_token - /// 获取社招、校招职位模板中的职位字段，包括系统默认字段和自定义字段。 + /// 获取社招、校招职位模板中的职位字段，返回结果包括系统默认字段和自定义字段。招聘管理员可在「飞书招聘」-「设置」-「职位管理」-「职位字段管理」中修改职位模板。 /// 权限要求： /// hire:job:readonly /// @@ -13855,13 +13857,16 @@ System.Threading.Tasks.Task DeleteHireV1JobRequirementsByJobRequ /// /// 必填：否 /// 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果 - /// 示例值：1231231987 + /// 示例值：eyJvZmZzZXQiOjEwLCJ0aW1lc3RhbXAiOjE3MjQ2NTQ0OTc2OTd9 /// 默认值：null /// /// /// 必填：否 /// 分页大小 - /// 示例值：100 + /// **默认值**：10 + /// **数据校验规则**： + /// * 最大值：100 + /// 示例值：10 /// 默认值：10 /// /// @@ -13988,11 +13993,11 @@ System.Threading.Tasks.Task DeleteHireV1JobRequirementsByJobRequ /// /// /// 必填：否 - /// 此次调用中使用的部门 ID 的类型 + /// 指定查询结果中的部门 ID 类型。关于部门 ID 的详细介绍，可参见[部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview)。 /// 示例值：open_department_id /// - /// open_department_id：以 open_department_id 来标识部门 - /// department_id：以 department_id 来标识部门 + /// open_department_id：由系统自动生成的部门 ID，ID 前缀固定为 od-，在租户内全局唯一。 + /// department_id：支持用户自定义配置的部门 ID。自定义配置时可复用已删除的 department_id，因此在未删除的部门范围内 department_id 具有唯一性。 /// /// 默认值：open_department_id /// @@ -14627,7 +14632,7 @@ System.Threading.Tasks.Task PatchApplicationV6ApplicationsByAppI [PathQuery] string? job_level_id_type = "people_admin_job_level_id"); /// - /// 【招聘】获取招聘官网下的职位列表 + /// 【招聘】获取招聘官网下的职位广告列表 /// 接口ID：6990661791098667011 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/website-job_post/list /// Authorization：tenant_access_token @@ -14672,11 +14677,11 @@ System.Threading.Tasks.Task PatchApplicationV6ApplicationsByAppI /// /// /// 必填：否 - /// 此次调用中使用的部门 ID 类型。 - /// 示例值："department_id_type" + /// 指定查询结果中的部门 ID 类型。关于部门 ID 的详细介绍，可参见[部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview)。 + /// 示例值："department_id" /// - /// open_department_id：【飞书】用来在具体某个应用中标识一个部门，同一个department_id 在不同应用中的 open_department_id 相同 - /// department_id：【飞书】用来标识租户内一个唯一的部门 + /// open_department_id：由系统自动生成的部门 ID，ID 前缀固定为 od-，在租户内全局唯一。 + /// department_id：支持用户自定义配置的部门 ID。自定义配置时可复用已删除的 department_id，因此在未删除的部门范围内 department_id 具有唯一性。 /// /// 默认值：open_department_id /// @@ -14843,7 +14848,7 @@ System.Threading.Tasks.Task PatchApplicationV6ApplicationsByAppI /// 接口ID：6992822583076339715 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/external_interview/create /// Authorization：tenant_access_token - /// 导入来自其他系统的面试信息，创建为外部面试。 + /// 创建外部面试，可用于导入来自其他系统的面试信息。 /// 权限要求： /// hire:external_application /// @@ -15677,11 +15682,11 @@ System.Threading.Tasks.Task DeleteTaskV1TasksByTaskIdCommentsByC /// /// /// 必填：否 - /// 此次调用中使用的部门 ID 的类型 + /// 指定查询结果中的部门 ID 类型。关于部门 ID 的详细介绍，可参见[部门资源介绍](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview)。 /// 示例值：department_id /// - /// open_department_id：以 open_department_id 来标识部门 - /// department_id：以 department_id 来标识部门 + /// open_department_id：由系统自动生成的部门 ID，ID 前缀固定为 od-，在租户内全局唯一。 + /// department_id：支持用户自定义配置的部门 ID。自定义配置时可复用已删除的 department_id，因此在未删除的部门范围内 department_id 具有唯一性。 /// /// 默认值：open_department_id /// @@ -16214,7 +16219,7 @@ System.Threading.Tasks.Task PostContactV3GroupByGroupIdMemberRem /// 接口ID：7012986483075481601 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job/combined_create /// Authorization：tenant_access_token - /// 创建一个新的职位 + /// 创建一个新的职位。 /// ## 注意事项 /// - 调用此接口前，需先打开「飞书招聘」-「设置」-「职位管理」-「职位设置」-「通过API同步职位开关」开关。 /// - 字段是否必填，将以「飞书招聘」-「设置」-「职位管理」-「职位字段管理」中的设置为准。 @@ -16238,11 +16243,11 @@ System.Threading.Tasks.Task PostContactV3GroupByGroupIdMemberRem /// /// /// 必填：否 - /// 此次调用中使用的部门 ID 的类型 + /// 指定查询结果中的部门 ID 类型。关于部门 ID 的详细介绍，可参见[部门资源介绍](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview)。 /// 示例值：open_department_id /// - /// open_department_id：以 open_department_id 来标识部门 - /// department_id：以 department_id 来标识部门 + /// open_department_id：由系统自动生成的部门 ID， ID前缀固定为 `od-`，在租户内全局唯一。 + /// department_id：支持用户自定义配置的部门 ID。自定义配置时可复用已删除的 department_id，因此在未删除的部门范围内，department_id 具有唯一性。 /// /// 默认值：open_department_id /// @@ -16311,11 +16316,11 @@ System.Threading.Tasks.Task PostContactV3GroupByGroupIdMemberRem /// /// /// 必填：否 - /// 此次调用中使用的部门 ID 的类型 + /// 指定查询结果中的部门 ID 类型。关于部门 ID 的详细介绍，可参见[部门资源介绍](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview)。 /// 示例值：open_department_id /// - /// open_department_id：以 open_department_id 来标识部门 - /// department_id：以 department_id 来标识部门 + /// open_department_id：由系统自动生成的部门 ID， ID前缀固定为 `od-`，在租户内全局唯一。 + /// department_id：支持用户自定义配置的部门 ID。自定义配置时可复用已删除的 department_id，因此在未删除的部门范围内，department_id 具有唯一性。 /// /// 默认值：open_department_id /// @@ -16374,7 +16379,7 @@ System.Threading.Tasks.Task PostHireV1JobsByJobIdCloseAsync( /// 接口ID：7012986483075530753 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job/open /// Authorization：tenant_access_token - /// 支持开启职位。 + /// 对于已关闭的职位，可通过本接口重启职位。 /// 权限要求： /// hire:job /// @@ -16382,7 +16387,7 @@ System.Threading.Tasks.Task PostHireV1JobsByJobIdCloseAsync( /// /// 路径参数 /// 必填：是 - /// 职位 ID + /// 职位 ID，可通过[获取职位列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job/list)获取 /// 示例值：6960663240925956555 /// /// 请求体 @@ -17152,7 +17157,7 @@ System.Threading.Tasks.Task DeleteCorehrV1PreHiresByPreHireIdAsy /// 接口ID：7017694651622113284 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/get /// Authorization：tenant_access_token - /// 根据 ID 查询单个地点。 + /// 该接口用于根据地点 ID查询地点信息，信息包含地点名称、描述、地点用途、工时制度、区域设置、时区以及关联的地址信息等。 /// 权限要求： /// corehr:corehr /// corehr:corehr:readonly @@ -17163,7 +17168,7 @@ System.Threading.Tasks.Task DeleteCorehrV1PreHiresByPreHireIdAsy /// /// 路径参数 /// 必填：是 - /// 地点 ID + /// 地点维护管理员在 飞书人事系统，组织管理模块维护的地点记录 ID。 /// 示例值：1215 /// [HttpGet("/open-apis/corehr/v1/locations/{location_id}")] @@ -17320,11 +17325,11 @@ System.Threading.Tasks.Task DeleteCorehrV1ContractsByContractIdA [PathQuery] string contract_id); /// - /// 【飞书人事】创建合同 + /// 【飞书人事】新建合同 /// 接口ID：7017707615190876163 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/contract/create /// Authorization：tenant_access_token - /// 通过本接口可以为员工创建合同 + /// 通过本接口可以为员工创建一份新合同 /// 权限要求： /// corehr:corehr /// @@ -17602,11 +17607,11 @@ System.Threading.Tasks.Task DeleteCorehrV1ContractsByContractIdA [PathQuery] string? department_id_type = "people_corehr_department_id"); /// - /// 【飞书人事】批量查询地点 + /// 【飞书人事】批量分页查询地点信息 /// 接口ID：7017707615190990851 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list /// Authorization：tenant_access_token - /// 批量查询地点。 + /// 该接口用于批量查询地点信息，信息包含地点名称、描述、地点用途、工时制度、区域设置、时区以及关联的地址信息等。 /// 权限要求： /// corehr:corehr /// corehr:corehr:readonly @@ -18063,7 +18068,7 @@ System.Threading.Tasks.Task DeleteMailV1PublicMailboxesByPublicM [PathQuery] string? page_token = null); /// - /// 【招聘】搜索招聘官网下的职位列表 + /// 【招聘】搜索招聘官网下的职位广告列表 /// 接口ID：7021042393814450179 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/website-job_post/search /// Authorization：tenant_access_token @@ -18106,11 +18111,11 @@ System.Threading.Tasks.Task DeleteMailV1PublicMailboxesByPublicM /// /// /// 必填：否 - /// 此次调用中使用的部门 ID 类型。 + /// 指定查询结果中的部门 ID 类型。关于部门 ID 的详细介绍，可参见[部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview)。 /// 示例值："department_id" /// - /// open_department_id：【飞书】用来在具体某个应用中标识一个部门，同一个department_id 在不同应用中的 open_department_id 相同 - /// department_id：【飞书】用来标识租户内一个唯一的部门 + /// open_department_id：由系统自动生成的部门 ID，ID 前缀固定为 od-，在租户内全局唯一。 + /// department_id：支持用户自定义配置的部门 ID。自定义配置时可复用已删除的 department_id，因此在未删除的部门范围内 department_id 具有唯一性。 /// /// 默认值：open_department_id /// @@ -19153,11 +19158,14 @@ System.Threading.Tasks.Task PostContactV3UnitUnbindDepartmentAsy [PathQuery] string? user_id_type = "open_id"); /// - /// 【招聘】更新人才信息 + /// 【招聘】更新人才 /// 接口ID：7034053347989487644 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent/combined_update /// Authorization：tenant_access_token - /// 用于在企业内更新一个人才。姓名为系统预设的必填字段，邮箱/电话字段请在飞书招聘标准简历模板设置中确认是否必填。可配合「获取人才字段接口」获取自定义字段信息。 + /// 用于在企业内更新一个人才。支持自定义字段数据，可配合[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query) + /// 接口获取自定义字段信息使用。 + /// ## 注意事项 + /// 请求参数中邮箱/电话字段请在「飞书招聘」-「设置」-「候选人信息管理」-「标准简历设置」中确认是否必填。 /// 权限要求： /// hire:talent /// @@ -19791,6 +19799,77 @@ System.Threading.Tasks.Task PostImV1ChatsByChatIdTopNoticeDelete [PathQuery] bool? task_completed = null, [PathQuery] string? user_id_type = "open_id"); + /// + /// 【招聘】获取用户角色列表 + /// 接口ID：7044464966434390044 + /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/user_role/list + /// Authorization：tenant_access_token + /// 切到新版权限系统后，可通过该接口获取用户角色列表，基于用户ID、角色ID等条件进行筛选，并通过page_size与page_token进行分页。 + /// 权限要求： + /// hire:auth + /// hire:auth:readonly + /// + /// 字段权限要求： + /// contact:user.employee_id:readonly + /// + /// + /// + /// 必填：否 + /// 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果 + /// 示例值：eyJvZmZzZXQiOjEwLCJ0aW1lc3RhbXAiOjE2Mjc1NTUyMjM2NzIsImlkIjpudWxsfQ== + /// 默认值：null + /// + /// + /// 必填：否 + /// 每页获取记录数量 + /// 示例值：10 + /// 默认值：10 + /// + /// + /// 必填：否 + /// 用户 ID，与入参 `user_id_type` 类型一致 + /// 示例值：7326856229396906012 + /// 默认值：null + /// + /// + /// 必填：否 + /// 角色 ID，可通过接口 [获取角色列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/role/list) 获取 + /// 示例值：101 + /// 默认值：null + /// + /// + /// 必填：否 + /// 最早更新时间，毫秒时间戳 + /// 示例值：1618500278663 + /// 默认值：null + /// + /// + /// 必填：否 + /// 最晚更新时间，毫秒时间戳 + /// 示例值：1618500278663 + /// 默认值：null + /// + /// + /// 必填：否 + /// 用户 ID 类型 + /// 示例值：open_id + /// + /// open_id：标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。[了解更多：如何获取 Open ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid) + /// union_id：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。[了解更多：如何获取 Union ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-union-id) + /// user_id：标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。[了解更多：如何获取 User ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-user-id) + /// + /// 默认值：open_id + /// + [HttpGet("/open-apis/hire/v1/user_roles")] + System.Threading.Tasks.Task> GetHireV1UserRolesAsync( + [PathQuery] string? page_token = null, + [PathQuery] int? page_size = 10, + [PathQuery] string? user_id = null, + [PathQuery] string? role_id = null, + [PathQuery] string? update_start_time = null, + [PathQuery] string? update_end_time = null, + [PathQuery] string? user_id_type = "open_id"); + /// /// 【招聘】获取角色列表 /// 接口ID：7044465181343449090 @@ -20337,7 +20416,7 @@ System.Threading.Tasks.Task PostImV1ChatsByChatIdTopNoticeDelete /// 接口ID：7044467124773699585 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/group/delete /// Authorization：tenant_access_token - /// 通过班次 ID 删除班次。对应设置-假勤设置-[班次设置](https://example.feishu.cn/people/workforce-management/setting/group/shifts)操作列的删除功能 + /// 通过考勤组 ID 删除考勤组。对应设置-假勤设置-[考勤组](https://example.feishu.cn/people/workforce-management/setting/group/list)操作列的删除功能 /// 权限要求： /// attendance:rule /// @@ -20973,11 +21052,11 @@ System.Threading.Tasks.Task DeleteOkrV1ProgressRecordsByProgress [JsonContent] Mail.PostMailV1UsersQueryBodyDto dto); /// - /// 【招聘】获取简历评估信息 + /// 【招聘】批量获取简历评估信息 /// 接口ID：7062626037662892033 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/evaluation/list /// Authorization：tenant_access_token - /// 获取简历评估信息，包含评估人、评估结论、评估详情等信息。支持按照投递 ID、更新时间来进行筛选。 + /// 批量获取简历评估信息，包含评估人、评估结论、评估详情等信息。支持按照投递 ID、更新时间来进行筛选。 /// 权限要求： /// hire:evaluation:readonly /// @@ -21037,11 +21116,11 @@ System.Threading.Tasks.Task DeleteOkrV1ProgressRecordsByProgress [PathQuery] string? user_id_type = "open_id"); /// - /// 【招聘】获取面试登记表模板列表 + /// 【招聘】获取面试登记表列表 /// 接口ID：7063273947417247745 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/interview_registration_schema/list /// Authorization：tenant_access_token - /// 获取面试登记表模板列表。 + /// 获取面试登记表列表，可获取到的信息包括登记表名称、登记表模块、登记表字段 /// 权限要求： /// hire:interview /// hire:interview:readonly @@ -21881,7 +21960,7 @@ System.Threading.Tasks.Task DeleteCorehrV1WorkingHoursTypesByWor /// 接口ID：7072646788637556737 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/delete /// Authorization：tenant_access_token - /// 删除地点。 + /// 删除地点信息 /// 权限要求： /// corehr:corehr /// corehr:locations:write @@ -27243,11 +27322,11 @@ System.Threading.Tasks.Task PostContactV3UsersByUserIdResurrectA [PathQuery] string? user_id_type = "open_id"); /// - /// 【招聘】通过手机号或邮箱获取人才 ID + /// 【招聘】批量获取人才简要信息 /// 接口ID：7125370772851458076 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent/batch_get_id /// Authorization：tenant_access_token - /// 通过手机号或邮箱获取人才 ID。 + /// 批量获取人才简要信息，包括人才 ID、手机号、邮箱、证件号等。 /// 权限要求： /// hire:talent /// hire:talent:readonly @@ -30984,11 +31063,11 @@ System.Threading.Tasks.Task PostHireV1EcoAccountCustomFieldsBatc [JsonContent] Hire.PostHireV1EcoAccountCustomFieldsBatchDeleteBodyDto dto); /// - /// 【招聘】推送试卷列表 + /// 【招聘】创建试卷列表 /// 接口ID：7195815976042561538 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/eco_exam_paper/create /// Authorization：tenant_access_token - /// 定制指定帐号可用的试卷列表 + /// 飞书招聘的笔试服务商，在完成[账号绑定](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/eco_account/events/created)后，可通过本接口在客户的笔试帐号下创建试卷列表。若客户的笔试账号为「未激活」、「停用」状态，则试卷创建成功后，客户的账号将变为「正常」状态，可正常安排笔试。 /// 权限要求： /// hire:exam /// @@ -30999,11 +31078,11 @@ System.Threading.Tasks.Task PostHireV1EcoExamPapersAsync( [JsonContent] Hire.PostHireV1EcoExamPapersBodyDto dto); /// - /// 【招聘】删除试卷 + /// 【招聘】删除试卷列表 /// 接口ID：7195815976042577922 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/eco_exam_paper/batch_delete /// Authorization：tenant_access_token - /// 删除指定帐号的指定试卷列表，删除不影响已创建的笔试，删除不存在的试卷时不会报错 + /// 飞书招聘的笔试服务商，可通过该接口删除客户笔试帐号下的试卷列表。删除操作不影响已安排的笔试，删除不存在的试卷时不会报错。 /// 权限要求： /// hire:exam /// @@ -31033,7 +31112,8 @@ System.Threading.Tasks.Task PatchHireV1EcoBackgroundCheckCustomF /// 接口ID：7195815979079401473 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/eco_exam/login_info /// Authorization：tenant_access_token - /// 回传笔试安排结果，如果安排成功需返回笔试链接和登录凭证 + /// 飞书招聘的笔试服务商，在收到[创建笔试](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/eco_exam/events/created)事件并安排笔试后，应通过本接口 + /// 回传笔试安排结果。若安排成功，须返回笔试链接；若笔试链接需要登录鉴权，则须返回登录凭证（`username`，`password`)。 /// 权限要求： /// hire:exam /// hire:exam:readonly @@ -31042,7 +31122,7 @@ System.Threading.Tasks.Task PatchHireV1EcoBackgroundCheckCustomF /// /// 路径参数 /// 必填：是 - /// exam id + /// 笔试 ID。可通过[创建笔试](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/eco_exam/events/created)事件获取 /// 示例值：7178536692385679677 /// /// 请求体 @@ -31087,7 +31167,7 @@ System.Threading.Tasks.Task PostHireV1EcoBackgroundCheckCustomFi /// 接口ID：7195815979079467009 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/eco_exam/update_result /// Authorization：tenant_access_token - /// 回传笔试结果。回传笔试结果后，若需更新笔试结果，可再次调用该接口更新笔试结果，更新后的数据将覆盖原数据。用户若已在飞书招聘完成阅卷，不再支持回传笔试结果。 + /// 飞书招聘的笔试服务商，可通过该接口回传候选人的笔试结果。回传笔试结果后，候选人在飞书招聘内的笔试状态将变为「已作答」。 /// 权限要求： /// hire:exam /// hire:exam:readonly @@ -31096,7 +31176,7 @@ System.Threading.Tasks.Task PostHireV1EcoBackgroundCheckCustomFi /// /// 路径参数 /// 必填：是 - /// exam id + /// 笔试 ID，可通过[创建笔试](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/eco_exam/events/created)事件获取 /// 示例值：7178536692385679677 /// /// 请求体 @@ -31136,11 +31216,11 @@ System.Threading.Tasks.Task PostHireV1EcoBackgroundChecksUpdateR [JsonContent] Hire.PostHireV1EcoBackgroundChecksUpdateResultBodyDto dto); /// - /// 【招聘】更新试卷 + /// 【招聘】更新试卷列表 /// 接口ID：7195815979079532545 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/eco_exam_paper/batch_update /// Authorization：tenant_access_token - /// 更新指定帐号可用的试卷列表 + /// 飞书招聘的笔试服务商，可通过该接口更新客户笔试账号下的试卷列表。 /// 权限要求： /// hire:exam /// @@ -31579,11 +31659,11 @@ System.Threading.Tasks.Task PutContactV3FunctionalRolesByRoleIdA /// /// /// 必填：否 - /// 此次调用中使用的部门 ID 的类型 + /// 指定查询结果中的部门 ID 类型。关于部门 ID 的详细介绍，可参见[部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview)。 /// 示例值：open_department_id /// - /// open_department_id：以 open_department_id 来标识部门 - /// department_id：以 department_id 来标识部门 + /// open_department_id：由系统自动生成的部门 ID，ID 前缀固定为 od-，在租户内全局唯一。 + /// department_id：支持用户自定义配置的部门 ID。自定义配置时可复用已删除的 department_id，因此在未删除的部门范围内 department_id 具有唯一性。 /// /// 默认值：open_department_id /// @@ -31652,11 +31732,11 @@ System.Threading.Tasks.Task PutContactV3FunctionalRolesByRoleIdA /// /// /// 必填：否 - /// 此次调用中使用的部门 ID 的类型 + /// 指定查询结果中的部门 ID 类型。关于部门 ID 的详细介绍，可参见[部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview)。 /// 示例值：open_department_id /// - /// open_department_id：以 open_department_id 来标识部门 - /// department_id：以 department_id 来标识部门 + /// open_department_id：由系统自动生成的部门 ID，ID 前缀固定为 od-，在租户内全局唯一。 + /// department_id：支持用户自定义配置的部门 ID。自定义配置时可复用已删除的 department_id，因此在未删除的部门范围内 department_id 具有唯一性。 /// /// 默认值：open_department_id /// @@ -32539,7 +32619,7 @@ System.Threading.Tasks.Task PatchVcV1ReserveConfigsByReserveConf /// 接口ID：7218853190452428804 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_pool/search /// Authorization：tenant_access_token - /// 获取人才库列表，可获取的信息包括人才库ID、人才库名称等。 + /// 获取人才库列表，可获取的信息包括人才库 ID、人才库名称等。 /// 权限要求： /// hire:talent_folder /// hire:talent_folder:readonly @@ -32573,7 +32653,7 @@ System.Threading.Tasks.Task PatchVcV1ReserveConfigsByReserveConf /// 接口ID：7218853190452445188 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_pool/move_talent /// Authorization：tenant_access_token - /// 将人才加入人才库 + /// 将人才加入人才库。 /// 权限要求： /// hire:talent_folder /// @@ -32617,11 +32697,11 @@ System.Threading.Tasks.Task PatchVcV1ReserveConfigsByReserveConf /// /// /// 必填：否 - /// 此次调用中使用的部门 ID 类型。 + /// 指定查询结果中的部门 ID 类型。关于部门 ID 的详细介绍，可参见[部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview)。 /// 示例值："open_department_id" /// - /// open_department_id：【飞书】用来在具体某个应用中标识一个部门，同一个department_id 在不同应用中的 open_department_id 相同 - /// department_id：【飞书】用来标识租户内一个唯一的部门 + /// open_department_id：由系统自动生成的部门 ID，ID 前缀固定为 od-，在租户内全局唯一。 + /// department_id：支持用户自定义配置的部门 ID。自定义配置时可复用已删除的 department_id，因此在未删除的部门范围内 department_id 具有唯一性。 /// /// 默认值：open_department_id /// @@ -32963,7 +33043,7 @@ System.Threading.Tasks.Task GetCorehrV1FilesByIdAsync( /// 接口ID：7225452763517075459 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search /// Authorization：tenant_access_token - /// 查询成本中心信息 + /// 搜索成本中心信息；支持通过成本中心ID，成本中心名称，成本中心编码，成本中心上级搜索成本中心的信息，有分页功能。 /// 权限要求： /// corehr:cost_center:read /// @@ -33171,11 +33251,11 @@ System.Threading.Tasks.Task GetCorehrV1FilesByIdAsync( [PathQuery] string? client_token = null); /// - /// 【飞书人事（企业版）】删除成本中心版本 + /// 【飞书人事（企业版）】撤销成本中心版本 /// 接口ID：7225452763517124611 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center-version/delete /// Authorization：tenant_access_token - /// 撤销成本中心版本 + /// 该接口支持通过成本中心的版本ID撤销成本中心版本信息 /// 权限要求： /// corehr:cost_center:write /// @@ -33183,13 +33263,13 @@ System.Threading.Tasks.Task GetCorehrV1FilesByIdAsync( /// /// 路径参数 /// 必填：是 - /// 成本中心ID + /// 成本中心ID，可通过[【搜索成本中心信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search)接口查询获得 /// 示例值：6862995757234914824 /// /// /// 路径参数 /// 必填：是 - /// 版本ID + /// 版本ID，可通过[【搜索成本中心信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search)接口查询获得 /// 示例值：6862995757234914824 /// /// 请求体 @@ -33204,7 +33284,7 @@ System.Threading.Tasks.Task DeleteCorehrV2CostCentersByCostCente /// 接口ID：7225452763517140995 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/create /// Authorization：tenant_access_token - /// 创建成本中心 + /// 单个创建成本中心；可定义成本中心的名称，父级成本中心，成本中心负责人，生效时间等 /// 权限要求： /// corehr:cost_center:write /// @@ -33235,7 +33315,7 @@ System.Threading.Tasks.Task DeleteCorehrV2CostCentersByCostCente /// 接口ID：7225452763517157379 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/delete /// Authorization：tenant_access_token - /// 删除成本中心 + /// 删除成本中心记录 /// 权限要求： /// corehr:cost_center:write /// @@ -33243,7 +33323,7 @@ System.Threading.Tasks.Task DeleteCorehrV2CostCentersByCostCente /// /// 路径参数 /// 必填：是 - /// 成本中心ID + /// 成本中心ID；可通过[【搜索成本中心信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search)接口查询获得 /// 示例值：6862995757234914824 /// /// 请求体 @@ -33291,11 +33371,11 @@ System.Threading.Tasks.Task DeleteCorehrV2CostCentersByCostCente [PathQuery] string? user_id_type = "people_corehr_id"); /// - /// 【飞书人事（企业版）】更新成本中心版本 + /// 【飞书人事（企业版）】更正成本中心版本 /// 接口ID：7225452763517190147 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center-version/patch /// Authorization：tenant_access_token - /// 更正成本中心版本 + /// 对成本中心的版本记录进行更正，可更正的字段包括：名称，上级成本中心，成本中心负责人列表，成本中心的描述，生效时间 /// 权限要求： /// corehr:cost_center:write /// @@ -33306,13 +33386,13 @@ System.Threading.Tasks.Task DeleteCorehrV2CostCentersByCostCente /// /// 路径参数 /// 必填：是 - /// 成本中心ID + /// 成本中心ID，可通过[【搜索成本中心信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search)接口查询获得 /// 示例值：6862995757234914824 /// /// /// 路径参数 /// 必填：是 - /// 版本ID + /// 版本ID，可通过[【搜索成本中心信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search)接口查询获得 /// 示例值：6862995757234914824 /// /// @@ -33485,7 +33565,7 @@ System.Threading.Tasks.Task DeleteCorehrV2CostCentersByCostCente /// 接口ID：7236665938900877340 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent/onboard_status /// Authorization：tenant_access_token - /// 更新人才的在职状态，可进行的操作包括入职与离职 + /// 更新人才的在职状态，可进行的操作包括入职与离职。 /// ## 注意事项 /// - 通过该接口对人才进行入职、离职操作后，人才详情与列表会对应展示已入职、已离职标签 /// - 已入职的人才不能进行入职操作，已离职的人才不能进行入职操作 @@ -34554,7 +34634,7 @@ System.Threading.Tasks.Task GetLingoV1FilesByFileTokenDownl /// 接口ID：7252157701853167644 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/location/batch_get /// Authorization：tenant_access_token - /// 通过地点 ID 批量获取地点信息 + /// 该接口用于根据地点 ID批量查询地点信息，信息包含地点名称、描述、地点用途、工时制度、区域设置、时区以及关联的地址信息等。 /// 权限要求： /// corehr:locations:read /// corehr:locations:write @@ -36148,11 +36228,11 @@ System.Threading.Tasks.Task PatchContactV3DepartmentsByDepartmen [PathQuery] string? department_id_type = "open_department_id"); /// - /// 【招聘】获取信息登记表模板列表 + /// 【招聘】获取信息登记表列表 /// 接口ID：7259225956346232860 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/registration_schema/list /// Authorization：tenant_access_token - /// 获取信息登记表模板列表 + /// 根据适用场景获取信息登记表列表，可获取到的信息包括登记表名称、登记表模块、登记表字段等 /// 权限要求： /// hire:talent /// hire:talent:readonly @@ -36172,7 +36252,7 @@ System.Threading.Tasks.Task PatchContactV3DepartmentsByDepartmen /// /// /// 必填：否 - /// 登记表适用场景；请求不填，表示获取全部类型信息登记表 + /// 登记表适用场景；不填表示获取全部类型信息登记表 /// 示例值：5 /// /// 5：面试登记表 @@ -37983,7 +38063,7 @@ System.Threading.Tasks.Task PatchApplicationV6ApplicationsByAppI /// 接口ID：7287407243900895234 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_type/list /// Authorization：tenant_access_token - /// 获取职位类别列表，用于在操作职位/招聘需求时获取职位类别枚举，默认以创建时间升序排序，返回值中包含从属关系，可在获取全量数据后自行构建职位类别树，所有节点均可用于回填职位/招聘需求中的职位类别字段 + /// 获取招聘系统预置的职位类别列表，可用于操作职位（如[新建职位](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job/combined_create)），操作招聘需求（如[创建招聘需求](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_requirement/create)）时回填职位类别字段。返回列表默认按创建时间升序排序，且包含节点的层级关系（节点的父节点 ID），可在获取全量数据后自行构建职位类别树。 /// 权限要求： /// hire:job:readonly /// @@ -37991,6 +38071,7 @@ System.Threading.Tasks.Task PatchApplicationV6ApplicationsByAppI /// /// 必填：否 /// 分页大小 + /// **默认值**：10 /// 示例值：10 /// 默认值：10 /// @@ -38946,7 +39027,7 @@ System.Threading.Tasks.Task DeleteLingoV1EntitiesByEntityIdAsync /// 接口ID：7307160083569623043 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/tripartite_agreement/create /// Authorization：tenant_access_token - /// 在投递上创建三方协议。 + /// 在校招投递上创建三方协议。 /// ## 前提条件 /// - 在「飞书招聘」-「设置」-「候选人流程管理」-「三方协议设置」中勾选了「通过 API 维护三方协议」。 /// - 该投递为校招投递。 @@ -38987,7 +39068,7 @@ System.Threading.Tasks.Task DeleteHireV1TripartiteAgreementsByTr /// 接口ID：7307160083569655811 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/agency/protect_search /// Authorization：tenant_access_token - /// 查询指定人才的猎头保护期列表，包含保护期起止时间，以及猎头供应商、猎头顾问信息等。若人才已经入职，还会返回入职时所在的保护期信息。 + /// 查询指定人才的猎头保护期信息列表，包含保护期起止时间、猎头供应商、猎头顾问信息等。若人才已经入职，还会返回入职时所在的保护期信息。 /// 权限要求： /// hire:agency /// hire:agency:readonly @@ -39069,7 +39150,7 @@ System.Threading.Tasks.Task DeleteHireV1TripartiteAgreementsByTr /// 接口ID：7307160083569704963 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/referral/search /// Authorization：tenant_access_token - /// 根据人才查询内推信息列表，包含内推人信息、内推时间、投递ID等，按内推投递的`创建时间`从小到大排序返回。 + /// 根据人才查询内推信息列表，包含内推人信息、内推时间、投递 ID等，按内推投递的`创建时间`从小到大排序返回。 /// 权限要求： /// hire:referral /// hire:referral:readonly @@ -40100,7 +40181,7 @@ System.Threading.Tasks.Task PostApaasV1ApprovalTasksByApprovalTa /// 接口ID：7350663854198161410 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/create /// Authorization：tenant_access_token、user_access_token - /// 支持在单个接口中进行人员全信息添加，包括人员基本信息，雇佣信息，任职记录及其他分组信息 + /// 支持在单个接口中进行人员全信息添加，包括人员的基本信息，雇佣信息，入职任职记录及其他分组信息 /// 权限要求： /// corehr:employee.add:write /// @@ -40136,6 +40217,14 @@ System.Threading.Tasks.Task PostApaasV1ApprovalTasksByApprovalTa /// /// 必填：否 /// 是否忽略工时制度自动生成规则 + /// - 值为 false 时，以下字段必填： + /// - emp_contract_record.first_party + /// - employment_record.work_location + /// - employment_record.employee_type + /// - employment_record.job_family + /// - employment_record.job + /// - employment_record.job_level + /// - employment_record.department /// 示例值：true /// 默认值：false /// @@ -40154,7 +40243,7 @@ System.Threading.Tasks.Task PostApaasV1ApprovalTasksByApprovalTa /// 接口ID：7351241605105090564 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/role/get /// Authorization：tenant_access_token - /// 获取角色详情信息，包括名称、描述、权限列表等（适用于新版权限，关于新旧权限主要差异：新权限体系中区分了校社招，并将权限点区分了功能权限、字段权限、数据权限）。 + /// 切到新版权限系统后，可通过此接口获取角色详情信息，包括名称、描述、权限列表等 /// 权限要求： /// hire:auth /// hire:auth:readonly @@ -40492,7 +40581,7 @@ System.Threading.Tasks.Task PostImV2UrlPreviewsBatchUpdateAsync( /// /// 路径参数 /// 必填：是 - /// 外部内推奖励ID，同[导入外部内推奖励](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/external_referral_reward/create)接口的参数`external_id` + /// 外部内推奖励ID，通过[导入外部内推奖励](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/external_referral_reward/create)生成 /// 示例值：6930815272790114324 /// [HttpDelete("/open-apis/hire/v1/external_referral_rewards/{external_referral_reward_id}")] @@ -40835,7 +40924,7 @@ System.Threading.Tasks.Task PostAttendanceV1ArchiveRuleDelReport /// 接口ID：7371009404255600644 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/performance-v2/additional_informations-batch/delete /// Authorization：tenant_access_token - /// 可批量删除被评估人的补充信息。 + /// 批量删除被评估人的补充信息。 /// 权限要求： /// performance:performance /// performance:semester_activity:write @@ -40851,7 +40940,7 @@ System.Threading.Tasks.Task PostAttendanceV1ArchiveRuleDelReport /// 接口ID：7371009404255617028 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/performance-v2/additional_information/query /// Authorization：tenant_access_token - /// 可批量查询被评估人的补充信息。 + /// 批量查询被评估人的补充信息，如补充信息的事项、时间以及具体描述等。 /// 权限要求： /// performance:performance /// performance:performance:readonly @@ -40882,7 +40971,7 @@ System.Threading.Tasks.Task PostAttendanceV1ArchiveRuleDelReport /// /// /// 必填：否 - /// 分页大小 示例值：30 默认值：20 数据校验规则：最大值：50 + /// 分页大小 /// 示例值：30 /// 默认值：20 /// @@ -40899,7 +40988,13 @@ System.Threading.Tasks.Task PostAttendanceV1ArchiveRuleDelReport /// 接口ID：7371009404255633412 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/performance-v2/additional_information/import /// Authorization：tenant_access_token - /// 可批量导入被评估人的补充信息作为评估参考（包括新增和更新场景）。 + /// 批量导入被评估人的补充信息作为绩效评估的参考，如补充信息的事项、时间以及具体描述等。该接口支持创建和更新补充信息。 + /// ## 注意事项 + /// 该接口执行创建或者更新的判断逻辑如下（按顺序判断）： + /// 1. 若请求参数 `additional_informations` 中 `item_ids` 传入系统中已有的补充信息 ID 时，将更新对应的补充消息数据。 + /// 2. 若请求参数 `additional_informations` 中 `external_ids` 传入系统中已有的外部系统补充信息 ID 时，将更新对应的补充消息数据。 + /// 3. 若请求参数 `additional_informations` 中 `reviewee_user_id`、`item `、`time `、`detailed_description` 的参数组合在系统中已存在内容一致的补充消息时，将更新对应的补充消息数据。 + /// 4. 以上情况都不符合时，创建新的补充消息数据。 /// 权限要求： /// performance:performance /// performance:semester_activity:write @@ -40910,7 +41005,7 @@ System.Threading.Tasks.Task PostAttendanceV1ArchiveRuleDelReport /// /// /// 必填：是 - /// 根据 client_token 是否一致来判断是否为同一请求 + /// 根据 `client_token` 是否一致来判断是否为同一请求，同一请求多次调用将被拦截 /// 示例值：12454646 /// /// @@ -41091,6 +41186,117 @@ System.Threading.Tasks.Task PostAttendanceV1ArchiveRuleDelReport [PathQuery] string? user_id_type = "people_corehr_id", [PathQuery] string? department_id_type = "people_corehr_department_id"); + /// + /// 【招聘】查询面试官信息列表 + /// 接口ID：7372229724359835649 + /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/interviewer/list + /// Authorization：tenant_access_token + /// 分页查询面试官列表，接口只会返回执行过「更新面试官信息」用户的数据，通过接口查询不到的数据则默认为「未认证」面试官。接口默认按更新时间、user_id顺序进行顺序拉取。 + /// 权限要求： + /// hire:interviewer + /// hire:interviewer:readonly + /// + /// 字段权限要求： + /// contact:user.employee_id:readonly + /// + /// + /// + /// 必填：否 + /// 分页大小 + /// 示例值：10 + /// 默认值：10 + /// + /// + /// 必填：否 + /// 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果 + /// 示例值：eVQrYzJBNDNONlk4VFZBZVlSdzlKdFJ4bVVHVExENDNKVHoxaVdiVnViQT0= + /// 默认值：null + /// + /// + /// 必填：否 + /// 面试官userID列表 + /// 默认值：null + /// + /// + /// 必填：否 + /// 认证状态 + /// 示例值：1 + /// + /// 1：未认证 + /// 2：已认证 + /// + /// 默认值：null + /// + /// + /// 必填：否 + /// 最早更新时间，毫秒时间戳 + /// 示例值：1714374796615 + /// 默认值：null + /// + /// + /// 必填：否 + /// 最晚更新时间，毫秒时间戳 + /// 示例值：1714374796616 + /// 默认值：null + /// + /// + /// 必填：否 + /// 用户 ID 类型 + /// 示例值：open_id + /// + /// open_id：标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。[了解更多：如何获取 Open ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid) + /// union_id：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。[了解更多：如何获取 Union ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-union-id) + /// user_id：标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。[了解更多：如何获取 User ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-user-id) + /// + /// 默认值：open_id + /// + [HttpGet("/open-apis/hire/v1/interviewers")] + System.Threading.Tasks.Task> GetHireV1InterviewersAsync( + [PathQuery] int? page_size = 10, + [PathQuery] string? page_token = null, + [PathQuery] string[]? user_ids = null, + [PathQuery] int? verify_status = null, + [PathQuery] string? earliest_update_time = null, + [PathQuery] string? latest_update_time = null, + [PathQuery] string? user_id_type = "open_id"); + + /// + /// 【招聘】更新面试官信息 + /// 接口ID：7372229724359852033 + /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/interviewer/patch + /// Authorization：tenant_access_token + /// 用于更新面试官认证信息 + /// 权限要求： + /// hire:interviewer + /// + /// 字段权限要求： + /// contact:user.employee_id:readonly + /// + /// + /// + /// 路径参数 + /// 必填：是 + /// 面试官userID + /// 示例值：ou_7dab8a3d3cdcc9da365777c7ad535d62 + /// + /// + /// 必填：否 + /// 用户 ID 类型 + /// 示例值：open_id + /// + /// open_id：标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。[了解更多：如何获取 Open ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid) + /// union_id：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。[了解更多：如何获取 Union ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-union-id) + /// user_id：标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。[了解更多：如何获取 User ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-user-id) + /// + /// 默认值：open_id + /// + /// 请求体 + [HttpPatch("/open-apis/hire/v1/interviewers/{interviewer_id}")] + System.Threading.Tasks.Task> PatchHireV1InterviewersByInterviewerIdAsync( + [PathQuery] string interviewer_id, + [JsonContent] Hire.PatchHireV1InterviewersByInterviewerIdBodyDto dto, + [PathQuery] string? user_id_type = "open_id"); + /// /// 【消息与群组】添加跟随气泡 /// 接口ID：7377650885165268995 @@ -41802,6 +42008,40 @@ System.Threading.Tasks.Task PostHireV1ApplicationsByApplicationI [PathQuery] string? page_token = null, [PathQuery] string[]? tag_ids = null); + /// + /// 【招聘】获取面试速记明细 + /// 接口ID：7397616200375304220 + /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/minutes/get + /// Authorization：tenant_access_token + /// 获取指定面试的面试速记明细记录 + /// 权限要求： + /// hire:interview + /// hire:interview:readonly + /// + /// + /// + /// 必填：是 + /// 面试ID，可根据接口[获取面试信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/interview/list)、[获取人才面试信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/interview/get_by_talent)获取 + /// 示例值：7085989097067563300 + /// + /// + /// 必填：否 + /// 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果 + /// 示例值：NzM5MTgyNjQyNDY2MDc4OTU0OA== + /// 默认值：null + /// + /// + /// 必填：否 + /// 分页大小，表示本次请求获取的速记中的语句的最大数量 + /// 示例值：10 + /// 默认值：20 + /// + [HttpGet("/open-apis/hire/v1/minutes")] + System.Threading.Tasks.Task> GetHireV1MinutesAsync( + [PathQuery] string interview_id, + [PathQuery] string? page_token = null, + [PathQuery] int? page_size = 20); + /// /// 【画板】获取画板缩略图片 /// 接口ID：7398376458043310083 @@ -41863,5 +42103,25 @@ System.Threading.Tasks.Task GetBoardV1WhiteboardsByWhiteboa [PathQuery] int page_size = 10, [PathQuery] string? page_token = null, [PathQuery] string? department_id_type = "people_corehr_department_id"); + + /// + /// 【应用信息】向管理员申请授权 + /// 接口ID：7406972061036429316 + /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/scope/apply + /// Authorization：tenant_access_token + /// 调用该接口以应用身份向租户管理员申请应用内需要审核的 API 权限。 + /// + [HttpPost("/open-apis/application/v6/scopes/apply")] + System.Threading.Tasks.Task PostApplicationV6ScopesApplyAsync(); + + /// + /// 【应用信息】查询租户授权状态 + /// 接口ID：7406972061036445700 + /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/scope/list + /// Authorization：tenant_access_token + /// 调用该接口查询当前应用向租户申请授权的状态。 + /// + [HttpGet("/open-apis/application/v6/scopes")] + System.Threading.Tasks.Task> GetApplicationV6ScopesAsync(); } diff --git a/src/IFeishuUserApi.cs b/src/IFeishuUserApi.cs index 33fe619..6bf2e46 100644 --- a/src/IFeishuUserApi.cs +++ b/src/IFeishuUserApi.cs @@ -18236,7 +18236,7 @@ System.Threading.Tasks.Task DeleteAcsV1VisitorsByVisitorIdAsync( /// 接口ID：7350663854198161410 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/create /// Authorization：tenant_access_token、user_access_token - /// 支持在单个接口中进行人员全信息添加，包括人员基本信息，雇佣信息，任职记录及其他分组信息 + /// 支持在单个接口中进行人员全信息添加，包括人员的基本信息，雇佣信息，入职任职记录及其他分组信息 /// 权限要求： /// corehr:employee.add:write /// @@ -18272,6 +18272,14 @@ System.Threading.Tasks.Task DeleteAcsV1VisitorsByVisitorIdAsync( /// /// 必填：否 /// 是否忽略工时制度自动生成规则 + /// - 值为 false 时，以下字段必填： + /// - emp_contract_record.first_party + /// - employment_record.work_location + /// - employment_record.employee_type + /// - employment_record.job_family + /// - employment_record.job + /// - employment_record.job_level + /// - employment_record.department /// 示例值：true /// 默认值：false /// diff --git a/src/Performance/DeletePerformanceV2AdditionalInformationsBatchBodyDto.cs b/src/Performance/DeletePerformanceV2AdditionalInformationsBatchBodyDto.cs index 5a8f953..7ef6a4f 100644 --- a/src/Performance/DeletePerformanceV2AdditionalInformationsBatchBodyDto.cs +++ b/src/Performance/DeletePerformanceV2AdditionalInformationsBatchBodyDto.cs @@ -13,7 +13,7 @@ namespace FeishuNetSdk.Performance; /// /// 批量删除补充信息 请求体 -/// 可批量删除被评估人的补充信息。 +/// 批量删除被评估人的补充信息。 /// 接口ID：7371009404255600644 /// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/performance-v2/additional_informations-batch/delete /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fperformance-v2%2fadditional_informations-batch%2fdelete @@ -21,7 +21,7 @@ namespace FeishuNetSdk.Performance; public record DeletePerformanceV2AdditionalInformationsBatchBodyDto { /// - /// 评估周期 ID 列表，semester_id 可通过【获取周期】接口获得 + /// 评估周期 ID，可通过[获取周期列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/performance-v1/semester/list)接口获取 /// 必填：是 /// 示例值：7348736302176534547 /// 最大长度：100 @@ -31,7 +31,7 @@ public record DeletePerformanceV2AdditionalInformationsBatchBodyDto public string SemesterId { get; set; } = string.Empty; /// - /// 补充信息的 item ID 列表，一次最多 100 个 + /// 补充信息 ID 列表，可通过[批量查询补充信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/performance-v2/additional_information/query)接口获取 /// 必填：是 /// 最大长度：100 /// 最小长度：1 diff --git a/src/Performance/DeletePerformanceV2AdditionalInformationsBatchResponseDto.cs b/src/Performance/DeletePerformanceV2AdditionalInformationsBatchResponseDto.cs index fad9cfc..805155f 100644 --- a/src/Performance/DeletePerformanceV2AdditionalInformationsBatchResponseDto.cs +++ b/src/Performance/DeletePerformanceV2AdditionalInformationsBatchResponseDto.cs @@ -13,7 +13,7 @@ namespace FeishuNetSdk.Performance; /// /// 批量删除补充信息 响应体 -/// 可批量删除被评估人的补充信息。 +/// 批量删除被评估人的补充信息。 /// 接口ID：7371009404255600644 /// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/performance-v2/additional_informations-batch/delete /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fperformance-v2%2fadditional_informations-batch%2fdelete @@ -21,7 +21,7 @@ namespace FeishuNetSdk.Performance; public record DeletePerformanceV2AdditionalInformationsBatchResponseDto { /// - /// 被删除的补充信息列表 + /// 被删除的补充信息 ID 列表 /// 必填：否 /// [JsonPropertyName("additional_informations")] diff --git a/src/Performance/PostPerformanceV2AdditionalInformationsImportBodyDto.cs b/src/Performance/PostPerformanceV2AdditionalInformationsImportBodyDto.cs index e33d3ba..c72a653 100644 --- a/src/Performance/PostPerformanceV2AdditionalInformationsImportBodyDto.cs +++ b/src/Performance/PostPerformanceV2AdditionalInformationsImportBodyDto.cs @@ -13,7 +13,13 @@ namespace FeishuNetSdk.Performance; /// /// 批量导入补充信息 请求体 -/// 可批量导入被评估人的补充信息作为评估参考（包括新增和更新场景）。 +/// 批量导入被评估人的补充信息作为绩效评估的参考，如补充信息的事项、时间以及具体描述等。该接口支持创建和更新补充信息。 +/// ## 注意事项 +/// 该接口执行创建或者更新的判断逻辑如下（按顺序判断）： +/// 1. 若请求参数 `additional_informations` 中 `item_ids` 传入系统中已有的补充信息 ID 时，将更新对应的补充消息数据。 +/// 2. 若请求参数 `additional_informations` 中 `external_ids` 传入系统中已有的外部系统补充信息 ID 时，将更新对应的补充消息数据。 +/// 3. 若请求参数 `additional_informations` 中 `reviewee_user_id`、`item `、`time `、`detailed_description` 的参数组合在系统中已存在内容一致的补充消息时，将更新对应的补充消息数据。 +/// 4. 以上情况都不符合时，创建新的补充消息数据。 /// 接口ID：7371009404255633412 /// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/performance-v2/additional_information/import /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fperformance-v2%2fadditional_information%2fimport @@ -21,7 +27,7 @@ namespace FeishuNetSdk.Performance; public record PostPerformanceV2AdditionalInformationsImportBodyDto { /// - /// 评估周期 ID 列表，semester_id 可通过【获取周期】接口获得 + /// 评估周期 ID，可通过[获取周期列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/performance-v1/semester/list)接口获取 /// 必填：是 /// 示例值：7348736302176534547 /// 最大长度：100 @@ -31,7 +37,7 @@ public record PostPerformanceV2AdditionalInformationsImportBodyDto public string SemesterId { get; set; } = string.Empty; /// - /// 补充信息列表，一次最多 1000 个 + /// 补充信息列表 /// 必填：否 /// 最大长度：1000 /// 最小长度：1 @@ -40,12 +46,13 @@ public record PostPerformanceV2AdditionalInformationsImportBodyDto public AdditionalInformation[]? AdditionalInformations { get; set; } /// - /// 补充信息列表，一次最多 1000 个 + /// 补充信息列表 /// public record AdditionalInformation { /// - /// 飞书绩效的事项 ID，只支持传入已存在的 item_id 用于更新事项。如需新增事项，无需传该值。 + /// 补充信息 ID + /// **注意**：若传入系统中已有的补充信息 ID 时，将更新对应的补充消息数据 /// 必填：否 /// 示例值：7350194523185610771 /// 最大长度：100 @@ -55,7 +62,8 @@ public record AdditionalInformation public string? ItemId { get; set; } /// - /// 外部系统的事项 ID，用于两个系统之间的数据映射。支持新建事项和更新关联的已有事项。如果同时传了 item_id，则优先按照 item_id 更新对应事项内容及其 external_id。 + /// 外部系统补充信息 ID，用于系统间的数据映射。 + /// **注意**：若传入系统中已有的外部系统补充信息 ID 时，将更新对应的补充消息数据 /// 必填：否 /// 示例值：6789523104723558912 /// 最大长度：100 @@ -65,7 +73,8 @@ public record AdditionalInformation public string? ExternalId { get; set; } /// - /// 被评估人 ID + /// 被评估人 ID 列表，与入参 `user_id_type` 类型一致，可通过[获取被评估人信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/performance-v2/reviewee/query)接口获取 + /// **注意**：若 `reviewee_user_id`、`item `、`time `、`detailed_description` 的参数组合在系统中已存在内容一致的补充消息时，将更新对应的补充消息数据 /// 必填：是 /// 示例值：ou_3245842393d09e9428ad4655da6e30b3 /// 最大长度：9999 @@ -76,8 +85,9 @@ public record AdditionalInformation /// /// 事项 + /// **注意**：若 `reviewee_user_id`、`item `、`time `、`detailed_description` 的参数组合在系统中已存在内容一致的补充消息时，将更新对应的补充消息数据 /// 必填：是 - /// 示例值：文本 + /// 示例值：业绩补充说明 /// 最大长度：1000 /// 最小长度：1 /// @@ -85,7 +95,9 @@ public record AdditionalInformation public string Item { get; set; } = string.Empty; /// - /// 事项时间，格式为文本内容 + /// 时间 + /// **说明**：文本内容，无格式校验 + /// **注意**：若 `reviewee_user_id`、`item `、`time `、`detailed_description` 的参数组合在系统中已存在内容一致的补充消息时，将更新对应的补充消息数据 /// 必填：是 /// 示例值：2024-03-12 /// 最大长度：100 @@ -95,9 +107,10 @@ public record AdditionalInformation public string Time { get; set; } = string.Empty; /// - /// 事项详细描述 + /// 具体描述 + /// **注意**：若 `reviewee_user_id`、`item `、`time `、`detailed_description` 的参数组合在系统中已存在内容一致的补充消息时，将更新对应的补充消息数据 /// 必填：是 - /// 示例值：多行文本 + /// 示例值：销售额增长目标超额完成 /// 最大长度：1000 /// 最小长度：1 /// @@ -106,9 +119,10 @@ public record AdditionalInformation } /// - /// 导入记录名称，管理员可在补充信息管理的导入记录中查看。不传则默认为 API 导入。 + /// 补充信息导入记录名称，管理员可在补充信息管理的导入记录中查看。 + /// **默认值**："API导入" /// 必填：否 - /// 示例值：API导入 + /// 示例值：人工导入 /// 最大长度：200 /// 最小长度：0 /// diff --git a/src/Performance/PostPerformanceV2AdditionalInformationsImportResponseDto.cs b/src/Performance/PostPerformanceV2AdditionalInformationsImportResponseDto.cs index 3c6bf76..dfc4821 100644 --- a/src/Performance/PostPerformanceV2AdditionalInformationsImportResponseDto.cs +++ b/src/Performance/PostPerformanceV2AdditionalInformationsImportResponseDto.cs @@ -13,7 +13,13 @@ namespace FeishuNetSdk.Performance; /// /// 批量导入补充信息 响应体 -/// 可批量导入被评估人的补充信息作为评估参考（包括新增和更新场景）。 +/// 批量导入被评估人的补充信息作为绩效评估的参考，如补充信息的事项、时间以及具体描述等。该接口支持创建和更新补充信息。 +/// ## 注意事项 +/// 该接口执行创建或者更新的判断逻辑如下（按顺序判断）： +/// 1. 若请求参数 `additional_informations` 中 `item_ids` 传入系统中已有的补充信息 ID 时，将更新对应的补充消息数据。 +/// 2. 若请求参数 `additional_informations` 中 `external_ids` 传入系统中已有的外部系统补充信息 ID 时，将更新对应的补充消息数据。 +/// 3. 若请求参数 `additional_informations` 中 `reviewee_user_id`、`item `、`time `、`detailed_description` 的参数组合在系统中已存在内容一致的补充消息时，将更新对应的补充消息数据。 +/// 4. 以上情况都不符合时，创建新的补充消息数据。 /// 接口ID：7371009404255633412 /// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/performance-v2/additional_information/import /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fperformance-v2%2fadditional_information%2fimport @@ -43,7 +49,7 @@ public record PostPerformanceV2AdditionalInformationsImportResponseDto public record AdditionalInformation { /// - /// 飞书绩效的事项 ID + /// 补充信息 ID /// 必填：否 /// 示例值：7350195758357807123 /// 最大长度：100 @@ -53,7 +59,8 @@ public record AdditionalInformation public string? ItemId { get; set; } /// - /// 外部系统的事项 ID，没有则返回为空 + /// 外部系统补充信息 ID + /// **说明**：若导入时没有提供，则返回为空 /// 必填：否 /// 示例值：6789523104723558912 /// 最大长度：100 @@ -63,7 +70,7 @@ public record AdditionalInformation public string? ExternalId { get; set; } /// - /// 被评估人 ID + /// 被评估人 ID 列表，与入参 `user_id_type` 类型一致 /// 必填：是 /// 示例值：ou_3245842393d09e9428ad4655da6e30b3 /// 最大长度：9999 @@ -75,7 +82,7 @@ public record AdditionalInformation /// /// 事项 /// 必填：是 - /// 示例值：文本 + /// 示例值：业绩补充说明 /// 最大长度：1000 /// 最小长度：1 /// @@ -83,7 +90,8 @@ public record AdditionalInformation public string Item { get; set; } = string.Empty; /// - /// 事项时间，格式为文本内容 + /// 时间 + /// **说明**：文本内容，无格式校验 /// 必填：是 /// 示例值：2024-03-12 /// 最大长度：100 @@ -93,9 +101,9 @@ public record AdditionalInformation public string Time { get; set; } = string.Empty; /// - /// 事项详细描述 + /// 具体描述 /// 必填：是 - /// 示例值：多行文本 + /// 示例值：销售额增长目标超额完成 /// 最大长度：1000 /// 最小长度：1 /// diff --git a/src/Performance/PostPerformanceV2AdditionalInformationsQueryBodyDto.cs b/src/Performance/PostPerformanceV2AdditionalInformationsQueryBodyDto.cs index 8520199..6f4fecc 100644 --- a/src/Performance/PostPerformanceV2AdditionalInformationsQueryBodyDto.cs +++ b/src/Performance/PostPerformanceV2AdditionalInformationsQueryBodyDto.cs @@ -13,7 +13,7 @@ namespace FeishuNetSdk.Performance; /// /// 批量查询补充信息 请求体 -/// 可批量查询被评估人的补充信息。 +/// 批量查询被评估人的补充信息，如补充信息的事项、时间以及具体描述等。 /// 接口ID：7371009404255617028 /// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/performance-v2/additional_information/query /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fperformance-v2%2fadditional_information%2fquery @@ -21,7 +21,8 @@ namespace FeishuNetSdk.Performance; public record PostPerformanceV2AdditionalInformationsQueryBodyDto { /// - /// 评估周期 ID 列表，semester_id 可通过【获取周期】接口获得 + /// 评估周期 ID，可通过[获取周期列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/performance-v1/semester/list)接口获取 + /// **注意**：若请求参数 `item_ids`、`external_ids`、`reviewee_user_ids` 均为空，返回 `semester_id` 参数指定周期的所有补充信息 /// 必填：是 /// 示例值：7348736302176534547 /// 最大长度：100 @@ -31,7 +32,8 @@ public record PostPerformanceV2AdditionalInformationsQueryBodyDto public string SemesterId { get; set; } = string.Empty; /// - /// 事项 ID 列表，获取指定事项 ID 的信息。以下请求参数中「item_ids」、「external_ids」、「reviewee_user_ids」均为空时，返回该评估周期的所有补充信息。若单次请求中多个请求参数有值，按照【item_ids > external_ids > reviewee_user_ids】的顺序只识别第一个有值的请求参数 + /// 补充信息 ID 列表，可通过[批量导入补充信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/performance-v2/additional_information/import)接口获取 + /// **说明**：若提供多个筛选参数，按照 `item_ids` > `external_ids` > `reviewee_user_ids` 的优先级顺序，以第一个有值的筛选参数进行筛选 /// 必填：否 /// 最大长度：50 /// 最小长度：0 @@ -40,7 +42,8 @@ public record PostPerformanceV2AdditionalInformationsQueryBodyDto public string[]? ItemIds { get; set; } /// - /// 外部系统的事项 ID 列表，获取对应的飞书绩效事项 ID。「item_ids」参数有值时该参数不生效 + /// 外部系统补充信息 ID 列表，该 ID 在通过[批量导入补充信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/performance-v2/additional_information/import)接口导入时写入 + /// **说明**：若提供多个筛选参数，按照 `item_ids` > `external_ids` > `reviewee_user_ids` 的优先级顺序，以第一个有值的筛选参数进行筛选 /// 必填：否 /// 最大长度：50 /// 最小长度：0 @@ -49,7 +52,8 @@ public record PostPerformanceV2AdditionalInformationsQueryBodyDto public string[]? ExternalIds { get; set; } /// - /// 被评估人 ID 列表，获取周期下被评估人的事项信息。「item_ids」、「external_ids」参数有值时该参数不生效 + /// 被评估人 ID 列表，与入参 `user_id_type` 类型一致，可通过[获取被评估人信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/performance-v2/reviewee/query)接口获取 + /// **说明**：若提供多个筛选参数，按照 `item_ids` > `external_ids` > `reviewee_user_ids` 的优先级顺序，以第一个有值的筛选参数进行筛选 /// 必填：否 /// 最大长度：50 /// 最小长度：0 diff --git a/src/Performance/PostPerformanceV2AdditionalInformationsQueryResponseDto.cs b/src/Performance/PostPerformanceV2AdditionalInformationsQueryResponseDto.cs index 3ca5d80..a8ed264 100644 --- a/src/Performance/PostPerformanceV2AdditionalInformationsQueryResponseDto.cs +++ b/src/Performance/PostPerformanceV2AdditionalInformationsQueryResponseDto.cs @@ -13,7 +13,7 @@ namespace FeishuNetSdk.Performance; /// /// 批量查询补充信息 响应体 -/// 可批量查询被评估人的补充信息。 +/// 批量查询被评估人的补充信息，如补充信息的事项、时间以及具体描述等。 /// 接口ID：7371009404255617028 /// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/performance-v2/additional_information/query /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fperformance-v2%2fadditional_information%2fquery @@ -33,7 +33,7 @@ public record PostPerformanceV2AdditionalInformationsQueryResponseDto public record AdditionalInformation { /// - /// 飞书绩效的事项 ID + /// 补充信息 ID /// 必填：否 /// 示例值：7350195758357807123 /// 最大长度：100 @@ -43,7 +43,8 @@ public record AdditionalInformation public string? ItemId { get; set; } /// - /// 外部系统的事项 ID，没有则返回为空 + /// 外部系统补充信息 ID + /// **说明**：若导入时没有提供，则返回为空 /// 必填：否 /// 示例值：6789523104723558912 /// 最大长度：100 @@ -53,7 +54,7 @@ public record AdditionalInformation public string? ExternalId { get; set; } /// - /// 被评估人 ID + /// 被评估人 ID，与入参 `user_id_type` 类型一致 /// 必填：是 /// 示例值：ou_3245842393d09e9428ad4655da6e30b3 /// 最大长度：9999 @@ -65,7 +66,7 @@ public record AdditionalInformation /// /// 事项 /// 必填：是 - /// 示例值：文本 + /// 示例值：业绩补充说明 /// 最大长度：1000 /// 最小长度：1 /// @@ -73,7 +74,8 @@ public record AdditionalInformation public string Item { get; set; } = string.Empty; /// - /// 事项时间，格式为文本内容 + /// 时间 + /// **说明**：文本内容，无格式校验 /// 必填：是 /// 示例值：2024-03-12 /// 最大长度：100 @@ -83,9 +85,9 @@ public record AdditionalInformation public string Time { get; set; } = string.Empty; /// - /// 事项详细描述 + /// 具体描述 /// 必填：是 - /// 示例值：多行文本 + /// 示例值：销售额增长目标超额完成 /// 最大长度：1000 /// 最小长度：1 /// diff --git a/src/Performance/PostPerformanceV2ReviewDatasQueryBodyDto.cs b/src/Performance/PostPerformanceV2ReviewDatasQueryBodyDto.cs index 8fa4f40..033096f 100644 --- a/src/Performance/PostPerformanceV2ReviewDatasQueryBodyDto.cs +++ b/src/Performance/PostPerformanceV2ReviewDatasQueryBodyDto.cs @@ -40,7 +40,8 @@ public record PostPerformanceV2ReviewDatasQueryBodyDto public string[] RevieweeUserIds { get; set; } = Array.Empty(); /// - /// 环节类型，如果同时传了环节 ID 和环节类型，优先返回环节 ID 对应的绩效数据。不传默认不返回任何环节评估数据 + /// 环节类型，如果同时传了环节 ID 和环节类型，优先返回环节 ID 对应的绩效数据。 + /// stage_types 和 stage_ids 至少要传一个，不传默认不返回任何环节评估数据。 /// 必填：否 /// [JsonPropertyName("stage_types")] @@ -54,7 +55,8 @@ public record PostPerformanceV2ReviewDatasQueryBodyDto public string[]? ReviewStageRoles { get; set; } /// - /// 环节 ID，如果同时传了环节 ID 和环节类型，优先返回环节 ID 对应的绩效数据。不传默认不返回任何环节评估数据。 + /// 环节 ID，如果同时传了环节 ID 和环节类型，优先返回环节 ID 对应的绩效数据。 + /// stage_types 和 stage_ids 至少要传一个，不传默认不返回任何环节评估数据。 /// 可在事件[绩效结果开通](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/performance-v2/stage_task/events/open_result)、[绩效详情变更](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/performance-v2/review_data/events/changed)获得，用于接收事件后按环节查询评估数据场景 /// 必填：否 /// 最大长度：50