From 8dedef47007d4b59d4779afaae1cac6c4ae13add Mon Sep 17 00:00:00 2001 From: "Vicente.Yu" <^@^> Date: Wed, 7 Aug 2024 21:20:03 +0800 Subject: [PATCH] =?UTF-8?q?=E6=96=B0=E5=A2=9E=20-=20=E3=80=90=E7=AE=A1?= =?UTF-8?q?=E7=90=86=E5=90=8E=E5=8F=B0=E3=80=91=E8=8E=B7=E5=8F=96=E8=A1=8C?= =?UTF-8?q?=E4=B8=BA=E5=AE=A1=E8=AE=A1=E6=97=A5=E5=BF=97=E6=95=B0=E6=8D=AE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 变更 - 更新个人信息 请求体 - 更新个人信息 响应体 - 建个人信息 请求体 - 创建个人信息 响应体 - 更新任职信息 请求体 - 【飞书人事】更新任职信息 Signed-off-by: Vicente.Yu <^@^> --- TenantAccessList.md | 216 +++++----- UserAccessList.md | 54 +-- .../GetAdminV1AuditInfosResponseDto.cs | 371 ++++++++++++++++++ ...eaveEmployExpireRecordsByLeaveIdBodyDto.cs | 8 +- ...EmployExpireRecordsByLeaveIdResponseDto.cs | 6 +- ...nceV1LeaveAccrualRecordByLeaveIdBodyDto.cs | 8 +- ...1LeaveAccrualRecordByLeaveIdResponseDto.cs | 12 +- .../PostAttendanceV1GroupsBodyDto.cs | 2 +- ...tendanceV1UserApprovalsQueryResponseDto.cs | 4 +- .../PostAttendanceV1UserTaskRemedysBodyDto.cs | 8 +- ...skRemedysQueryUserAllowedRemedysBodyDto.cs | 4 +- ...medysQueryUserAllowedRemedysResponseDto.cs | 10 +- ...tAttendanceV1UserTaskRemedysResponseDto.cs | 8 +- ...1UserStatsViewsByUserStatsViewIdBodyDto.cs | 8 +- ...rStatsViewsByUserStatsViewIdResponseDto.cs | 6 +- .../PatchContactV3UsersByUserIdBodyDto.cs | 6 +- src/Contact/PostContactV3UsersBodyDto.cs | 6 +- .../PatchCorehrV2PersonsByPersonIdBodyDto.cs | 55 ++- ...tchCorehrV2PersonsByPersonIdResponseDto.cs | 118 +++--- src/Corehr/PostCorehrV2PersonsBodyDto.cs | 71 +++- src/Corehr/PostCorehrV2PersonsResponseDto.cs | 140 +++---- src/FeishuNetSdk.csproj | 2 +- ...sByProcessIdFormVariableDataResponseDto.cs | 6 +- ...PatchCorehrV1JobDatasByJobDataIdBodyDto.cs | 30 +- ...hCorehrV1JobDatasByJobDataIdResponseDto.cs | 2 +- ...PostCorehrV1LeaveGrantingRecordsBodyDto.cs | 10 +- ...CorehrV1LeaveGrantingRecordsResponseDto.cs | 20 +- .../GetHireV1AgenciesByAgencyIdResponseDto.cs | 16 +- src/Hire/GetHireV1AgenciesQueryResponseDto.cs | 20 +- ...icationsByApplicationIdOfferResponseDto.cs | 2 +- ...tHireV1EmployeesByEmployeeIdResponseDto.cs | 10 +- ...eV1EmployeesGetByApplicationResponseDto.cs | 10 +- src/Hire/GetHireV1InterviewsResponseDto.cs | 24 +- ...tHireV1JobRequirementSchemasResponseDto.cs | 90 ++--- ...ormsByOfferApplicationFormIdResponseDto.cs | 20 +- .../GetHireV1OffersByOfferIdResponseDto.cs | 2 +- ...lWebsitesJobPostsByJobPostIdResponseDto.cs | 140 +++---- ...reV1ReferralWebsitesJobPostsResponseDto.cs | 150 +++---- ...eV1ReferralsGetByApplicationResponseDto.cs | 28 +- src/Hire/PostHireV1AgenciesProtectBodyDto.cs | 18 +- ...V1AgenciesProtectionPeriodSearchBodyDto.cs | 4 +- ...enciesProtectionPeriodSearchResponseDto.cs | 29 +- src/Hire/PostHireV1JobRequirementsBodyDto.cs | 78 ++-- .../PostHireV1JobRequirementsResponseDto.cs | 98 ++--- src/Hire/PostHireV1ReferralsSearchBodyDto.cs | 8 +- .../PostHireV1ReferralsSearchResponseDto.cs | 27 +- ...obRequirementsByJobRequirementIdBodyDto.cs | 71 ++-- ...CustomFieldsByOfferCustomFieldIdBodyDto.cs | 2 +- src/IFeishuTenantApi.cs | 295 ++++++++++---- src/IFeishuUserApi.cs | 19 +- src/Task/PostTaskV2TasksBodyDto.cs | 17 +- 51 files changed, 1484 insertions(+), 885 deletions(-) create mode 100644 src/Admin.Spec/GetAdminV1AuditInfosResponseDto.cs diff --git a/TenantAccessList.md b/TenantAccessList.md index 3f5d6054..a4024998 100644 --- a/TenantAccessList.md +++ b/TenantAccessList.md @@ -389,7 +389,7 @@ PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFieldsByFieldId 1952023-07-28✓多维表格列出表单问题 GetBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFields -1962024-07-31✓多维表格检索记录 +1962024-07-31✓多维表格[不推荐] 检索记录 GetBitableV1AppsByAppTokenTablesByTableIdRecordsByRecordId 1972024-07-31✓多维表格列出记录 GetBitableV1AppsByAppTokenTablesByTableIdRecords @@ -445,7 +445,7 @@ DeleteWikiV2SpacesBySpaceIdMembersByMemberId 2232024-07-31✓云文档更新知识空间设置 PutWikiV2SpacesBySpaceIdSetting -2242024-07-05✓通讯录创建用户 +2242024-08-08✓通讯录创建用户 PostContactV3Users 2252024-07-05✓通讯录获取子部门列表 GetContactV3DepartmentsByDepartmentIdChildren @@ -481,7 +481,7 @@ GetCalendarV4Calendars 2412024-08-02✓日历更新日历信息 PatchCalendarV4CalendarsByCalendarId -2422024-07-16✓日历搜索日历 +2422024-08-07✓日历搜索日历 PostCalendarV4CalendarsSearch 2432024-07-16✓日历订阅日历 PostCalendarV4CalendarsByCalendarIdSubscribe @@ -497,7 +497,7 @@ GetCalendarV4CalendarsByCalendarIdAcls 2492024-07-16✓日历创建日程 PostCalendarV4CalendarsByCalendarIdEvents -2502024-07-16✓日历删除日程 +2502024-08-06✓日历删除日程 DeleteCalendarV4CalendarsByCalendarIdEventsByEventId 2512024-07-16✓日历更新日程 PatchCalendarV4CalendarsByCalendarIdEventsByEventId @@ -551,7 +551,7 @@ GetVcV1MeetingsByMeetingId 2762024-05-20✓视频会议获取与会议号关联的会议列表 GetVcV1MeetingsListByNo -2772024-07-23✓视频会议获取录制文件 +2772024-08-07✓视频会议获取录制文件 GetVcV1MeetingsByMeetingIdRecording 2782024-04-29✓视频会议获取会议报告 GetVcV1ReportsGetDaily @@ -643,7 +643,7 @@ PostAttendanceV1ShiftsQuery 3222024-07-11✓考勤打卡查询所有班次 GetAttendanceV1Shifts -3232024-07-26✓考勤打卡创建或修改考勤组 +3232024-08-07✓考勤打卡创建或修改考勤组 PostAttendanceV1Groups 3242024-07-05✓通讯录获取单位信息 GetContactV3UnitByUnitId @@ -659,7 +659,7 @@ PostAttendanceV1UserDailyShiftsBatchCreate 3302024-07-24✓考勤打卡查询排班表 PostAttendanceV1UserDailyShiftsQuery -3312024-07-29✓考勤打卡更新统计设置 +3312024-08-05✓考勤打卡更新统计设置 PutAttendanceV1UserStatsViewsByUserStatsViewId 3322024-07-24✓考勤打卡查询统计表头 PostAttendanceV1UserStatsFieldsQuery @@ -671,15 +671,15 @@ DeleteContactV3UsersByUserId 3362024-07-05✓通讯录获取单位列表 GetContactV3Unit -3372024-07-16✓考勤打卡获取审批通过数据 +3372024-08-05✓考勤打卡获取审批通过数据 PostAttendanceV1UserApprovalsQuery 3382024-07-16✓考勤打卡写入审批结果 PostAttendanceV1UserApprovals 3392024-07-10✓考勤打卡通知审批状态更新 PostAttendanceV1ApprovalInfosProcess -3402024-07-08✓考勤打卡通知补卡审批发起 +3402024-08-05✓考勤打卡通知补卡审批发起 PostAttendanceV1UserTaskRemedys -3412024-07-08✓考勤打卡获取可补卡时间 +3412024-08-05✓考勤打卡获取可补卡时间 PostAttendanceV1UserTaskRemedysQueryUserAllowedRemedys 3422024-07-25✓考勤打卡获取补卡记录 PostAttendanceV1UserTaskRemedysQuery @@ -701,9 +701,9 @@ PostAttendanceV1FilesUpload 3512024-07-26✓考勤打卡下载用户人脸识别照片 GetAttendanceV1FilesByFileIdDownload -3522023-09-11✓考勤打卡通过过期时间获取发放记录 +3522024-08-06✓考勤打卡通过过期时间获取发放记录 GetAttendanceV1LeaveEmployExpireRecordsByLeaveId -3532023-09-11✓考勤打卡修改发放记录 +3532024-08-06✓考勤打卡修改发放记录 PatchAttendanceV1LeaveAccrualRecordByLeaveId 3542024-07-03✓审批创建审批定义 PostApprovalV4Approvals @@ -885,7 +885,7 @@ PostTaskV1TasksByTaskIdBatchDeleteCollaborator 4432024-04-15✓任务获取执行者列表 GetTaskV1TasksByTaskIdCollaborators -4442023-10-12✓任务创建任务 +4442024-08-07✓任务创建任务 PostTaskV2Tasks 4452023-10-12✓任务获取任务详情 GetTaskV2TasksByTaskGuid @@ -999,105 +999,105 @@ PostTaskV2CustomFieldsByCustomFieldGuidOptions 5002023-09-11✓任务更新自定义字段选项 PatchTaskV2CustomFieldsByCustomFieldGuidOptionsByOptionGuid -5012024-07-25✓邮箱创建邮件组 +5012024-08-06✓邮箱创建邮件组 PostMailV1Mailgroups 5022024-07-05✓通讯录删除职级 DeleteContactV3JobLevelsByJobLevelId -5032024-07-25✓邮箱删除邮件组 +5032024-08-06✓邮箱删除邮件组 DeleteMailV1MailgroupsByMailgroupId -5042024-07-25✓邮箱修改邮件组部分信息 +5042024-08-06✓邮箱修改邮件组部分信息 PatchMailV1MailgroupsByMailgroupId -5052024-07-25✓邮箱修改邮件组全部信息 +5052024-08-06✓邮箱修改邮件组全部信息 PutMailV1MailgroupsByMailgroupId -5062024-07-25✓邮箱查询指定邮件组 +5062024-08-06✓邮箱查询指定邮件组 GetMailV1MailgroupsByMailgroupId -5072024-07-25✓邮箱批量获取邮件组 +5072024-08-06✓邮箱批量获取邮件组 GetMailV1Mailgroups -5082024-07-25✓邮箱批量创建邮件组管理员 +5082024-08-06✓邮箱批量创建邮件组管理员 PostMailV1MailgroupsByMailgroupIdManagersBatchCreate -5092024-07-25✓邮箱批量删除邮件组管理员 +5092024-08-06✓邮箱批量删除邮件组管理员 PostMailV1MailgroupsByMailgroupIdManagersBatchDelete -5102024-07-25✓邮箱批量获取邮件组管理员 +5102024-08-06✓邮箱批量获取邮件组管理员 GetMailV1MailgroupsByMailgroupIdManagers -5112024-07-25✓邮箱创建邮件组成员 +5112024-08-06✓邮箱创建邮件组成员 PostMailV1MailgroupsByMailgroupIdMembers -5122024-07-25✓邮箱删除邮件组成员 +5122024-08-06✓邮箱删除邮件组成员 DeleteMailV1MailgroupsByMailgroupIdMembersByMemberId 5132024-07-05✓通讯录更新职级 PutContactV3JobLevelsByJobLevelId -5142024-07-25✓邮箱查询指定邮件组成员 +5142024-08-06✓邮箱查询指定邮件组成员 GetMailV1MailgroupsByMailgroupIdMembersByMemberId -5152024-07-25✓邮箱获取所有邮件组成员 +5152024-08-06✓邮箱获取所有邮件组成员 GetMailV1MailgroupsByMailgroupIdMembers -5162024-07-25✓邮箱批量创建邮件组成员 +5162024-08-06✓邮箱批量创建邮件组成员 PostMailV1MailgroupsByMailgroupIdMembersBatchCreate -5172024-07-25✓邮箱批量删除邮件组成员 +5172024-08-06✓邮箱批量删除邮件组成员 DeleteMailV1MailgroupsByMailgroupIdMembersBatchDelete -5182024-07-25✓邮箱创建邮件组别名 +5182024-08-06✓邮箱创建邮件组别名 PostMailV1MailgroupsByMailgroupIdAliases -5192024-07-25✓邮箱删除邮件组别名 +5192024-08-06✓邮箱删除邮件组别名 DeleteMailV1MailgroupsByMailgroupIdAliasesByAliasId -5202024-07-25✓邮箱获取邮件组所有别名 +5202024-08-06✓邮箱获取邮件组所有别名 GetMailV1MailgroupsByMailgroupIdAliases -5212024-07-25✓邮箱创建邮件组权限成员 +5212024-08-06✓邮箱创建邮件组权限成员 PostMailV1MailgroupsByMailgroupIdPermissionMembers -5222024-07-25✓邮箱删除邮件组权限成员 +5222024-08-06✓邮箱删除邮件组权限成员 DeleteMailV1MailgroupsByMailgroupIdPermissionMembersByPermissionMemberId -5232024-07-25✓邮箱获取邮件组权限成员 +5232024-08-06✓邮箱获取邮件组权限成员 GetMailV1MailgroupsByMailgroupIdPermissionMembersByPermissionMemberId 5242024-07-05✓通讯录获取单个职级信息 GetContactV3JobLevelsByJobLevelId -5252024-07-25✓邮箱批量获取邮件组权限成员 +5252024-08-06✓邮箱批量获取邮件组权限成员 GetMailV1MailgroupsByMailgroupIdPermissionMembers -5262024-07-25✓邮箱批量创建邮件组权限成员 +5262024-08-06✓邮箱批量创建邮件组权限成员 PostMailV1MailgroupsByMailgroupIdPermissionMembersBatchCreate -5272024-07-25✓邮箱批量删除邮件组权限成员 +5272024-08-06✓邮箱批量删除邮件组权限成员 DeleteMailV1MailgroupsByMailgroupIdPermissionMembersBatchDelete -5282024-07-25✓邮箱创建公共邮箱 +5282024-08-06✓邮箱创建公共邮箱 PostMailV1PublicMailboxes -5292024-07-25✓邮箱修改公共邮箱部分信息 +5292024-08-06✓邮箱修改公共邮箱部分信息 PatchMailV1PublicMailboxesByPublicMailboxId -5302024-07-25✓邮箱修改公共邮箱全部信息 +5302024-08-06✓邮箱修改公共邮箱全部信息 PutMailV1PublicMailboxesByPublicMailboxId -5312024-07-25✓邮箱查询指定公共邮箱 +5312024-08-06✓邮箱查询指定公共邮箱 GetMailV1PublicMailboxesByPublicMailboxId -5322024-07-25✓邮箱查询所有公共邮箱 +5322024-08-06✓邮箱查询所有公共邮箱 GetMailV1PublicMailboxes -5332024-07-25✓邮箱永久删除公共邮箱 +5332024-08-06✓邮箱永久删除公共邮箱 DeleteMailV1PublicMailboxesByPublicMailboxId -5342024-07-25✓邮箱添加公共邮箱成员 +5342024-08-06✓邮箱添加公共邮箱成员 PostMailV1PublicMailboxesByPublicMailboxIdMembers 5352024-07-05✓通讯录获取租户职级列表 GetContactV3JobLevels -5362024-07-25✓邮箱删除公共邮箱单个成员 +5362024-08-06✓邮箱删除公共邮箱单个成员 DeleteMailV1PublicMailboxesByPublicMailboxIdMembersByMemberId -5372024-07-25✓邮箱删除公共邮箱所有成员 +5372024-08-06✓邮箱删除公共邮箱所有成员 PostMailV1PublicMailboxesByPublicMailboxIdMembersClear -5382024-07-25✓邮箱查询指定公共邮箱成员信息 +5382024-08-06✓邮箱查询指定公共邮箱成员信息 GetMailV1PublicMailboxesByPublicMailboxIdMembersByMemberId -5392024-07-25✓邮箱查询所有公共邮箱成员信息 +5392024-08-06✓邮箱查询所有公共邮箱成员信息 GetMailV1PublicMailboxesByPublicMailboxIdMembers -5402024-07-25✓邮箱批量添加公共邮箱成员 +5402024-08-06✓邮箱批量添加公共邮箱成员 PostMailV1PublicMailboxesByPublicMailboxIdMembersBatchCreate -5412024-07-25✓邮箱批量删除公共邮箱成员 +5412024-08-06✓邮箱批量删除公共邮箱成员 DeleteMailV1PublicMailboxesByPublicMailboxIdMembersBatchDelete -5422024-07-25✓邮箱创建公共邮箱别名 +5422024-08-06✓邮箱创建公共邮箱别名 PostMailV1PublicMailboxesByPublicMailboxIdAliases -5432024-07-25✓邮箱删除公共邮箱别名 +5432024-08-06✓邮箱删除公共邮箱别名 DeleteMailV1PublicMailboxesByPublicMailboxIdAliasesByAliasId -5442024-07-25✓邮箱查询公共邮箱的所有别名 +5442024-08-06✓邮箱查询公共邮箱的所有别名 GetMailV1PublicMailboxesByPublicMailboxIdAliases -5452024-07-25✓邮箱从回收站删除用户邮箱地址 +5452024-08-06✓邮箱从回收站删除用户邮箱地址 DeleteMailV1UserMailboxesByUserMailboxId 5462024-07-05✓通讯录创建序列 PostContactV3JobFamilies -5472024-07-25✓邮箱创建用户邮箱别名 +5472024-08-06✓邮箱创建用户邮箱别名 PostMailV1UserMailboxesByUserMailboxIdAliases -5482024-07-25✓邮箱删除用户邮箱别名 +5482024-08-06✓邮箱删除用户邮箱别名 DeleteMailV1UserMailboxesByUserMailboxIdAliasesByAliasId -5492024-07-25✓邮箱获取用户邮箱所有别名 +5492024-08-06✓邮箱获取用户邮箱所有别名 GetMailV1UserMailboxesByUserMailboxIdAliases -5502024-07-25✓邮箱查询邮箱地址状态 +5502024-08-06✓邮箱查询邮箱地址状态 PostMailV1UsersQuery 5512022-03-15✓应用信息校验应用管理员 GetApplicationV3IsUserAdmin @@ -1111,7 +1111,7 @@ PatchApplicationV6ApplicationsByAppIdContactsRange 5562023-09-12✓应用信息获取用户可用的应用 GetApplicationV1UserVisibleApps -5572024-07-05✓通讯录修改用户部分信息 +5572024-08-06✓通讯录修改用户部分信息 PatchContactV3UsersByUserId 5582024-07-05✓通讯录删除序列 DeleteContactV3JobFamiliesByJobFamilyId @@ -1153,7 +1153,7 @@ PatchApplicationV6ApplicationsByAppIdFeedbacksByFeedbackId 5772024-07-23✓应用信息获取应用反馈列表 GetApplicationV6ApplicationsByAppIdFeedbacks -5782024-07-23✓应用信息更新应用红点 +5782024-08-05✓应用信息更新应用红点 PostApplicationV6AppBadgeSet 5792023-07-07✓企业信息获取企业席位信息接口 GetTenantV2TenantAssignInfoListQuery @@ -1349,9 +1349,9 @@ PatchCorehrV1EmploymentsByEmploymentId 6752024-02-06✓飞书人事删除雇佣信息 DeleteCorehrV1EmploymentsByEmploymentId -6762024-07-24✓飞书人事（企业版）创建个人信息 +6762024-08-05✓飞书人事（企业版）创建个人信息 PostCorehrV2Persons -6772024-07-24✓飞书人事（企业版）更新个人信息 +6772024-08-05✓飞书人事（企业版）更新个人信息 PatchCorehrV2PersonsByPersonId 6782024-02-06✓飞书人事删除个人信息 DeleteCorehrV1PersonsByPersonId @@ -1365,7 +1365,7 @@ PostCorehrV1JobDatas 6832024-02-06✓飞书人事删除任职信息 DeleteCorehrV1JobDatasByJobDataId -6842024-07-08✓飞书人事更新任职信息 +6842024-08-05✓飞书人事更新任职信息 PatchCorehrV1JobDatasByJobDataId 6852024-07-25✓飞书人事查询单个任职信息 GetCorehrV1JobDatasByJobDataId @@ -1505,9 +1505,9 @@ PostCorehrV1OffboardingsSubmit 7532024-07-15✓飞书人事搜索离职信息 PostCorehrV1OffboardingsSearch -7542024-05-30✓飞书人事创建假期发放记录 +7542024-08-06✓飞书人事创建假期发放记录 PostCorehrV1LeaveGrantingRecords -7552024-05-30✓飞书人事删除假期发放记录 +7552024-08-06✓飞书人事删除假期发放记录 DeleteCorehrV1LeaveGrantingRecordsByLeaveGrantingRecordId 7562024-06-03✓飞书人事获取假期类型列表 GetCorehrV1LeavesLeaveTypes @@ -1547,31 +1547,31 @@ PostHireV1JobsByJobIdUpdateConfig 7742023-11-02✓招聘获取职位类别列表 GetHireV1JobTypes -7752024-05-23✓招聘创建招聘需求 +7752024-08-07✓招聘创建招聘需求 PostHireV1JobRequirements 7762024-07-11✓招聘获取招聘需求信息 PostHireV1JobRequirementsSearch 7772024-07-11✓招聘获取招聘需求列表 GetHireV1JobRequirements -7782024-06-14✓招聘更新招聘需求 +7782024-08-07✓招聘更新招聘需求 PutHireV1JobRequirementsByJobRequirementId 7792024-07-05✓通讯录批量获取用户信息 GetContactV3UsersBatch 7802024-06-21✓消息与群组发送电话加急 PatchImV1MessagesByMessageIdUrgentPhone -7812024-07-10✓招聘删除招聘需求 +7812024-08-07✓招聘删除招聘需求 DeleteHireV1JobRequirementsByJobRequirementId -7822024-07-10✓招聘获取招聘需求模板 +7822024-08-07✓招聘获取招聘需求模板列表 GetHireV1JobRequirementSchemas 7832024-07-30✓招聘获取招聘流程信息 GetHireV1JobProcesses 7842023-11-02✓招聘获取信息登记表模板列表 GetHireV1RegistrationSchemas -7852024-06-18✓招聘获取内推官网下的职位列表 +7852024-08-07✓招聘获取内推官网下职位广告列表 GetHireV1ReferralWebsitesJobPosts -7862024-06-18✓招聘获取内推官网下职位广告详情 +7862024-08-07✓招聘获取内推官网下职位广告详情 GetHireV1ReferralWebsitesJobPostsByJobPostId -7872024-07-10✓招聘获取内推信息 +7872024-08-07✓招聘获取内推信息 GetHireV1ReferralsGetByApplication 7882024-07-03✓招聘创建外部投递 PostHireV1ExternalApplications @@ -1611,15 +1611,15 @@ GetHireV1Evaluations 8062024-06-24✓招聘获取面试满意度问卷列表 GetHireV1Questionnaires -8072024-07-30✓招聘获取面试信息 +8072024-08-07✓招聘获取面试信息 GetHireV1Interviews 8082024-07-11✓招聘创建 Offer PostHireV1Offers 8092024-04-26✓招聘更新 Offer 信息 PutHireV1OffersByOfferId -8102024-07-11✓招聘获取 Offer 信息 +8102024-08-07✓招聘获取 Offer 信息 GetHireV1ApplicationsByApplicationIdOffer -8112024-07-11✓招聘获取 Offer 详情 +8112024-08-07✓招聘获取 Offer 详情 GetHireV1OffersByOfferId 8122024-07-11✓招聘获取 Offer 列表 GetHireV1Offers @@ -1787,9 +1787,9 @@ GetLingoV1FilesByFileTokenDownload 8942024-04-26✓安全合规获取OpenAPI审计日志数据 PostSecurityAndComplianceV1OpenapiLogsListData -8952024-07-29✓妙记获取妙记统计数据 +8952024-08-07✓妙记获取妙记统计数据 GetMinutesV1MinutesByMinuteTokenStatistics -8962024-07-29✓妙记获取妙记信息 +8962024-08-07✓妙记获取妙记信息 GetMinutesV1MinutesByMinuteToken 8972023-06-29✓工作台获取工作台访问数据 PostWorkplaceV1WorkplaceAccessDataSearch @@ -1805,33 +1805,33 @@ PostEphemeralV1Send 9032023-07-10✓主数据用户数据维度解绑 PostMdmV1UserAuthDataRelationsUnbind -9042023-10-13✓词典创建草稿 +9042023-10-13✓词典[不推荐] 创建草稿 PostBaikeV1Drafts -9052023-10-13✓词典更新草稿 +9052023-10-13✓词典[不推荐] 更新草稿 PutBaikeV1DraftsByDraftId -9062024-04-24✓词典创建免审词条 +9062024-04-24✓词典[不推荐] 创建免审词条 PostBaikeV1Entities -9072023-10-13✓词典更新免审词条 +9072023-10-13✓词典[不推荐] 更新免审词条 PutBaikeV1EntitiesByEntityId -9082023-10-13✓词典获取词条详情 +9082023-10-13✓词典[不推荐] 获取词条详情 GetBaikeV1EntitiesByEntityId -9092023-10-13✓词典获取词条列表 +9092023-10-13✓词典[不推荐] 获取词条列表 GetBaikeV1Entities -9102023-10-13✓词典精准搜索词条 +9102023-10-13✓词典[不推荐] 精准搜索词条 PostBaikeV1EntitiesMatch -9112023-10-13✓词典模糊搜索词条 +9112023-10-13✓词典[不推荐] 模糊搜索词条 PostBaikeV1EntitiesSearch -9122023-10-13✓词典词条高亮 +9122023-10-13✓词典[不推荐] 词条高亮 PostBaikeV1EntitiesHighlight 9132022-12-29✓消息与群组删除仅特定人可见的消息卡片 PostEphemeralV1Delete -9142023-10-13✓词典提取潜在的词条 +9142023-10-13✓词典[不推荐] 提取潜在的词条 PostBaikeV1EntitiesExtract -9152023-10-13✓词典获取词典分类 +9152023-10-13✓词典[不推荐] 获取词典分类 GetBaikeV1Classifications -9162023-10-13✓词典上传图片 +9162023-10-13✓词典[不推荐] 上传图片 PostBaikeV1FilesUpload -9172023-10-13✓词典下载图片 +9172023-10-13✓词典[不推荐] 下载图片 GetBaikeV1FilesByFileTokenDownload 9182023-04-27✓应用信息更新应用可用范围 PostApplicationV3AppUpdateVisibility @@ -1883,7 +1883,7 @@ GetContactV2RoleList 9422024-04-15✓通讯录更新用户所有信息 PutContactV3UsersByUserId -9432024-08-02✓通讯录获取部门信息列表 +9432024-08-02✓通讯录[不推荐] 获取部门信息列表 GetContactV3Departments 9442021-07-13✓通讯录批量新增部门 PostContactV2DepartmentBatchAdd @@ -2211,7 +2211,7 @@ PutHireV1WebsitesByWebsiteIdChannelsByChannelId 11062024-07-10✓消息与群组添加跟随气泡 PostImV1MessagesByMessageIdPushFollowUp -11072024-07-19✓招聘获取地址列表 +11072024-08-08✓招聘获取地址列表 GetHireV1Locations 11082024-08-02✓招聘获取招聘官网投递任务结果 GetHireV1WebsitesByWebsiteIdDeliveryTasksByDeliveryTaskId @@ -2247,11 +2247,11 @@ PostCorehrV2PreHiresQuery 11242024-07-22✓招聘职位发布至官网 PostHireV1AdvertisementsByAdvertisementIdPublish -11252024-07-22✓招聘设置猎头保护期 +11252024-08-07✓招聘设置猎头保护期 PostHireV1AgenciesProtect -11262024-07-31✓招聘获取猎头供应商信息 +11262024-08-07✓招聘获取猎头供应商信息 GetHireV1AgenciesByAgencyId -11272024-07-26✓招聘查询猎头供应商信息 +11272024-08-07✓招聘查询猎头供应商信息 GetHireV1AgenciesQuery 11282024-07-22✓招聘转移投递阶段 PostHireV1ApplicationsByApplicationIdTransferStage @@ -2283,7 +2283,7 @@ GetHireV1InterviewsGetByTalent 11422024-07-22✓招聘获取面试登记表模板列表 GetHireV1InterviewRegistrationSchemas -11432024-07-30✓招聘获取 Offer 申请表信息 +11432024-08-08✓招聘获取 Offer 申请表信息 GetHireV1OfferApplicationFormsByOfferApplicationFormId 11442024-07-30✓招聘获取笔试阅卷任务列表 GetHireV1ExamMarkingTasks @@ -2299,11 +2299,11 @@ PostHireV1TalentOperationLogsSearch 11502024-07-22✓招聘获取职位广告发布记录 PostHireV1JobPublishRecordsSearch -11512024-07-30✓招聘更新 Offer 申请表自定义字段 +11512024-08-08✓招聘更新 Offer 申请表自定义字段 PutHireV1OfferCustomFieldsByOfferCustomFieldId 11522024-07-30✓招聘获取笔试列表 PostHireV1TestsSearch -11532024-07-31✓招聘获取人才详情 +11532024-08-07✓招聘获取人才详情 GetHireV2TalentsByTalentId 11542024-07-22✓招聘获取面试评价信息附件 GetHireV1InterviewRecordsAttachments @@ -2317,25 +2317,25 @@ PostHireV1TalentsByTalentIdOnboardStatus 11592024-07-22✓招聘更新外部面评 PatchHireV1ExternalInterviewAssessmentsByExternalInterviewAssessmentId -11602024-07-30✓招聘批量获取面试评价详细信息 +11602024-08-07✓招聘批量获取面试评价详细信息 GetHireV1InterviewRecords 11612024-07-22✓招聘创建三方协议 PostHireV1TripartiteAgreements 11622024-07-26✓招聘删除三方协议 DeleteHireV1TripartiteAgreementsByTripartiteAgreementId -11632024-07-22✓招聘查询猎头保护期信息 +11632024-08-07✓招聘查询猎头保护期信息 PostHireV1AgenciesProtectionPeriodSearch 11642024-07-22✓招聘获取三方协议 GetHireV1TripartiteAgreements 11652024-07-22✓招聘更新三方协议 PutHireV1TripartiteAgreementsByTripartiteAgreementId -11662024-07-22✓招聘查询人才内推信息 +11662024-08-07✓招聘查询人才内推信息 PostHireV1ReferralsSearch 11672024-07-22✓招聘导入外部内推奖励 PostHireV1ExternalReferralRewards 11682024-07-19✓招聘获取面试评价表列表 GetHireV1InterviewFeedbackForms -11692024-07-26✓招聘删除外部内推奖励 +11692024-08-07✓招聘删除外部内推奖励 DeleteHireV1ExternalReferralRewardsByExternalReferralRewardId 11702024-07-31✓多维表格批量获取记录 PostBitableV1AppsByAppTokenTablesByTableIdRecordsBatchGet @@ -2347,14 +2347,16 @@ PostAttendanceV1ArchiveRuleUserStatsFieldsQuery 11742024-07-23✓考勤打卡查询所有归档规则 GetAttendanceV1ArchiveRule -11752024-08-01新增考勤打卡写入归档报表结果 +11752024-08-01✓考勤打卡写入归档报表结果 PostAttendanceV1ArchiveRuleUploadReport -11762024-08-01新增考勤打卡删除归档报表行数据 +11762024-08-01✓考勤打卡删除归档报表行数据 PostAttendanceV1ArchiveRuleDelReport -11772024-07-31新增云文档获取知识空间成员列表 +11772024-07-31✓云文档获取知识空间成员列表 GetWikiV2SpacesBySpaceIdMembers -11782024-07-31新增绩效获取指标标签列表 +11782024-07-31✓绩效获取指标标签列表 GetPerformanceV2MetricTags -11792024-08-02新增画板获取画板缩略图片 +11792024-08-02✓画板获取画板缩略图片 GetBoardV1WhiteboardsByWhiteboardIdDownloadAsImage +11802024-08-08新增管理后台获取行为审计日志数据 +GetAdminV1AuditInfos diff --git a/UserAccessList.md b/UserAccessList.md index 208f5f41..c7ee5a5b 100644 --- a/UserAccessList.md +++ b/UserAccessList.md @@ -1,7 +1,7 @@ - + @@ -209,7 +209,7 @@ - + @@ -311,7 +311,7 @@ - + @@ -337,7 +337,7 @@ - + @@ -403,7 +403,7 @@ - + @@ -591,7 +591,7 @@ - + @@ -707,7 +707,7 @@ - + @@ -763,47 +763,47 @@ - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + @@ -1035,12 +1035,12 @@ - + - + - + - +
序号更新日期可用类别说明
12024-07-16✓身份验证获取登录用户信息
GetAuthenV1UserInfo
22024-07-05✓通讯录修改用户部分信息
22024-08-06✓通讯录修改用户部分信息
PatchContactV3UsersByUserId
32024-07-05✓通讯录搜索部门
PostContactV3DepartmentsSearch
PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFieldsByFieldId
1052023-07-28✓多维表格列出表单问题
GetBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFields
1062024-07-31✓多维表格检索记录
1062024-07-31✓多维表格[不推荐] 检索记录
GetBitableV1AppsByAppTokenTablesByTableIdRecordsByRecordId
1072024-07-31✓多维表格列出记录
GetBitableV1AppsByAppTokenTablesByTableIdRecords
GetCalendarV4Calendars
1562024-08-02✓日历更新日历信息
PatchCalendarV4CalendarsByCalendarId
1572024-07-16✓日历搜索日历
1572024-08-07✓日历搜索日历
PostCalendarV4CalendarsSearch
1582024-06-21✓消息与群组更新群信息
PutImV1ChatsByChatId
PostCalendarV4CalendarsByCalendarIdEvents
1692024-06-21✓消息与群组更新群发言权限
PutImV1ChatsByChatIdModeration
1702024-07-16✓日历删除日程
1702024-08-06✓日历删除日程
DeleteCalendarV4CalendarsByCalendarIdEventsByEventId
1712024-07-16✓日历更新日程
PatchCalendarV4CalendarsByCalendarIdEventsByEventId
PatchVcV1MeetingsByMeetingIdRecordingStop
2022024-06-21✓消息与群组撤销群置顶
PostImV1ChatsByChatIdTopNoticeDeleteTopNotice
2032024-07-23✓视频会议获取录制文件
2032024-08-07✓视频会议获取录制文件
GetVcV1MeetingsByMeetingIdRecording
2042024-07-23✓视频会议授权录制文件
PatchVcV1MeetingsByMeetingIdRecordingSetPermission
PostTaskV1TasksByTaskIdBatchDeleteCollaborator
2962024-04-15✓任务获取执行者列表
GetTaskV1TasksByTaskIdCollaborators
2972023-10-12✓任务创建任务
2972024-08-07✓任务创建任务
PostTaskV2Tasks
2982023-10-12✓任务获取任务详情
GetTaskV2TasksByTaskGuid
PostTaskV2CustomFieldsByCustomFieldGuidOptions
3542023-09-11✓任务更新自定义字段选项
PatchTaskV2CustomFieldsByCustomFieldGuidOptionsByOptionGuid
3552024-07-25✓邮箱查询所有公共邮箱
3552024-08-06✓邮箱查询所有公共邮箱
GetMailV1PublicMailboxes
3562023-11-27✓搜索搜索消息
PostSearchV2Message
PostLingoV1FilesUpload
3822023-10-25✓词典下载图片
GetLingoV1FilesByFileTokenDownload
3832024-07-29✓妙记获取妙记统计数据
3832024-08-07✓妙记获取妙记统计数据
GetMinutesV1MinutesByMinuteTokenStatistics
3842024-07-29✓妙记获取妙记信息
3842024-08-07✓妙记获取妙记信息
GetMinutesV1MinutesByMinuteToken
3852023-04-07✓应用信息获取用户自定义常用的应用
GetApplicationV5ApplicationsFavourite
3862023-04-07✓应用信息获取管理员推荐的应用
GetApplicationV5ApplicationsRecommend
3872023-10-13✓词典创建草稿
3872023-10-13✓词典[不推荐] 创建草稿
PostBaikeV1Drafts
3882023-10-13✓词典更新草稿
3882023-10-13✓词典[不推荐] 更新草稿
PutBaikeV1DraftsByDraftId
3892024-04-24✓词典创建免审词条
3892024-04-24✓词典[不推荐] 创建免审词条
PostBaikeV1Entities
3902023-10-13✓词典更新免审词条
3902023-10-13✓词典[不推荐] 更新免审词条
PutBaikeV1EntitiesByEntityId
3912024-07-15✓消息与群组会话标签页排序
PostImV1ChatsByChatIdChatTabsSortTabs
3922023-10-13✓词典获取词条详情
3922023-10-13✓词典[不推荐] 获取词条详情
GetBaikeV1EntitiesByEntityId
3932023-10-13✓词典获取词条列表
3932023-10-13✓词典[不推荐] 获取词条列表
GetBaikeV1Entities
3942023-10-13✓词典精准搜索词条
3942023-10-13✓词典[不推荐] 精准搜索词条
PostBaikeV1EntitiesMatch
3952023-10-13✓词典模糊搜索词条
3952023-10-13✓词典[不推荐] 模糊搜索词条
PostBaikeV1EntitiesSearch
3962023-10-13✓词典词条高亮
3962023-10-13✓词典[不推荐] 词条高亮
PostBaikeV1EntitiesHighlight
3972023-10-13✓词典提取潜在的词条
3972023-10-13✓词典[不推荐] 提取潜在的词条
PostBaikeV1EntitiesExtract
3982023-10-13✓词典获取词典分类
3982023-10-13✓词典[不推荐] 获取词典分类
GetBaikeV1Classifications
3992023-10-13✓词典上传图片
3992023-10-13✓词典[不推荐] 上传图片
PostBaikeV1FilesUpload
4002023-10-13✓词典下载图片
4002023-10-13✓词典[不推荐] 下载图片
GetBaikeV1FilesByFileTokenDownload
4012023-05-10✓通讯录获取用户列表
GetContactV3Users
4022024-07-15✓消息与群组拉取会话标签页
GetImV1ChatsByChatIdChatTabsListTabs
4032024-08-02✓通讯录获取部门信息列表
4032024-08-02✓通讯录[不推荐] 获取部门信息列表
GetContactV3Departments
4042023-12-18✓云文档[不推荐] 创建旧版文档
PostDocV2Create
PostAttendanceV1ArchiveRuleUserStatsFieldsQuery
5182024-07-23✓考勤打卡查询所有归档规则
GetAttendanceV1ArchiveRule
5192024-08-01新增考勤打卡写入归档报表结果
5192024-08-01✓考勤打卡写入归档报表结果
PostAttendanceV1ArchiveRuleUploadReport
5202024-08-01新增考勤打卡删除归档报表行数据
5202024-08-01✓考勤打卡删除归档报表行数据
PostAttendanceV1ArchiveRuleDelReport
5212024-07-31新增云文档获取知识空间成员列表
5212024-07-31✓云文档获取知识空间成员列表
GetWikiV2SpacesBySpaceIdMembers
5222024-08-02新增画板获取画板缩略图片
5222024-08-02✓画板获取画板缩略图片
GetBoardV1WhiteboardsByWhiteboardIdDownloadAsImage
diff --git a/src/Admin.Spec/GetAdminV1AuditInfosResponseDto.cs b/src/Admin.Spec/GetAdminV1AuditInfosResponseDto.cs new file mode 100644 index 00000000..5537efcf --- /dev/null +++ b/src/Admin.Spec/GetAdminV1AuditInfosResponseDto.cs @@ -0,0 +1,371 @@ +namespace FeishuNetSdk.Admin.Spec; +/// +/// 获取行为审计日志数据 响应体 +/// 该接口用于查询成员的操作行为日志。行为审计日志中记录了成员进行操作的时间、地点、操作对象等信息。通过查询成员行为日志，管理员可以发现成员是否有违规操作，以保护企业数据和信息安全。 +/// - 性能说明：查询时请适当缩短查询时间范围和适当控制查询频次（避免重复的无效查询等情况） +/// 接口ID：6921713375245352988 +/// 文档地址：https://open.feishu.cn/document/server-docs/security_and_compliance-v1/audit_log/audit_data_get +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuQjM5YjL0ITO24CNykjN%2faudit_log%2faudit_data_get +/// +public record GetAdminV1AuditInfosResponseDto +{ + /// + /// 是否还有更多项 + /// 必填：否 + /// + [JsonPropertyName("has_more")] + public bool? HasMore { get; set; } + + /// + /// 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token + /// 必填：否 + /// + [JsonPropertyName("page_token")] + public string? PageToken { get; set; } + + /// + /// 返回的具体数据内容 + /// 必填：否 + /// + [JsonPropertyName("items")] + public AuditInfo[]? Items { get; set; } + + /// + /// 数据内容 + /// + public record AuditInfo + { + /// + /// 事件ID，不唯一，可用作聚合 + /// 必填：否 + /// + [JsonPropertyName("event_id")] + public string? EventId { get; set; } + + /// + /// 事件唯一ID，可以用于去重，倾向使用该字段识别用户的行为 + /// 必填：否 + /// + [JsonPropertyName("unique_id")] + public string? UniqueId { get; set; } + + /// + /// 事件名称，字段详情见[枚举值列表](https://open.feishu.cn/document/ukTMukTMukTM/uQjM5YjL0ITO24CNykjN/audit_log/appendix) + /// 必填：否 + /// + [JsonPropertyName("event_name")] + public string? EventName { get; set; } + + /// + /// 用户所属部门的ID列表 + /// 必填：否 + /// + [JsonPropertyName("department_ids")] + public string[]? DepartmentIds { get; set; } + + /// + /// 事件模块，字段详情见[枚举值列表](https://open.feishu.cn/document/ukTMukTMukTM/uQjM5YjL0ITO24CNykjN/audit_log/appendix) + /// 必填：否 + /// + [JsonPropertyName("event_module")] + public int? EventModule { get; set; } + + /// + /// 操作人类型 + /// **可选值有**： + /// 1:组织内成员,12:机器人,1001:组织外成员 + /// 必填：否 + /// 可选值： + /// 1：组织内成员 + /// 12：机器人 + /// 1001：组织外成员 + /// + /// + [JsonPropertyName("operator_type")] + public int? OperatorType { get; set; } + + /// + /// 操作人id，当operator_type是1001时，该项为脱敏后的值 + /// 必填：否 + /// + [JsonPropertyName("operator_value")] + public string? OperatorValue { get; set; } + + /// + /// 操作对象列表 + /// 必填：否 + /// + [JsonPropertyName("objects")] + public AuditObjectEntity[]? Objects { get; set; } + + /// + /// 操作对象 + /// + public record AuditObjectEntity + { + /// + /// 操作对象类型，字段详情见[枚举值列表](https://open.feishu.cn/document/ukTMukTMukTM/uQjM5YjL0ITO24CNykjN/audit_log/appendix) + /// 必填：否 + /// + [JsonPropertyName("object_type")] + public string? ObjectType { get; set; } + + /// + /// 操作对象值 + /// 必填：否 + /// + [JsonPropertyName("object_value")] + public string? ObjectValue { get; set; } + + /// + /// 操作对象名称，当前针对文档、会话、应用类型开放，如会话名、文档名等 + /// 必填：否 + /// + [JsonPropertyName("object_name")] + public string? ObjectName { get; set; } + + /// + /// 操作对象所有者，当前针对文档类型开放 + /// 必填：否 + /// + [JsonPropertyName("object_owner")] + public string? ObjectOwner { get; set; } + + /// + /// 操作对象扩展字段，字段详情见[枚举值列表](https://open.feishu.cn/document/ukTMukTMukTM/uQjM5YjL0ITO24CNykjN/audit_log/appendix) + /// 必填：否 + /// + [JsonPropertyName("object_detail")] + public Dictionary? ObjectDetail { get; set; } + } + + /// + /// 接收者对象列表 + /// 必填：否 + /// + [JsonPropertyName("recipients")] + public AuditRecipientEntity[]? Recipients { get; set; } + + /// + /// 接收者对象 + /// + public record AuditRecipientEntity + { + /// + /// 接收者对象类型，1代表用户，2代表部门，4代表会话 + /// 必填：否 + /// + [JsonPropertyName("recipient_type")] + public string? RecipientType { get; set; } + + /// + /// 接收者对象值 + /// 必填：否 + /// + [JsonPropertyName("recipient_value")] + public string? RecipientValue { get; set; } + + /// + /// 接收者对象扩展字段 + /// 必填：否 + /// + [JsonPropertyName("recipient_detail")] + public Dictionary? RecipientDetail { get; set; } + } + + /// + /// 事件时间 + /// 必填：否 + /// + [JsonPropertyName("event_time")] + public int? EventTime { get; set; } + + /// + /// ip信息 + /// 必填：否 + /// + [JsonPropertyName("ip")] + public string? Ip { get; set; } + + /// + /// 第三方isvID + /// 必填：否 + /// + [JsonPropertyName("operator_app")] + public string? OperatorApp { get; set; } + + /// + /// 环境信息 + /// 必填：否 + /// + [JsonPropertyName("audit_context")] + public AuditContextSuffix? AuditContext { get; set; } + + /// + /// 环境信息 + /// + public record AuditContextSuffix + { + /// + /// 终端类型 + /// **可选值有**： + /// 0:ios,1:安卓,2:pc端,3:web端 + /// 必填：否 + /// 可选值： + /// 0：ios + /// 1：安卓 + /// 2：pc端 + /// 3：web端 + /// + /// + [JsonPropertyName("terminal_type")] + public int? TerminalType { get; set; } + + /// + /// 返回ios的环境信息，字段详情见[枚举值列表](https://open.feishu.cn/document/ukTMukTMukTM/uQjM5YjL0ITO24CNykjN/audit_log/appendix) + /// 必填：否 + /// + [JsonPropertyName("ios_context")] + public Dictionary? IosContext { get; set; } + + /// + /// 返回pc的环境信息，字段详情见[枚举值列表](https://open.feishu.cn/document/ukTMukTMukTM/uQjM5YjL0ITO24CNykjN/audit_log/appendix) + /// 必填：否 + /// + [JsonPropertyName("pc_context")] + public Dictionary? PcContext { get; set; } + + /// + /// 返回web的环境信息，字段详情见[枚举值列表](https://open.feishu.cn/document/ukTMukTMukTM/uQjM5YjL0ITO24CNykjN/audit_log/appendix) + /// 必填：否 + /// + [JsonPropertyName("web_context")] + public Dictionary? WebContext { get; set; } + + /// + /// 返回android的环境信息，字段详情见[枚举值列表](https://open.feishu.cn/document/ukTMukTMukTM/uQjM5YjL0ITO24CNykjN/audit_log/appendix) + /// 必填：否 + /// + [JsonPropertyName("android_context")] + public Dictionary? AndroidContext { get; set; } + } + + /// + /// 事件扩展字段，参考common_drawers中的信息即可 + /// 必填：否 + /// + [JsonPropertyName("extend")] + public Dictionary? Extend { get; set; } + + /// + /// 第三方isv名称 + /// 必填：否 + /// + [JsonPropertyName("operator_app_name")] + public string? OperatorAppName { get; set; } + + /// + /// 事件扩展字段，字段详情见[枚举值列表](https://open.feishu.cn/document/ukTMukTMukTM/uQjM5YjL0ITO24CNykjN/audit_log/appendix) + /// 必填：否 + /// + [JsonPropertyName("common_drawers")] + public ApiAuditCommonDrawers? CommonDrawers { get; set; } + + /// + /// 事件扩展字段 + /// + public record ApiAuditCommonDrawers + { + /// + /// 事件扩展字段 + /// + [JsonPropertyName("common_draw_info_list")] + public CommonDrawInfo[]? CommonDrawInfoList { get; set; } + + /// + /// 事件扩展字段 + /// + public record CommonDrawInfo + { + /// + /// + /// + [JsonPropertyName("info_key")] + public string? InfoKey { get; set; } + + /// + /// + /// + [JsonPropertyName("info_val")] + public string? InfoVal { get; set; } + + /// + /// + /// + [JsonPropertyName("key_i18n_key")] + public string? KeyI18nKey { get; set; } + + /// + /// + /// + [JsonPropertyName("val_i18n_key")] + public string? ValI18nKey { get; set; } + + /// + /// + /// + [JsonPropertyName("val_type")] + public string? ValType { get; set; } + } + } + + /// + /// 设备信息： + /// city：ip位置，城市名称； + /// device_model：设备型号； + /// mc：Mac地址； + /// os：操作系统； + /// 必填：否 + /// + [JsonPropertyName("audit_detail")] + public AuditDetailSuffix? AuditDetail { get; set; } + + /// + /// 设备信息 + /// + public record AuditDetailSuffix + { + /// + /// ip位置，城市名称； + /// + [JsonPropertyName("city")] + public string? City { get; set; } + + /// + /// 设备型号； + /// + [JsonPropertyName("device_model")] + public string? DeviceModel { get; set; } + + /// + /// Mac地址； + /// + [JsonPropertyName("mc")] + public string? Mc { get; set; } + + /// + /// 操作系统； + /// + [JsonPropertyName("os")] + public string? Os { get; set; } + + } + + /// + /// 操作人所在企业编号 + /// 必填：否 + /// + [JsonPropertyName("operator_tenant")] + public string? OperatorTenant { get; set; } + } +} diff --git a/src/Attendance/GetAttendanceV1LeaveEmployExpireRecordsByLeaveIdBodyDto.cs b/src/Attendance/GetAttendanceV1LeaveEmployExpireRecordsByLeaveIdBodyDto.cs index 82df9020..8e5a6fc9 100644 --- a/src/Attendance/GetAttendanceV1LeaveEmployExpireRecordsByLeaveIdBodyDto.cs +++ b/src/Attendance/GetAttendanceV1LeaveEmployExpireRecordsByLeaveIdBodyDto.cs @@ -22,7 +22,7 @@ namespace FeishuNetSdk.Attendance; public record GetAttendanceV1LeaveEmployExpireRecordsByLeaveIdBodyDto { /// - /// 员工ID + /// 员工ID，对应employee_type /// 必填：是 /// 示例值：6982509313466189342 /// @@ -30,7 +30,7 @@ public record GetAttendanceV1LeaveEmployExpireRecordsByLeaveIdBodyDto public string EmploymentId { get; set; } = string.Empty; /// - /// 假期类型ID + /// 假期类型ID，可通过[获取假期类型列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave/leave_types)获取 /// 必填：是 /// 示例值：7111688079785723436 /// @@ -38,7 +38,7 @@ public record GetAttendanceV1LeaveEmployExpireRecordsByLeaveIdBodyDto public string LeaveTypeId { get; set; } = string.Empty; /// - /// 失效最早日期 2023-04-10 格式 + /// 失效最早日期，格式为yyyy-MM-dd /// 必填：是 /// 示例值：2023-04-10 /// @@ -46,7 +46,7 @@ public record GetAttendanceV1LeaveEmployExpireRecordsByLeaveIdBodyDto public string StartExpirationDate { get; set; } = string.Empty; /// - /// 失效最晚日期 2023-05-10 格式 + /// 失效最晚日期，格式为yyyy-MM-dd /// 必填：是 /// 示例值：2023-05-10 /// diff --git a/src/Attendance/GetAttendanceV1LeaveEmployExpireRecordsByLeaveIdResponseDto.cs b/src/Attendance/GetAttendanceV1LeaveEmployExpireRecordsByLeaveIdResponseDto.cs index de1e8e2a..0491a3ca 100644 --- a/src/Attendance/GetAttendanceV1LeaveEmployExpireRecordsByLeaveIdResponseDto.cs +++ b/src/Attendance/GetAttendanceV1LeaveEmployExpireRecordsByLeaveIdResponseDto.cs @@ -42,7 +42,7 @@ public record LeaveEmployExpireRecord public string Id { get; set; } = string.Empty; /// - /// 员工ID + /// 员工ID，对应employee_type /// 必填：是 /// 示例值：6982509313466189342 /// @@ -82,7 +82,7 @@ public record LeaveEmployExpireRecord public int GrantingUnit { get; set; } /// - /// 生效日期，格式"2020-01-01" + /// 生效日期，格式为yyyy-MM-dd /// 必填：是 /// 示例值：2020-01-01 /// @@ -90,7 +90,7 @@ public record LeaveEmployExpireRecord public string EffectiveDate { get; set; } = string.Empty; /// - /// 失效日期，格式"2020-01-01" + /// 失效日期，格式为yyyy-MM-dd /// 必填：是 /// 示例值：2020-01-01 /// diff --git a/src/Attendance/PatchAttendanceV1LeaveAccrualRecordByLeaveIdBodyDto.cs b/src/Attendance/PatchAttendanceV1LeaveAccrualRecordByLeaveIdBodyDto.cs index 3196241b..fade52b7 100644 --- a/src/Attendance/PatchAttendanceV1LeaveAccrualRecordByLeaveIdBodyDto.cs +++ b/src/Attendance/PatchAttendanceV1LeaveAccrualRecordByLeaveIdBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Attendance; /// /// 修改发放记录 请求体 -/// 仅可更新「发放数量」和「失效日期」 +/// 更新发放记录的发放数量和失效日期，对应假勤管理-休假管理-[发放记录](https://example.feishu.cn/people/workforce-management/manage/leave/leave_admin/granting_record) /// 接口ID：7239198678939713540 /// 文档地址：https://open.feishu.cn/document/server-docs/attendance-v1/leave_accrual_record/patch /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fattendance-v1%2fleave_accrual_record%2fpatch @@ -22,7 +22,7 @@ namespace FeishuNetSdk.Attendance; public record PatchAttendanceV1LeaveAccrualRecordByLeaveIdBodyDto { /// - /// 发放记录的唯一ID + /// 发放记录的唯一ID，可通过[创建假期发放记录](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave_granting_record/create) /// 必填：是 /// 示例值：6893014062142064135 /// @@ -30,7 +30,7 @@ public record PatchAttendanceV1LeaveAccrualRecordByLeaveIdBodyDto public string LeaveGrantingRecordId { get; set; } = string.Empty; /// - /// 员工ID + /// 员工ID，对应employee_type /// 必填：是 /// 示例值：6982509313466189342 /// @@ -38,7 +38,7 @@ public record PatchAttendanceV1LeaveAccrualRecordByLeaveIdBodyDto public string EmploymentId { get; set; } = string.Empty; /// - /// 假期类型ID + /// 假期类型ID，可通过[获取假期类型列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave/leave_types)获取 /// 必填：是 /// 示例值：7111688079785723436 /// diff --git a/src/Attendance/PatchAttendanceV1LeaveAccrualRecordByLeaveIdResponseDto.cs b/src/Attendance/PatchAttendanceV1LeaveAccrualRecordByLeaveIdResponseDto.cs index c754a6cb..21caf98c 100644 --- a/src/Attendance/PatchAttendanceV1LeaveAccrualRecordByLeaveIdResponseDto.cs +++ b/src/Attendance/PatchAttendanceV1LeaveAccrualRecordByLeaveIdResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Attendance; /// /// 修改发放记录 响应体 -/// 仅可更新「发放数量」和「失效日期」 +/// 更新发放记录的发放数量和失效日期，对应假勤管理-休假管理-[发放记录](https://example.feishu.cn/people/workforce-management/manage/leave/leave_admin/granting_record) /// 接口ID：7239198678939713540 /// 文档地址：https://open.feishu.cn/document/server-docs/attendance-v1/leave_accrual_record/patch /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fattendance-v1%2fleave_accrual_record%2fpatch @@ -42,7 +42,7 @@ public record LeaveAccrualRecord public string Id { get; set; } = string.Empty; /// - /// 员工ID + /// 员工ID，对应employee_type /// 必填：是 /// 示例值：6982509313466189342 /// @@ -74,7 +74,7 @@ public record LeaveAccrualRecord public int GrantingUnit { get; set; } /// - /// 生效日期，格式"2020-01-01" + /// 生效日期，格式为yyyy-MM-dd /// 必填：是 /// 示例值：2020-01-01 /// @@ -82,7 +82,7 @@ public record LeaveAccrualRecord public string EffectiveDate { get; set; } = string.Empty; /// - /// 失效日期，格式"2020-01-01" + /// 失效日期，格式为yyyy-MM-dd /// 必填：是 /// 示例值：2020-01-01 /// @@ -135,7 +135,7 @@ public record LangText public string CreatedAt { get; set; } = string.Empty; /// - /// 发放记录的创建人的ID + /// 发放记录的创建人的ID，对应employee_type /// 必填：是 /// 示例值：6982509313466189342 /// @@ -151,7 +151,7 @@ public record LangText public string UpdatedAt { get; set; } = string.Empty; /// - /// 发放记录的更新人的ID + /// 发放记录的更新人的ID，对应employee_type /// 必填：是 /// 示例值：6982509313466189342 /// diff --git a/src/Attendance/PostAttendanceV1GroupsBodyDto.cs b/src/Attendance/PostAttendanceV1GroupsBodyDto.cs index dbeb5c3c..1505e2d2 100644 --- a/src/Attendance/PostAttendanceV1GroupsBodyDto.cs +++ b/src/Attendance/PostAttendanceV1GroupsBodyDto.cs @@ -452,7 +452,7 @@ public record Location public int GroupType { get; set; } /// - /// 固定班制必须填，且必须填够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) 获取 /// 必填：是 /// 示例值：6921319402260496386 /// diff --git a/src/Attendance/PostAttendanceV1UserApprovalsQueryResponseDto.cs b/src/Attendance/PostAttendanceV1UserApprovalsQueryResponseDto.cs index 28a29672..0a6d5e07 100644 --- a/src/Attendance/PostAttendanceV1UserApprovalsQueryResponseDto.cs +++ b/src/Attendance/PostAttendanceV1UserApprovalsQueryResponseDto.cs @@ -93,7 +93,7 @@ public record UserOut public int Unit { get; set; } /// - /// 外出时长 + /// 关联审批单外出时长，单位为秒，与unit无关 /// 必填：是 /// 示例值：8 /// @@ -232,7 +232,7 @@ public record UserLeave public int Unit { get; set; } /// - /// 假期时长 + /// 关联审批单休假时长，单位为秒，与unit无关 /// 必填：是 /// 示例值：8 /// diff --git a/src/Attendance/PostAttendanceV1UserTaskRemedysBodyDto.cs b/src/Attendance/PostAttendanceV1UserTaskRemedysBodyDto.cs index f2b787e8..9d7ca242 100644 --- a/src/Attendance/PostAttendanceV1UserTaskRemedysBodyDto.cs +++ b/src/Attendance/PostAttendanceV1UserTaskRemedysBodyDto.cs @@ -22,7 +22,7 @@ namespace FeishuNetSdk.Attendance; public record PostAttendanceV1UserTaskRemedysBodyDto { /// - /// 用户 ID + /// 用户 ID，对应employee_type /// 必填：是 /// 示例值：abd754f7 /// @@ -30,7 +30,7 @@ public record PostAttendanceV1UserTaskRemedysBodyDto public string UserId { get; set; } = string.Empty; /// - /// 补卡日期 + /// 补卡日期，日期格式yyyyMMdd /// 必填：是 /// 示例值：20210701 /// @@ -56,7 +56,7 @@ public record PostAttendanceV1UserTaskRemedysBodyDto /// /// 补卡时间，时间格式为 yyyy-MM-dd HH:mm /// 必填：是 - /// 示例值：2021-07-0108:00 + /// 示例值：2021-07-01 08:00 /// [JsonPropertyName("remedy_time")] public string RemedyTime { get; set; } = string.Empty; @@ -70,7 +70,7 @@ public record PostAttendanceV1UserTaskRemedysBodyDto public string Reason { get; set; } = string.Empty; /// - /// 补卡时间，精确到秒的时间戳 + /// 补卡时间，精确到秒的时间戳，不填默认为0 /// 必填：否 /// 示例值：1611476284 /// diff --git a/src/Attendance/PostAttendanceV1UserTaskRemedysQueryUserAllowedRemedysBodyDto.cs b/src/Attendance/PostAttendanceV1UserTaskRemedysQueryUserAllowedRemedysBodyDto.cs index 31510b9e..96d89ce4 100644 --- a/src/Attendance/PostAttendanceV1UserTaskRemedysQueryUserAllowedRemedysBodyDto.cs +++ b/src/Attendance/PostAttendanceV1UserTaskRemedysQueryUserAllowedRemedysBodyDto.cs @@ -22,7 +22,7 @@ namespace FeishuNetSdk.Attendance; public record PostAttendanceV1UserTaskRemedysQueryUserAllowedRemedysBodyDto { /// - /// 用户 ID + /// 用户 ID，对应employee_type /// 必填：是 /// 示例值：abd754f7 /// @@ -30,7 +30,7 @@ public record PostAttendanceV1UserTaskRemedysQueryUserAllowedRemedysBodyDto public string UserId { get; set; } = string.Empty; /// - /// 补卡日期 + /// 补卡日期，格式为yyyyMMdd /// 必填：是 /// 示例值：20210104 /// diff --git a/src/Attendance/PostAttendanceV1UserTaskRemedysQueryUserAllowedRemedysResponseDto.cs b/src/Attendance/PostAttendanceV1UserTaskRemedysQueryUserAllowedRemedysResponseDto.cs index 092110f9..1e9ba4d2 100644 --- a/src/Attendance/PostAttendanceV1UserTaskRemedysQueryUserAllowedRemedysResponseDto.cs +++ b/src/Attendance/PostAttendanceV1UserTaskRemedysQueryUserAllowedRemedysResponseDto.cs @@ -34,7 +34,7 @@ public record PostAttendanceV1UserTaskRemedysQueryUserAllowedRemedysResponseDto public record UserAllowedRemedy { /// - /// 用户 ID + /// 用户 ID，对应employe_type /// 必填：是 /// 示例值：abd754f7 /// @@ -42,7 +42,7 @@ public record UserAllowedRemedy public string UserId { get; set; } = string.Empty; /// - /// 补卡日期 + /// 补卡日期，格式为yyyyMMdd /// 必填：是 /// 示例值：20210104 /// @@ -84,7 +84,7 @@ public record UserAllowedRemedy /// /// 正常的应打卡时间，时间格式为 yyyy-MM-dd HH:mm /// 必填：否 - /// 示例值：2021-07-0109:00 + /// 示例值：2021-07-01 09:00 /// [JsonPropertyName("normal_punch_time")] public string? NormalPunchTime { get; set; } @@ -92,7 +92,7 @@ public record UserAllowedRemedy /// /// 可选的补卡时间的最小值，时间格式为 yyyy-MM-dd HH:mm /// 必填：否 - /// 示例值：2021-07-0108:00 + /// 示例值：2021-07-01 08:00 /// [JsonPropertyName("remedy_start_time")] public string? RemedyStartTime { get; set; } @@ -100,7 +100,7 @@ public record UserAllowedRemedy /// /// 可选的补卡时间的最大值，时间格式为 yyyy-MM-dd HH:mm /// 必填：否 - /// 示例值：2021-07-0110:00 + /// 示例值：2021-07-01 10:00 /// [JsonPropertyName("remedy_end_time")] public string? RemedyEndTime { get; set; } diff --git a/src/Attendance/PostAttendanceV1UserTaskRemedysResponseDto.cs b/src/Attendance/PostAttendanceV1UserTaskRemedysResponseDto.cs index 764d54c5..66383854 100644 --- a/src/Attendance/PostAttendanceV1UserTaskRemedysResponseDto.cs +++ b/src/Attendance/PostAttendanceV1UserTaskRemedysResponseDto.cs @@ -34,7 +34,7 @@ public record PostAttendanceV1UserTaskRemedysResponseDto public record UserTaskRemedy { /// - /// 用户 ID + /// 用户 ID，对应employee_type /// 必填：是 /// 示例值：abd754f7 /// @@ -42,7 +42,7 @@ public record UserTaskRemedy public string UserId { get; set; } = string.Empty; /// - /// 补卡日期 + /// 补卡日期，日期格式yyyyMMdd /// 必填：是 /// 示例值：20210701 /// @@ -66,7 +66,7 @@ public record UserTaskRemedy public int WorkType { get; set; } /// - /// 审批 ID + /// 审批 ID，可用于[通知审批状态更新](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/approval_info/process) /// 必填：否 /// 示例值：6737202939523236113 /// @@ -76,7 +76,7 @@ public record UserTaskRemedy /// /// 补卡时间，时间格式为 yyyy-MM-dd HH:mm /// 必填：是 - /// 示例值：2021-07-0108:00 + /// 示例值：2021-07-01 08:00 /// [JsonPropertyName("remedy_time")] public string RemedyTime { get; set; } = string.Empty; diff --git a/src/Attendance/PutAttendanceV1UserStatsViewsByUserStatsViewIdBodyDto.cs b/src/Attendance/PutAttendanceV1UserStatsViewsByUserStatsViewIdBodyDto.cs index a083590e..87bbdbb3 100644 --- a/src/Attendance/PutAttendanceV1UserStatsViewsByUserStatsViewIdBodyDto.cs +++ b/src/Attendance/PutAttendanceV1UserStatsViewsByUserStatsViewIdBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Attendance; /// /// 更新统计设置 请求体 -/// 更新开发者定制的日度统计或月度统计的统计报表表头设置信息。 +/// 更新开发者定制的日度统计或月度统计的统计报表表头设置信息。报表的表头信息可以在考勤统计-[报表](https://example.feishu.cn/people/workforce-management/manage/statistics/report)中查询到具体的报表信息，此接口专门用于更新表头信息。 /// 接口ID：7044467124773650433 /// 文档地址：https://open.feishu.cn/document/server-docs/attendance-v1/user_stats_data/update /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fattendance-v1%2fuser_stats_view%2fupdate @@ -34,7 +34,7 @@ public record PutAttendanceV1UserStatsViewsByUserStatsViewIdBodyDto public record UserStatsView { /// - /// 视图 ID + /// 视图 ID，可通过[查询统计设置](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_stats_view/query)获取 /// 必填：是 /// 示例值：TmpZNU5qTTJORFF6T1RnNU5UTTNOakV6TWl0dGIyNTBhQT09 /// @@ -54,7 +54,7 @@ public record UserStatsView public string StatsType { get; set; } = string.Empty; /// - /// 操作者的用户id + /// 操作者的用户id，对应employee_type /// 必填：是 /// 示例值：ec8ddg56 /// @@ -102,7 +102,7 @@ public record ChildItem public string Code { get; set; } = string.Empty; /// - /// 开关字段，0：关闭，1：开启（非开关字段场景：code = 51501 可选值为1-6） + /// 开关字段，0：关闭，1：开启 /// 必填：是 /// 示例值：0 /// diff --git a/src/Attendance/PutAttendanceV1UserStatsViewsByUserStatsViewIdResponseDto.cs b/src/Attendance/PutAttendanceV1UserStatsViewsByUserStatsViewIdResponseDto.cs index c233c112..81191cb7 100644 --- a/src/Attendance/PutAttendanceV1UserStatsViewsByUserStatsViewIdResponseDto.cs +++ b/src/Attendance/PutAttendanceV1UserStatsViewsByUserStatsViewIdResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Attendance; /// /// 更新统计设置 响应体 -/// 更新开发者定制的日度统计或月度统计的统计报表表头设置信息。 +/// 更新开发者定制的日度统计或月度统计的统计报表表头设置信息。报表的表头信息可以在考勤统计-[报表](https://example.feishu.cn/people/workforce-management/manage/statistics/report)中查询到具体的报表信息，此接口专门用于更新表头信息。 /// 接口ID：7044467124773650433 /// 文档地址：https://open.feishu.cn/document/server-docs/attendance-v1/user_stats_data/update /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fattendance-v1%2fuser_stats_view%2fupdate @@ -54,7 +54,7 @@ public record UserStatsView public string StatsType { get; set; } = string.Empty; /// - /// 操作者的用户id + /// 操作者的用户id，对应employee_type /// 必填：是 /// 示例值：ec8ddg56 /// @@ -110,7 +110,7 @@ public record ChildItem public string Code { get; set; } = string.Empty; /// - /// 开关字段，0：关闭，1：开启（非开关字段场景：code = 51501 可选值为1-6） + /// 开关字段，0：关闭，1：开启 /// 必填：是 /// 示例值：0 /// diff --git a/src/Contact/PatchContactV3UsersByUserIdBodyDto.cs b/src/Contact/PatchContactV3UsersByUserIdBodyDto.cs index 4559f92e..2db53a38 100644 --- a/src/Contact/PatchContactV3UsersByUserIdBodyDto.cs +++ b/src/Contact/PatchContactV3UsersByUserIdBodyDto.cs @@ -127,7 +127,7 @@ public record PatchContactV3UsersByUserIdBodyDto /// /// 工作城市。字符长度上限为 100。 /// - 调用[获取租户工作城市列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/work_city/list)获取当前租户内已有的工作城市列表。 - /// - 如果你传入的工作城市名称不存在，则系统会自动生成该工作城市。 + /// - 如果你传入的工作城市名称不存在，则系统会自动生成该工作城市。工作城市的枚举值数量上限为 10,000。 /// 必填：否 /// 示例值：杭州 /// @@ -361,9 +361,9 @@ public record CustomAttrGenericUser public string? EnterpriseEmail { get; set; } /// - /// 职务名称。 + /// 职务名称。字符数量上限为 255。 /// - 你可以调用[获取租户职务列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/job_title/list)接口获取相应的租户名称。 - /// - 如果传入的职务名称不存在，则系统会自动创建并使用该名称。 + /// - 如果传入的职务名称不存在，则系统会自动创建并使用该名称。职务枚举值数量上限为 10,000。 /// 必填：否 /// 示例值：xxxxx /// diff --git a/src/Contact/PostContactV3UsersBodyDto.cs b/src/Contact/PostContactV3UsersBodyDto.cs index 69c77e59..e8660385 100644 --- a/src/Contact/PostContactV3UsersBodyDto.cs +++ b/src/Contact/PostContactV3UsersBodyDto.cs @@ -145,7 +145,7 @@ public record PostContactV3UsersBodyDto /// 工作城市。字符长度上限为 100。 /// **说明**： /// - 你可以调用[获取租户工作城市列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/work_city/list)接口获取当前租户内已有的工作城市名称。 - /// - 如果你传入的工作城市名称不存在，则系统会自动生成该工作城市。 + /// - 如果你传入的工作城市名称不存在，则系统会自动生成该工作城市。工作城市的枚举值数量上限为 10,000。 /// **默认值**：空 /// 必填：否 /// 示例值：杭州 @@ -394,9 +394,9 @@ public record CustomAttrGenericUser public string? EnterpriseEmail { get; set; } /// - /// 职务名称。 + /// 职务名称。字符数量上限为 255。 /// - 你可以调用[获取租户职务列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/job_title/list)接口获取相应的职务名称。 - /// - 如果传入的职务名称不存在，则系统会自动创建并使用该名称。 + /// - 如果传入的职务名称不存在，则系统会自动创建并使用该名称。职务枚举值数量上限为 10,000。 /// **默认值**：空 /// 必填：否 /// 示例值：xxxxx diff --git a/src/Corehr/PatchCorehrV2PersonsByPersonIdBodyDto.cs b/src/Corehr/PatchCorehrV2PersonsByPersonIdBodyDto.cs index 7e226237..7733ff13 100644 --- a/src/Corehr/PatchCorehrV2PersonsByPersonIdBodyDto.cs +++ b/src/Corehr/PatchCorehrV2PersonsByPersonIdBodyDto.cs @@ -4,7 +4,7 @@ // Created : 2024-06-24 // // Last Modified By : yxr -// Last Modified On : 2024-06-24 +// Last Modified On : 2024-08-07 // ************************************************************************ // // MIT @@ -245,14 +245,6 @@ public record Enum [JsonPropertyName("date_of_birth")] public string? DateOfBirth { get; set; } - /// - /// 国籍 ID，可通过[【查询国籍信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-nationality/search)接口查询 - /// 必填：否 - /// 示例值：6862995757234914821 - /// - [JsonPropertyName("nationality_id_v2")] - public string? NationalityIdV2 { get; set; } - /// /// 民族 / 种族，可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)获取，按如下参数查询即可： /// - custom_api_name：ethnicity_race @@ -665,7 +657,7 @@ public record WorkExperienceInfo public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -673,9 +665,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -773,7 +765,7 @@ public record Education public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -781,9 +773,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -1657,6 +1649,7 @@ public record EmergencyContact { /// /// 姓名 + /// - 该字段已弃用，请使用 legal_name /// 必填：否 /// [JsonPropertyName("name")] @@ -1664,6 +1657,7 @@ public record EmergencyContact /// /// 姓名 + /// - 该字段已弃用，请使用 legal_name /// public record PersonName { @@ -1920,6 +1914,35 @@ public record Enum /// [JsonPropertyName("legal_name")] public string? LegalName { get; set; } + + /// + /// 自定义字段 + /// 必填：否 + /// + [JsonPropertyName("custom_fields")] + public CustomFieldData[]? CustomFields { get; set; } + + /// + /// 自定义字段 + /// + public record CustomFieldData + { + /// + /// 自定义字段 apiname，即自定义字段的唯一标识 + /// 必填：是 + /// 示例值：name + /// + [JsonPropertyName("custom_api_name")] + public string CustomApiName { get; set; } = string.Empty; + + /// + /// 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考[【操作手册】如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7) + /// 必填：是 + /// 示例值：\"231\" + /// + [JsonPropertyName("value")] + public string Value { get; set; } = string.Empty; + } } /// @@ -2187,7 +2210,7 @@ public record ObjectFieldData public string FieldName { get; set; } = string.Empty; /// - /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(123, 123.23, true, [\"id1\",\"id2\], 2006-01-02 15:04:05]) + /// 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考[【操作手册】如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7) /// 必填：是 /// 示例值：Sandy /// diff --git a/src/Corehr/PatchCorehrV2PersonsByPersonIdResponseDto.cs b/src/Corehr/PatchCorehrV2PersonsByPersonIdResponseDto.cs index 3048e4d3..5127fc62 100644 --- a/src/Corehr/PatchCorehrV2PersonsByPersonIdResponseDto.cs +++ b/src/Corehr/PatchCorehrV2PersonsByPersonIdResponseDto.cs @@ -4,7 +4,7 @@ // Created : 2024-06-24 // // Last Modified By : yxr -// Last Modified On : 2024-06-24 +// Last Modified On : 2024-08-07 // ************************************************************************ // // MIT @@ -150,7 +150,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -158,9 +158,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -362,7 +362,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -370,9 +370,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -387,14 +387,6 @@ public record I18n [JsonPropertyName("date_of_birth")] public string? DateOfBirth { get; set; } - /// - /// 国籍 ID，可通过[【查询国籍信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-nationality/search)获取 - /// 必填：否 - /// 示例值：6862995757234914821 - /// - [JsonPropertyName("nationality_id_v2")] - public string? NationalityIdV2 { get; set; } - /// /// 民族 / 种族，可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)获取，按如下参数查询即可： /// - custom_api_name：ethnicity_race @@ -462,7 +454,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -470,9 +462,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -763,7 +755,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -771,9 +763,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -932,7 +924,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -940,9 +932,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -975,7 +967,7 @@ public record WorkExperienceInfo public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -983,9 +975,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -1120,7 +1112,7 @@ public record Education public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -1128,9 +1120,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -1169,7 +1161,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -1177,9 +1169,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -1418,7 +1410,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -1426,9 +1418,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -1725,7 +1717,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -1733,9 +1725,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -1933,7 +1925,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -1941,9 +1933,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -2266,7 +2258,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -2274,9 +2266,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -2567,7 +2559,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -2575,9 +2567,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -2778,7 +2770,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -2786,9 +2778,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -2986,7 +2978,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -2994,9 +2986,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -3052,7 +3044,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -3060,9 +3052,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -3301,7 +3293,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -3309,9 +3301,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -3568,7 +3560,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -3576,9 +3568,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; diff --git a/src/Corehr/PostCorehrV2PersonsBodyDto.cs b/src/Corehr/PostCorehrV2PersonsBodyDto.cs index 903ab608..ff18d11d 100644 --- a/src/Corehr/PostCorehrV2PersonsBodyDto.cs +++ b/src/Corehr/PostCorehrV2PersonsBodyDto.cs @@ -4,7 +4,7 @@ // Created : 2024-06-24 // // Last Modified By : yxr -// Last Modified On : 2024-06-24 +// Last Modified On : 2024-08-07 // ************************************************************************ // // MIT @@ -217,7 +217,7 @@ public record Enum } /// - /// 性别，枚举值 api_name 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： + /// 性别，枚举值可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： /// - object_api_name = "person" /// - custom_api_name = "gender" /// 字段权限要求： @@ -228,7 +228,7 @@ public record Enum public Enum? Gender { get; set; } /// - /// 性别，枚举值 api_name 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： + /// 性别，枚举值可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： /// - object_api_name = "person" /// - custom_api_name = "gender" /// 字段权限要求： @@ -255,14 +255,6 @@ public record Enum [JsonPropertyName("date_of_birth")] public string? DateOfBirth { get; set; } - /// - /// 国籍 ID，可通过[【查询国籍信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-nationality/search)接口查询 - /// 必填：否 - /// 示例值：6862995757234914821 - /// - [JsonPropertyName("nationality_id_v2")] - public string? NationalityIdV2 { get; set; } - /// /// 民族 / 种族，枚举值 api_name 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： /// - object_api_name = "person" @@ -685,7 +677,7 @@ public record WorkExperienceInfo public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -693,9 +685,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -797,7 +789,7 @@ public record Education public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -805,9 +797,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -1198,7 +1190,9 @@ public record Enum } /// - /// 性别，可通过[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)性别（gender）枚举定义获得 + /// 性别，枚举值可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： + /// - object_api_name = "person" + /// - custom_api_name = "gender" /// 必填：否 /// [JsonPropertyName("gender")] @@ -1692,6 +1686,7 @@ public record EmergencyContact { /// /// 姓名 + /// - 该字段已废弃，请使用 legal_name /// 必填：否 /// [JsonPropertyName("name")] @@ -1699,6 +1694,7 @@ public record EmergencyContact /// /// 姓名 + /// - 该字段已废弃，请使用 legal_name /// public record PersonName { @@ -1955,6 +1951,35 @@ public record Enum /// [JsonPropertyName("legal_name")] public string? LegalName { get; set; } + + /// + /// 自定义字段 + /// 必填：否 + /// + [JsonPropertyName("custom_fields")] + public CustomFieldData[]? CustomFields { get; set; } + + /// + /// 自定义字段 + /// + public record CustomFieldData + { + /// + /// 自定义字段 apiname，即自定义字段的唯一标识 + /// 必填：是 + /// 示例值：name + /// + [JsonPropertyName("custom_api_name")] + public string CustomApiName { get; set; } = string.Empty; + + /// + /// 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考[【操作手册】如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7) + /// 必填：是 + /// 示例值：\"231\" + /// + [JsonPropertyName("value")] + public string Value { get; set; } = string.Empty; + } } /// @@ -2181,14 +2206,18 @@ public record ResidentTax public string YearResidentTax { get; set; } = string.Empty; /// - /// 居民身份，枚举值 api_name 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： - object_api_name = "resident_tax" - custom_api_name = "resident_status" + /// 居民身份，枚举值可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： + /// - object_api_name = "resident_tax" + /// - custom_api_name = "resident_status" /// 必填：否 /// [JsonPropertyName("resident_status")] public Enum? ResidentStatus { get; set; } /// - /// 居民身份，枚举值 api_name 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： - object_api_name = "resident_tax" - custom_api_name = "resident_status" + /// 居民身份，枚举值可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： + /// - object_api_name = "resident_tax" + /// - custom_api_name = "resident_status" /// public record Enum { @@ -2230,7 +2259,7 @@ public record ObjectFieldData public string FieldName { get; set; } = string.Empty; /// - /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(123, 123.23, true, [\"id1\",\"id2\], 2006-01-02 15:04:05]) + /// 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考[【操作手册】如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7) /// 必填：是 /// 示例值：Sandy /// diff --git a/src/Corehr/PostCorehrV2PersonsResponseDto.cs b/src/Corehr/PostCorehrV2PersonsResponseDto.cs index 6113f097..f897d460 100644 --- a/src/Corehr/PostCorehrV2PersonsResponseDto.cs +++ b/src/Corehr/PostCorehrV2PersonsResponseDto.cs @@ -4,7 +4,7 @@ // Created : 2024-06-24 // // Last Modified By : yxr -// Last Modified On : 2024-06-24 +// Last Modified On : 2024-08-07 // ************************************************************************ // // MIT @@ -150,7 +150,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -158,9 +158,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -326,14 +326,18 @@ public record I18n } /// - /// 性别，枚举值可查询[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可： - custom_api_name：gender - object_api_name：person + /// 性别，枚举值可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： + /// - object_api_name = "person" + /// - custom_api_name = "gender" /// 必填：否 /// [JsonPropertyName("gender")] public Enum? Gender { get; set; } /// - /// 性别，枚举值可查询[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可： - custom_api_name：gender - object_api_name：person + /// 性别，枚举值可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： + /// - object_api_name = "person" + /// - custom_api_name = "gender" /// public record Enum { @@ -358,7 +362,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -366,9 +370,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -383,14 +387,6 @@ public record I18n [JsonPropertyName("date_of_birth")] public string? DateOfBirth { get; set; } - /// - /// 国籍 ID，可通过[【查询国籍信息】](/ssl:ttdo/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-nationality/search)接口查询 - /// 必填：否 - /// 示例值：6862995757234914821 - /// - [JsonPropertyName("nationality_id_v2")] - public string? NationalityIdV2 { get; set; } - /// /// 民族 / 种族，枚举值 api_name 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： /// - object_api_name = "person" @@ -460,7 +456,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -468,9 +464,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -761,7 +757,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -769,9 +765,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -930,7 +926,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -938,9 +934,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -973,7 +969,7 @@ public record WorkExperienceInfo public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -981,9 +977,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -1118,7 +1114,7 @@ public record Education public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -1126,9 +1122,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -1167,7 +1163,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -1175,9 +1171,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -1416,7 +1412,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -1424,9 +1420,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -1723,7 +1719,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -1731,9 +1727,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -1931,7 +1927,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -1939,9 +1935,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -1949,9 +1945,9 @@ public record I18n } /// - /// 性别，枚举值可查询[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可： - /// - custom_api_name：gender - /// - object_api_name：person + /// 性别，枚举值可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： + /// - object_api_name = "person" + /// - custom_api_name = "gender" /// 必填：否 /// [JsonPropertyName("gender")] @@ -2260,7 +2256,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -2268,9 +2264,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -2564,7 +2560,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -2572,9 +2568,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -2775,7 +2771,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -2783,9 +2779,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -2983,7 +2979,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -2991,9 +2987,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -3049,7 +3045,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -3057,9 +3053,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -3298,7 +3294,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -3306,9 +3302,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -3560,7 +3556,7 @@ public record Enum public record I18n { /// - /// 语言 + /// 语言编码（IETF BCP 47） /// 必填：是 /// 示例值：zh-CN /// @@ -3568,9 +3564,9 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 内容 + /// 文本内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：中文示例 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -3630,5 +3626,13 @@ public record ObjectFieldData /// [JsonPropertyName("leave_time")] public string? LeaveTime { get; set; } + + /// + /// 护照号码 + /// 必填：否 + /// 示例值：6919733936050406926 + /// + [JsonPropertyName("passport_number")] + public string? PassportNumber { get; set; } } } diff --git a/src/FeishuNetSdk.csproj b/src/FeishuNetSdk.csproj index 4805f56d..7c26f0e6 100644 --- a/src/FeishuNetSdk.csproj +++ b/src/FeishuNetSdk.csproj @@ -16,7 +16,7 @@ MIT 适用于飞书开放平台的.Net开发包 LICENSE - 2.4.1 + 2.4.2 diff --git a/src/FeishuPeople/GetCorehrV1ProcessesByProcessIdFormVariableDataResponseDto.cs b/src/FeishuPeople/GetCorehrV1ProcessesByProcessIdFormVariableDataResponseDto.cs index 1f48241c..865a5403 100644 --- a/src/FeishuPeople/GetCorehrV1ProcessesByProcessIdFormVariableDataResponseDto.cs +++ b/src/FeishuPeople/GetCorehrV1ProcessesByProcessIdFormVariableDataResponseDto.cs @@ -4,7 +4,7 @@ // Created : 2024-06-24 // // Last Modified By : yxr -// Last Modified On : 2024-06-24 +// Last Modified On : 2024-08-07 // ************************************************************************ // // MIT @@ -192,7 +192,7 @@ public record FormFieldVariableDatetimeValue /// 示例值：1670227428803 /// [JsonPropertyName("value")] - public int? Value { get; set; } + public long? Value { get; set; } /// /// 时区，+08:00 @@ -567,7 +567,7 @@ public record FormFieldVariableDatetimeValue /// 示例值：1670227428803 /// [JsonPropertyName("value")] - public int? Value { get; set; } + public long? Value { get; set; } /// /// 时区，+08:00 diff --git a/src/FeishuPeople/PatchCorehrV1JobDatasByJobDataIdBodyDto.cs b/src/FeishuPeople/PatchCorehrV1JobDatasByJobDataIdBodyDto.cs index 7ed7bd7a..f1e406ff 100644 --- a/src/FeishuPeople/PatchCorehrV1JobDatasByJobDataIdBodyDto.cs +++ b/src/FeishuPeople/PatchCorehrV1JobDatasByJobDataIdBodyDto.cs @@ -4,7 +4,7 @@ // Created : 2024-06-24 // // Last Modified By : yxr -// Last Modified On : 2024-06-24 +// Last Modified On : 2024-08-07 // ************************************************************************ // // MIT @@ -14,7 +14,7 @@ namespace FeishuNetSdk.FeishuPeople; /// /// 更新任职信息 请求体 -/// 更新任职信息 +/// 默认为新增一条任职记录，包括职务、职级、序列、部门等信息。 /// 接口ID：7072642400195723292 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/employee/job_data/patch /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fcorehr-v1%2fjob_data%2fpatch @@ -74,7 +74,7 @@ public record PatchCorehrV1JobDatasByJobDataIdBodyDto /// /// 部门 ID，枚举值及详细信息可通过[【批量查询部门】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get)接口查询获得 - /// 与 department_id_type 类型一致 + /// - 与 department_id_type 类型一致 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -91,6 +91,7 @@ public record PatchCorehrV1JobDatasByJobDataIdBodyDto /// /// 试用期开始日期 + /// - strict_verify 为 true 时不支持该字段 /// 必填：否 /// 示例值：2018-03-16 /// @@ -99,6 +100,7 @@ public record PatchCorehrV1JobDatasByJobDataIdBodyDto /// /// 试用期结束日期（实际结束日期） + /// - strict_verify 为 true 时不支持该字段 /// 必填：否 /// 示例值：2019-05-24 /// @@ -107,23 +109,16 @@ public record PatchCorehrV1JobDatasByJobDataIdBodyDto /// /// 是否为主任职 + /// - 只允许传 true，故此字段即将废弃 /// 必填：否 /// 示例值：true /// [JsonPropertyName("primary_job_data")] public bool? PrimaryJobData { get; set; } - /// - /// 雇佣 ID，详细信息可以通过[【搜索员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search)接口查询获得 - /// 与 user_id_type 类型一致 - /// 必填：否 - /// 示例值：6893014062142064135 - /// - [JsonPropertyName("employment_id")] - public string? EmploymentId { get; set; } - /// /// 生效时间 + /// - 不可为空字符，不传时默认值为当天 /// 必填：否 /// 示例值：2020-05-01 00:00:00 /// @@ -132,6 +127,7 @@ public record PatchCorehrV1JobDatasByJobDataIdBodyDto /// /// 失效时间 + /// - strict_verify 为 true 时不支持该字段 /// 必填：否 /// 示例值：2020-05-02 00:00:00 /// @@ -147,7 +143,7 @@ public record PatchCorehrV1JobDatasByJobDataIdBodyDto public string? JobFamilyId { get; set; } /// - /// 任职原因，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 任职原因（assignment_start_reason）枚举定义部分获得。请注意，「任职原因」不允许填写为「onboarding」，当上一个任职版本的「任职原因」为「onboarding」时，「任职原因」必填。 + /// 任职原因，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 任职原因（assignment_start_reason）枚举定义部分获得。请注意，「任职原因」不允许填写为「onboarding、offboarding」，当上一个任职版本的「任职原因」为「onboarding」时，「任职原因」必填。 /// 必填：否 /// 示例值：onboarding /// @@ -155,7 +151,7 @@ public record PatchCorehrV1JobDatasByJobDataIdBodyDto public Enum? AssignmentStartReason { get; set; } /// - /// 任职原因，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 任职原因（assignment_start_reason）枚举定义部分获得。请注意，「任职原因」不允许填写为「onboarding」，当上一个任职版本的「任职原因」为「onboarding」时，「任职原因」必填。 + /// 任职原因，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 任职原因（assignment_start_reason）枚举定义部分获得。请注意，「任职原因」不允许填写为「onboarding、offboarding」，当上一个任职版本的「任职原因」为「onboarding」时，「任职原因」必填。 /// public record Enum { @@ -170,6 +166,7 @@ public record Enum /// /// 预计试用期结束日期 + /// - strict_verify 为 true 时不支持该字段 /// 必填：否 /// 示例值：2006-01-02 /// @@ -194,6 +191,7 @@ public record Enum /// /// 第二直属上级的任职记录 ID，详细信息可通过[【批量查询员工任职信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employees-job_data/batch_get)接口查询获得 + /// - strict_verify 为 true 时不支持该字段 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -202,7 +200,7 @@ public record Enum /// /// 成本中心分摊信息 - /// 当 version_id 不为空时，暂不支持更新该字段值 + /// - 当 version_id 不为空时，暂不支持更新该字段值 /// 必填：否 /// [JsonPropertyName("cost_center_rate")] @@ -210,7 +208,7 @@ public record Enum /// /// 成本中心分摊信息 - /// 当 version_id 不为空时，暂不支持更新该字段值 + /// - 当 version_id 不为空时，暂不支持更新该字段值 /// public record SupportCostCenterItem { diff --git a/src/FeishuPeople/PatchCorehrV1JobDatasByJobDataIdResponseDto.cs b/src/FeishuPeople/PatchCorehrV1JobDatasByJobDataIdResponseDto.cs index e865bcf9..a6e84e68 100644 --- a/src/FeishuPeople/PatchCorehrV1JobDatasByJobDataIdResponseDto.cs +++ b/src/FeishuPeople/PatchCorehrV1JobDatasByJobDataIdResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.FeishuPeople; /// /// 更新任职信息 响应体 -/// 更新任职信息 +/// 默认为新增一条任职记录，包括职务、职级、序列、部门等信息。 /// 接口ID：7072642400195723292 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/employee/job_data/patch /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fcorehr-v1%2fjob_data%2fpatch diff --git a/src/FeishuPeople/PostCorehrV1LeaveGrantingRecordsBodyDto.cs b/src/FeishuPeople/PostCorehrV1LeaveGrantingRecordsBodyDto.cs index 83ae325e..8a7e0512 100644 --- a/src/FeishuPeople/PostCorehrV1LeaveGrantingRecordsBodyDto.cs +++ b/src/FeishuPeople/PostCorehrV1LeaveGrantingRecordsBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.FeishuPeople; /// /// 创建假期发放记录 请求体 -/// 向飞书人事休假系统写入假期发放记录。 +/// 向飞书人事休假系统写入假期发放记录。对应假勤管理-休假管理-[发放记录](https://example.feishu.cn/people/workforce-management/manage/leave/leave_admin/granting_record)的创建或者导入功能 /// 接口ID：7127187941650612227 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/leave/create /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fcorehr-v1%2fleave_granting_record%2fcreate @@ -30,7 +30,7 @@ public record PostCorehrV1LeaveGrantingRecordsBodyDto public string LeaveTypeId { get; set; } = string.Empty; /// - /// 员工 ID，飞书人事的雇员id + /// 员工 ID，飞书人事的雇员id。对应user_id_type /// 必填：是 /// 示例值：6982509313466189342 /// @@ -57,7 +57,7 @@ public record PostCorehrV1LeaveGrantingRecordsBodyDto public int GrantingUnit { get; set; } /// - /// 生效时间 + /// 生效时间，格式为yyyy-MM-dd /// 必填：是 /// 示例值：2022-01-01 /// @@ -65,7 +65,7 @@ public record PostCorehrV1LeaveGrantingRecordsBodyDto public string EffectiveDate { get; set; } = string.Empty; /// - /// 失效时间 + /// 失效时间，格式为yyyy-MM-dd /// 必填：否 /// 示例值：2022-01-01 /// @@ -73,7 +73,7 @@ public record PostCorehrV1LeaveGrantingRecordsBodyDto public string? ExpirationDate { get; set; } /// - /// 是否参与折算（1不参与折算，2参与折算） + /// 是否参与折算（1不参与折算，2参与折算）。默认不折算 /// 必填：否 /// 示例值：1 /// diff --git a/src/FeishuPeople/PostCorehrV1LeaveGrantingRecordsResponseDto.cs b/src/FeishuPeople/PostCorehrV1LeaveGrantingRecordsResponseDto.cs index b543a845..34b60e03 100644 --- a/src/FeishuPeople/PostCorehrV1LeaveGrantingRecordsResponseDto.cs +++ b/src/FeishuPeople/PostCorehrV1LeaveGrantingRecordsResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.FeishuPeople; /// /// 创建假期发放记录 响应体 -/// 向飞书人事休假系统写入假期发放记录。 +/// 向飞书人事休假系统写入假期发放记录。对应假勤管理-休假管理-[发放记录](https://example.feishu.cn/people/workforce-management/manage/leave/leave_admin/granting_record)的创建或者导入功能 /// 接口ID：7127187941650612227 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/leave/create /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fcorehr-v1%2fleave_granting_record%2fcreate @@ -34,7 +34,7 @@ public record PostCorehrV1LeaveGrantingRecordsResponseDto public record PostCorehrV1LeaveGrantingRecordsResponseDtoLeaveGrantingRecord { /// - /// 假期发放记录 ID + /// 假期发放记录 ID，可用与[删除假期发放记录](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave_granting_record/delete)和[修改发放记录](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/leave_accrual_record/patch) /// 必填：是 /// 示例值：6893014062142064135 /// @@ -42,7 +42,7 @@ public record PostCorehrV1LeaveGrantingRecordsResponseDtoLeaveGrantingRecord public string Id { get; set; } = string.Empty; /// - /// 员工 ID + /// 员工 ID，对应user_id_type /// 必填：是 /// 示例值：6893014062142064135 /// @@ -77,7 +77,7 @@ public record PostCorehrV1LeaveGrantingRecordsResponseDtoLeaveGrantingRecord public int GrantingUnit { get; set; } /// - /// 生效时间 + /// 生效时间，格式为yyyy-MM-dd /// 必填：是 /// 示例值：2022-01-01 /// @@ -85,7 +85,7 @@ public record PostCorehrV1LeaveGrantingRecordsResponseDtoLeaveGrantingRecord public string EffectiveDate { get; set; } = string.Empty; /// - /// 失效时间（根据休假规则自动计算） + /// 失效时间（根据休假规则自动计算），格式为yyyy-MM-dd /// 必填：是 /// 示例值：2022-01-01 /// @@ -134,7 +134,7 @@ public record I18n } /// - /// 发放记录的创建时间 + /// 发放记录的创建时间，格式为时间戳 /// 必填：是 /// 示例值：1608725989000 /// @@ -142,7 +142,7 @@ public record I18n public string CreatedAt { get; set; } = string.Empty; /// - /// 发放记录的创建人，值为创建人的员工 ID + /// 发放记录的创建人，值为创建人的员工 ID，对应user_id_type /// 必填：是 /// 示例值：646465654545 /// @@ -150,7 +150,7 @@ public record I18n public string CreatedBy { get; set; } = string.Empty; /// - /// 发放记录的更新时间 + /// 发放记录的更新时间，格式为时间戳 /// 必填：是 /// 示例值：1608725989000 /// @@ -158,7 +158,7 @@ public record I18n public string UpdatedAt { get; set; } = string.Empty; /// - /// 发放记录的更新人，值为更新人的员工 ID + /// 发放记录的更新人，值为更新人的员工 ID，对应user_id_type /// 必填：是 /// 示例值：646465654545 /// @@ -166,7 +166,7 @@ public record I18n public string UpdatedBy { get; set; } = string.Empty; /// - /// 是否参与折算 + /// 是否参与折算（1不参与折算，2参与折算） /// 必填：否 /// 示例值：1 /// diff --git a/src/Hire/GetHireV1AgenciesByAgencyIdResponseDto.cs b/src/Hire/GetHireV1AgenciesByAgencyIdResponseDto.cs index 114aaade..e80f9ed8 100644 --- a/src/Hire/GetHireV1AgenciesByAgencyIdResponseDto.cs +++ b/src/Hire/GetHireV1AgenciesByAgencyIdResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 获取猎头供应商信息 响应体 -/// 根据猎头供应商 ID 获取猎头供应商信息。 +/// 根据猎头供应商 ID 获取有合作关系的猎头供应商信息，包含猎头供应商ID、名称、联系人等。 /// 接口ID：6965472560995057666 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/get-candidates/agency/get /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2fagency%2fget @@ -22,14 +22,14 @@ namespace FeishuNetSdk.Hire; public record GetHireV1AgenciesByAgencyIdResponseDto { /// - /// 数据 + /// 猎头供应商信息 /// 必填：否 /// [JsonPropertyName("agency")] public GetHireV1AgenciesByAgencyIdResponseDtoAgency? Agency { get; set; } /// - /// 数据 + /// 猎头供应商信息 /// public record GetHireV1AgenciesByAgencyIdResponseDtoAgency { @@ -50,7 +50,7 @@ public record GetHireV1AgenciesByAgencyIdResponseDtoAgency public string? Name { get; set; } /// - /// 供应商联系人唯一标识 + /// 供应商联系人，与`user_id_type`类型一致 /// 必填：否 /// 示例值：ou_f476cb099ac9227c9bae09ce46112579 /// @@ -70,17 +70,17 @@ public record GetHireV1AgenciesByAgencyIdResponseDtoAgency public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：张三 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：zhangsan /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } diff --git a/src/Hire/GetHireV1AgenciesQueryResponseDto.cs b/src/Hire/GetHireV1AgenciesQueryResponseDto.cs index 67eb0e88..46f87813 100644 --- a/src/Hire/GetHireV1AgenciesQueryResponseDto.cs +++ b/src/Hire/GetHireV1AgenciesQueryResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 查询猎头供应商信息 响应体 -/// 根据猎头供应商名称查询猎头供应商信息。 +/// 根据猎头供应商名称查询有合作关系的猎头供应商信息，包含猎头供应商ID、名称、联系人等。 /// 接口ID：6965472560995074050 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/get-candidates/agency/query /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2fagency%2fquery @@ -22,14 +22,14 @@ namespace FeishuNetSdk.Hire; public record GetHireV1AgenciesQueryResponseDto { /// - /// 数据 + /// 猎头供应商信息 /// 必填：否 /// [JsonPropertyName("items")] public Agency[]? Items { get; set; } /// - /// 数据 + /// 猎头供应商信息 /// public record Agency { @@ -50,7 +50,7 @@ public record Agency public string? Name { get; set; } /// - /// 供应商联系人唯一标识 + /// 猎头供应商联系人ID，与`user_id_type`类型一致 /// 必填：否 /// 示例值：ou_f476cb099ac9227c9bae09ce46112579 /// @@ -58,29 +58,29 @@ public record Agency public string? ContactorId { get; set; } /// - /// 供应商联系人名称 + /// 猎头供应商联系人名称 /// 必填：否 /// [JsonPropertyName("contactor_name")] public I18n? ContactorName { get; set; } /// - /// 供应商联系人名称 + /// 猎头供应商联系人名称 /// public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：张三 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：zhangsan /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } diff --git a/src/Hire/GetHireV1ApplicationsByApplicationIdOfferResponseDto.cs b/src/Hire/GetHireV1ApplicationsByApplicationIdOfferResponseDto.cs index 5b3e1284..9103bf72 100644 --- a/src/Hire/GetHireV1ApplicationsByApplicationIdOfferResponseDto.cs +++ b/src/Hire/GetHireV1ApplicationsByApplicationIdOfferResponseDto.cs @@ -161,7 +161,7 @@ public record BaseBilingualWithId public string? LeaderUserId { get; set; } /// - /// 入职日期 + /// 入职日期，格式为YYYY-MM-DD /// 必填：否 /// 示例值：2021-05-20 /// diff --git a/src/Hire/GetHireV1EmployeesByEmployeeIdResponseDto.cs b/src/Hire/GetHireV1EmployeesByEmployeeIdResponseDto.cs index 814c66c1..8c12bf91 100644 --- a/src/Hire/GetHireV1EmployeesByEmployeeIdResponseDto.cs +++ b/src/Hire/GetHireV1EmployeesByEmployeeIdResponseDto.cs @@ -4,7 +4,7 @@ // Created : 2024-06-24 // // Last Modified By : yxr -// Last Modified On : 2024-06-24 +// Last Modified On : 2024-08-07 // ************************************************************************ // // MIT @@ -79,7 +79,7 @@ public record GetHireV1EmployeesByEmployeeIdResponseDtoEmployee /// 示例值：1637596800000 /// [JsonPropertyName("onboard_time")] - public int? OnboardTime { get; set; } + public long? OnboardTime { get; set; } /// /// 预期转正时间，毫秒级时间戳 @@ -87,7 +87,7 @@ public record GetHireV1EmployeesByEmployeeIdResponseDtoEmployee /// 示例值：1637596800000 /// [JsonPropertyName("expected_conversion_time")] - public int? ExpectedConversionTime { get; set; } + public long? ExpectedConversionTime { get; set; } /// /// 实际转正时间，毫秒级时间戳 @@ -95,7 +95,7 @@ public record GetHireV1EmployeesByEmployeeIdResponseDtoEmployee /// 示例值：1637596800000 /// [JsonPropertyName("actual_conversion_time")] - public int? ActualConversionTime { get; set; } + public long? ActualConversionTime { get; set; } /// /// 离职时间，毫秒级时间戳 @@ -103,7 +103,7 @@ public record GetHireV1EmployeesByEmployeeIdResponseDtoEmployee /// 示例值：1637596800000 /// [JsonPropertyName("overboard_time")] - public int? OverboardTime { get; set; } + public long? OverboardTime { get; set; } /// /// 离职原因 diff --git a/src/Hire/GetHireV1EmployeesGetByApplicationResponseDto.cs b/src/Hire/GetHireV1EmployeesGetByApplicationResponseDto.cs index 68d094f9..bf8d4e06 100644 --- a/src/Hire/GetHireV1EmployeesGetByApplicationResponseDto.cs +++ b/src/Hire/GetHireV1EmployeesGetByApplicationResponseDto.cs @@ -4,7 +4,7 @@ // Created : 2024-06-24 // // Last Modified By : yxr -// Last Modified On : 2024-06-24 +// Last Modified On : 2024-08-07 // ************************************************************************ // // MIT @@ -79,7 +79,7 @@ public record GetHireV1EmployeesGetByApplicationResponseDtoEmployee /// 示例值：1637596800000 /// [JsonPropertyName("onboard_time")] - public int? OnboardTime { get; set; } + public long? OnboardTime { get; set; } /// /// 预期转正时间，毫秒级时间戳 @@ -87,7 +87,7 @@ public record GetHireV1EmployeesGetByApplicationResponseDtoEmployee /// 示例值：1637596800000 /// [JsonPropertyName("expected_conversion_time")] - public int? ExpectedConversionTime { get; set; } + public long? ExpectedConversionTime { get; set; } /// /// 实际转正时间，毫秒级时间戳 @@ -95,7 +95,7 @@ public record GetHireV1EmployeesGetByApplicationResponseDtoEmployee /// 示例值：1637596800000 /// [JsonPropertyName("actual_conversion_time")] - public int? ActualConversionTime { get; set; } + public long? ActualConversionTime { get; set; } /// /// 离职时间，毫秒级时间戳 @@ -103,7 +103,7 @@ public record GetHireV1EmployeesGetByApplicationResponseDtoEmployee /// 示例值：1637596800000 /// [JsonPropertyName("overboard_time")] - public int? OverboardTime { get; set; } + public long? OverboardTime { get; set; } /// /// 离职原因 diff --git a/src/Hire/GetHireV1InterviewsResponseDto.cs b/src/Hire/GetHireV1InterviewsResponseDto.cs index fff1fb84..cbe023a4 100644 --- a/src/Hire/GetHireV1InterviewsResponseDto.cs +++ b/src/Hire/GetHireV1InterviewsResponseDto.cs @@ -4,7 +4,7 @@ // Created : 2024-06-24 // // Last Modified By : yxr -// Last Modified On : 2024-08-02 +// Last Modified On : 2024-08-07 // ************************************************************************ // // MIT @@ -66,19 +66,19 @@ public record InterviewExtend public int? Round { get; set; } /// - /// 面试记录信息 + /// 面试评价信息 /// 必填：否 /// [JsonPropertyName("interview_record_list")] public InterviewRecord[]? InterviewRecordLists { get; set; } /// - /// 面试记录信息 + /// 面试评价信息 /// public record InterviewRecord { /// - /// 面试记录 ID + /// 面试评价 ID /// 必填：否 /// 示例值：6949805467799537964 /// @@ -94,7 +94,7 @@ public record InterviewRecord public string? UserId { get; set; } /// - /// 系统预设题目内容，来自面试评价表中预设字段「记录」，详情参考[获取面试评价表信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/interview_record_template/list) + /// 系统预设题目内容，来自面试评价表中预设字段「记录」，详情参考[获取面试评价表列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/interview_feedback_form/list) /// 必填：否 /// 示例值：符合要求，推荐录用 /// @@ -157,7 +157,7 @@ public record InterviewRecordInterviewScore public int? Level { get; set; } /// - /// 面试记录中文名称 + /// 面试评分中文名称 /// 必填：否 /// 示例值：第一轮面试 /// @@ -165,7 +165,7 @@ public record InterviewRecordInterviewScore public string? ZhName { get; set; } /// - /// 面试记录中文描述 + /// 面试评分中文描述 /// 必填：否 /// 示例值：通过，能力达到要求， 建议录用 /// @@ -173,7 +173,7 @@ public record InterviewRecordInterviewScore public string? ZhDescription { get; set; } /// - /// 面试记录英文名称 + /// 面试评分英文名称 /// 必填：否 /// 示例值：English name /// @@ -181,7 +181,7 @@ public record InterviewRecordInterviewScore public string? EnName { get; set; } /// - /// 面试记录英文描述 + /// 面试评分英文描述 /// 必填：否 /// 示例值：Pass, ability to meet the requirements, suggest to hire /// @@ -328,7 +328,7 @@ public record I18n /// 示例值：1618999376474 /// [JsonPropertyName("biz_create_time")] - public int? BizCreateTime { get; set; } + public long? BizCreateTime { get; set; } /// /// 最近更新时间，毫秒时间戳 @@ -336,7 +336,7 @@ public record I18n /// 示例值：1618999376474 /// [JsonPropertyName("biz_modify_time")] - public int? BizModifyTime { get; set; } + public long? BizModifyTime { get; set; } /// /// 面试状态 @@ -640,7 +640,7 @@ public record I18n public record InterviewMeetingRoom { /// - /// 会议室 ID + /// 会议室 ID，详情可查看：[查询会议室列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/list) /// 必填：否 /// 示例值：6949805467799537964 /// diff --git a/src/Hire/GetHireV1JobRequirementSchemasResponseDto.cs b/src/Hire/GetHireV1JobRequirementSchemasResponseDto.cs index a989460b..8822ade3 100644 --- a/src/Hire/GetHireV1JobRequirementSchemasResponseDto.cs +++ b/src/Hire/GetHireV1JobRequirementSchemasResponseDto.cs @@ -9,12 +9,12 @@ // // MIT // -// 获取招聘需求模板 响应体 +// 获取招聘需求模板列表 响应体 // ************************************************************************ namespace FeishuNetSdk.Hire; /// -/// 获取招聘需求模板 响应体 -/// 获取招聘需求模板。 +/// 获取招聘需求模板列表 响应体 +/// 获取招聘需求模板列表，包含需求模板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 @@ -22,19 +22,19 @@ namespace FeishuNetSdk.Hire; public record GetHireV1JobRequirementSchemasResponseDto { /// - /// 列表 + /// 招聘需求模板列表 /// 必填：否 /// [JsonPropertyName("items")] public JobRequirementSchema[]? Items { get; set; } /// - /// 列表 + /// 招聘需求模板列表 /// public record JobRequirementSchema { /// - /// 模板 ID + /// 招聘需求模板 ID /// 必填：否 /// 示例值：6949805467799537964 /// @@ -42,43 +42,43 @@ public record JobRequirementSchema public string? Id { get; set; } /// - /// 国际化模板名称 + /// 招聘需求模板名称 /// 必填：否 /// [JsonPropertyName("name")] public I18n? Name { get; set; } /// - /// 国际化模板名称 + /// 招聘需求模板名称 /// public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：关键职位招聘需求模板 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：Recruitment requirements template for key positions /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } } /// - /// 模板字段 + /// 招聘需求模板模块列表 /// 必填：否 /// [JsonPropertyName("object_list")] public CommonSchema[]? ObjectLists { get; set; } /// - /// 模板字段 + /// 招聘需求模板模块列表 /// public record CommonSchema { @@ -103,17 +103,17 @@ public record CommonSchema public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：默认模块 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：Default module /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -139,9 +139,9 @@ public record I18n public record CommonSchemaSetting { /// - /// 字段类型 + /// 模块类型，固定返回`11` /// 必填：否 - /// 示例值：1 + /// 示例值：11 /// 可选值： /// 1：单行文本 /// 2：多行文本 @@ -161,14 +161,14 @@ public record CommonSchemaSetting public int? ObjectType { get; set; } /// - /// 配置信息 + /// 配置信息，固定返回空 /// 必填：否 /// [JsonPropertyName("config")] public CommonSchemaConfig? Config { get; set; } /// - /// 配置信息 + /// 配置信息，固定返回空 /// public record CommonSchemaConfig { @@ -187,7 +187,7 @@ public record CommonSchemaOption /// /// 选项 ID /// 必填：否 - /// 示例值：test + /// 示例值：Beijing /// [JsonPropertyName("key")] public string? Key { get; set; } @@ -205,17 +205,17 @@ public record CommonSchemaOption public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：北京 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：Beijing /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -272,14 +272,14 @@ public record I18n public int? ActiveStatus { get; set; } /// - /// 字段列表 + /// 模块中的字段列表 /// 必填：否 /// [JsonPropertyName("children_list")] public CommonSchemaChild[]? ChildrenLists { get; set; } /// - /// 字段列表 + /// 模块中的字段列表 /// public record CommonSchemaChild { @@ -304,17 +304,17 @@ public record CommonSchemaChild public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：工作地点 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：workplace /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -328,19 +328,19 @@ public record I18n public I18n? Description { get; set; } /// - /// 字段信息 + /// 字段配置信息 /// 必填：否 /// [JsonPropertyName("setting")] public CommonSchemaSetting? Setting { get; set; } /// - /// 字段信息 + /// 字段配置信息 /// public record CommonSchemaSetting { /// - /// 字段类型 + /// 字段类型，可选值为1-10，不会返回为11、13 /// 必填：否 /// 示例值：1 /// 可选值： @@ -374,21 +374,21 @@ public record CommonSchemaSetting public record CommonSchemaConfig { /// - /// 选项信息 + /// 选项信息，仅适用于字段类型为单选（`3`）或多选(`4`) /// 必填：否 /// [JsonPropertyName("options")] public CommonSchemaOption[]? Options { get; set; } /// - /// 选项信息 + /// 选项信息，仅适用于字段类型为单选（`3`）或多选(`4`) /// public record CommonSchemaOption { /// - /// 选项 ID + /// 选项Key /// 必填：否 - /// 示例值：test + /// 示例值：Beijing /// [JsonPropertyName("key")] public string? Key { get; set; } @@ -406,17 +406,17 @@ public record CommonSchemaOption public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：北京 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：Beijing /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -494,7 +494,7 @@ public record I18n /// /// 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token /// 必填：否 - /// 示例值：1234452132 + /// 示例值：eyJvZmZzZXQiOjEwLCJ0aW1NTUyMjM2NzIsImlkIjpudWxsfQ /// [JsonPropertyName("page_token")] public string? PageToken { get; set; } diff --git a/src/Hire/GetHireV1OfferApplicationFormsByOfferApplicationFormIdResponseDto.cs b/src/Hire/GetHireV1OfferApplicationFormsByOfferApplicationFormIdResponseDto.cs index 6275e412..7ce925fb 100644 --- a/src/Hire/GetHireV1OfferApplicationFormsByOfferApplicationFormIdResponseDto.cs +++ b/src/Hire/GetHireV1OfferApplicationFormsByOfferApplicationFormIdResponseDto.cs @@ -140,7 +140,9 @@ public record I18n } /// - /// 是否为自定义模块，false代表系统预置模块 + /// 是否为自定义模块： + /// - true：自定义模块 + /// - false：系统预置模块 /// 必填：否 /// 示例值：false /// @@ -231,7 +233,9 @@ public record I18n public string? ModuleId { get; set; } /// - /// 是否为自定义字段，false代表系统预置字段 + /// 是否为自定义字段： + /// - true：自定义字段 + /// - false：系统预置字段 /// 必填：否 /// 示例值：true /// @@ -239,7 +243,9 @@ public record I18n public bool? IsCustomized { get; set; } /// - /// 是否必填 + /// 是否必填： + /// - true：必填 + /// - false：非必填 /// 必填：否 /// 示例值：true /// @@ -259,7 +265,9 @@ public record I18n public int? ActiveStatus { get; set; } /// - /// 修改后是否需要审批 + /// 修改后是否需要审批： + /// - true：需要审批 + /// - false：不需要审批 /// 必填：否 /// 示例值：true /// @@ -267,7 +275,9 @@ public record I18n public bool? NeedApprove { get; set; } /// - /// 是否敏感字段，敏感字段会在发起 Offer 审批时隐藏 + /// 是否敏感字段（敏感字段会在发起 Offer 审批时隐藏） + /// - true：敏感字段 + /// - false：非敏感字段 /// 必填：否 /// 示例值：false /// diff --git a/src/Hire/GetHireV1OffersByOfferIdResponseDto.cs b/src/Hire/GetHireV1OffersByOfferIdResponseDto.cs index bb3d4846..f712d29f 100644 --- a/src/Hire/GetHireV1OffersByOfferIdResponseDto.cs +++ b/src/Hire/GetHireV1OffersByOfferIdResponseDto.cs @@ -161,7 +161,7 @@ public record BaseBilingualWithId public string? LeaderUserId { get; set; } /// - /// 入职日期，毫秒级时间戳 + /// 入职日期，格式为YYYY-MM-DD /// 必填：否 /// 示例值：2021-05-20 /// diff --git a/src/Hire/GetHireV1ReferralWebsitesJobPostsByJobPostIdResponseDto.cs b/src/Hire/GetHireV1ReferralWebsitesJobPostsByJobPostIdResponseDto.cs index 2a14f982..8fea8cc9 100644 --- a/src/Hire/GetHireV1ReferralWebsitesJobPostsByJobPostIdResponseDto.cs +++ b/src/Hire/GetHireV1ReferralWebsitesJobPostsByJobPostIdResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 获取内推官网下职位广告详情 响应体 -/// 根据广告 ID 获取内推官网下的职位广告详情。 +/// 根据职位广告 ID 获取内推官网下的职位广告详情，包含职位广告 ID 以及职位信息等。 /// 接口ID：7204730827112185860 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/get-candidates/referral/get /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2freferral_website-job_post%2fget @@ -36,15 +36,15 @@ public record PortalJobPost /// /// 职位广告 ID /// 必填：否 - /// 示例值：1213213123123 + /// 示例值：7174316547413000195 /// [JsonPropertyName("id")] public string? Id { get; set; } /// - /// 标题 + /// 职位广告名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：高级工程师招聘 /// [JsonPropertyName("title")] public string? Title { get; set; } @@ -52,7 +52,7 @@ public record PortalJobPost /// /// 职位 ID /// 必填：否 - /// 示例值：xxx + /// 示例值：7392894182636030258 /// [JsonPropertyName("job_id")] public string? JobId { get; set; } @@ -60,15 +60,15 @@ public record PortalJobPost /// /// 职位编码 /// 必填：否 - /// 示例值：007 + /// 示例值：A168688 /// [JsonPropertyName("job_code")] public string? JobCode { get; set; } /// - /// 职位过期时间，「null」代表「长期有效」 + /// 职位到期时间，毫秒时间戳，「null」代表「长期有效」 /// 必填：否 - /// 示例值：1111 + /// 示例值：1722837278000 /// [JsonPropertyName("job_expire_time")] public string? JobExpireTime { get; set; } @@ -98,49 +98,49 @@ public record PortalJobPost public int? JobProcessType { get; set; } /// - /// 职位雇佣类型 + /// 职位雇佣类型，请参考[枚举常量介绍](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) /// public record IdNameObject { /// - /// ID + /// 职位雇佣类型ID /// 必填：否 - /// 示例值：1213213123123 + /// 示例值：101 /// [JsonPropertyName("id")] public string? Id { get; set; } /// - /// 名称 + /// 职位雇佣类型名称 /// 必填：否 /// [JsonPropertyName("name")] public I18n? Name { get; set; } /// - /// 名称 + /// 职位雇佣类型名称 /// public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：全职 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：Full-time /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -148,7 +148,7 @@ public record I18n } /// - /// 职位部门 + /// 部门 /// 必填：否 /// [JsonPropertyName("job_department")] @@ -176,19 +176,19 @@ public record I18n public IdNameObject? MaxJobLevel { get; set; } /// - /// 职位地址 + /// 职位地址，废弃字段，请使用`address_list`字段 /// 必填：否 /// [JsonPropertyName("address")] public CommonAddress? Address { get; set; } /// - /// 职位地址 + /// 职位地址，废弃字段，请使用`address_list`字段 /// public record CommonAddress { /// - /// ID + /// 职位地址ID，详情请参考：[获取地址列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/list) /// 必填：否 /// 示例值：6583482347283472832 /// @@ -196,29 +196,29 @@ public record CommonAddress public string? Id { get; set; } /// - /// 名称 + /// 职位地址名称 /// 必填：否 /// [JsonPropertyName("name")] public I18n? Name { get; set; } /// - /// 名称 + /// 职位地址名称 /// public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：抖音大厦 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：Douyin Building /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -237,37 +237,37 @@ public record I18n public record CodeNameObject { /// - /// 编码 + /// 区域编码 /// 必填：否 - /// 示例值：1111 + /// 示例值：DS_1000002 /// [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 + /// 示例值：Daguan /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -282,7 +282,7 @@ public record I18n public CodeNameObject? City { get; set; } /// - /// 省信息 + /// 省份信息 /// 必填：否 /// [JsonPropertyName("state")] @@ -297,17 +297,17 @@ public record I18n } /// - /// 月薪范围-最低薪资 + /// 月薪范围-最低薪资，单位：K /// 必填：否 - /// 示例值：5000 + /// 示例值：5 /// [JsonPropertyName("min_salary")] public string? MinSalary { get; set; } /// - /// 月薪范围-最高薪资 + /// 月薪范围-最高薪资，单位：K /// 必填：否 - /// 示例值：10000 + /// 示例值：20 /// [JsonPropertyName("max_salary")] public string? MaxSalary { get; set; } @@ -332,7 +332,7 @@ public record I18n public int? RequiredDegree { get; set; } /// - /// 经验 + /// 工作经验 /// 必填：否 /// 示例值：1 /// 可选值： @@ -350,7 +350,7 @@ public record I18n public int? Experience { get; set; } /// - /// 数量 + /// 招聘数量 /// 必填：否 /// 示例值：12 /// @@ -358,7 +358,7 @@ public record I18n public int? Headcount { get; set; } /// - /// 职位亮点 + /// 职位亮点列表，详情请参考：[枚举常量介绍](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/enum) /// 必填：否 /// [JsonPropertyName("high_light_list")] @@ -375,7 +375,7 @@ public record I18n /// /// 职位要求 /// 必填：否 - /// 示例值：大专 + /// 示例值：有相关经验者优先 /// [JsonPropertyName("requirement")] public string? Requirement { get; set; } @@ -388,37 +388,37 @@ public record I18n public IdNameObject? Creator { get; set; } /// - /// 创建时间 + /// 创建时间，毫秒时间戳 /// 必填：否 - /// 示例值：1111 + /// 示例值：1716791547691 /// [JsonPropertyName("create_time")] public string? CreateTime { get; set; } /// - /// 修改时间 + /// 修改时间，毫秒时间戳 /// 必填：否 - /// 示例值：222 + /// 示例值：1716791547691 /// [JsonPropertyName("modify_time")] public string? ModifyTime { get; set; } /// - /// 自定义字段 + /// 自定义字段列表，详情可参考：[获取职位模板](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_schema/list) /// 必填：否 /// [JsonPropertyName("customized_data_list")] public WebsiteJobPostCustomizedData[]? CustomizedDataLists { get; set; } /// - /// 自定义字段 + /// 自定义字段列表，详情可参考：[获取职位模板](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_schema/list) /// public record WebsiteJobPostCustomizedData { /// /// 自定义字段 ID /// 必填：否 - /// 示例值：xxxx + /// 示例值：7368811146881091852 /// [JsonPropertyName("object_id")] public string? ObjectId { get; set; } @@ -436,17 +436,17 @@ public record WebsiteJobPostCustomizedData public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：集团数字化 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：group digitization /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -485,9 +485,9 @@ public record I18n public record WebsiteJobPostCustomizedValue { /// - /// 当字段类型为单行文本、多行文本、模块、默认字段时，从此字段取值 + /// 当字段类型为单行文本、多行文本、默认字段时，从此字段取值 /// 必填：否 - /// 示例值：text + /// 示例值：集团数字化是大方向 /// [JsonPropertyName("content")] public string? Content { get; set; } @@ -507,7 +507,7 @@ public record WebsiteJobPostCustomizedOption /// /// 选项 ID /// 必填：否 - /// 示例值：AA + /// 示例值：1 /// [JsonPropertyName("key")] public string? Key { get; set; } @@ -525,17 +525,17 @@ public record WebsiteJobPostCustomizedOption public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：支持 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：support /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -562,17 +562,17 @@ public record I18n public record WebsiteJobPostCustomizedTimeRange { /// - /// 开始时间 + /// 开始时间，毫秒时间戳 /// 必填：否 - /// 示例值：AA + /// 示例值：1716791547691 /// [JsonPropertyName("start_time")] public string? StartTime { get; set; } /// - /// 结束时间 + /// 结束时间，毫秒时间戳 /// 必填：否 - /// 示例值：AA + /// 示例值：1716891547691 /// [JsonPropertyName("end_time")] public string? EndTime { get; set; } @@ -589,7 +589,7 @@ public record WebsiteJobPostCustomizedTimeRange /// /// 当字段类型为数字时，从此字段取值 /// 必填：否 - /// 示例值：111 + /// 示例值：88 /// [JsonPropertyName("number")] public string? Number { get; set; } @@ -604,14 +604,14 @@ public record WebsiteJobPostCustomizedTimeRange public IdNameObject? JobFunction { get; set; } /// - /// 职位项目 + /// 项目 /// 必填：否 /// [JsonPropertyName("subject")] public IdNameObject? Subject { get; set; } /// - /// 职位广告地址列表 + /// 职位地址列表 /// 必填：否 /// [JsonPropertyName("address_list")] diff --git a/src/Hire/GetHireV1ReferralWebsitesJobPostsResponseDto.cs b/src/Hire/GetHireV1ReferralWebsitesJobPostsResponseDto.cs index 2f73bd3b..a52a4722 100644 --- a/src/Hire/GetHireV1ReferralWebsitesJobPostsResponseDto.cs +++ b/src/Hire/GetHireV1ReferralWebsitesJobPostsResponseDto.cs @@ -9,12 +9,12 @@ // // MIT // -// 获取内推官网下的职位列表 响应体 +// 获取内推官网下职位广告列表 响应体 // ************************************************************************ namespace FeishuNetSdk.Hire; /// -/// 获取内推官网下的职位列表 响应体 -/// 获取内推官网下的职位列表。自定义数据暂不支持列表获取，请从「获取内推官网下职位广告详情」接口获取。 +/// 获取内推官网下职位广告列表 响应体 +/// 获取内推官网下的职位列表，包含职位广告ID、职位广告名称、职位信息等。 /// 接口ID：7204730827112202244 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/get-candidates/referral/list /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2freferral_website-job_post%2flist @@ -22,29 +22,29 @@ namespace FeishuNetSdk.Hire; public record GetHireV1ReferralWebsitesJobPostsResponseDto { /// - /// 列表 + /// 职位广告列表 /// 必填：否 /// [JsonPropertyName("items")] public PortalJobPost[]? Items { get; set; } /// - /// 列表 + /// 职位广告列表 /// public record PortalJobPost { /// /// 职位广告 ID /// 必填：否 - /// 示例值：1213213123123 + /// 示例值：7174316547413000195 /// [JsonPropertyName("id")] public string? Id { get; set; } /// - /// 标题 + /// 职位广告名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：高级工程师招聘 /// [JsonPropertyName("title")] public string? Title { get; set; } @@ -52,7 +52,7 @@ public record PortalJobPost /// /// 职位 ID /// 必填：否 - /// 示例值：xxx + /// 示例值：7392894182636030258 /// [JsonPropertyName("job_id")] public string? JobId { get; set; } @@ -60,15 +60,15 @@ public record PortalJobPost /// /// 职位编码 /// 必填：否 - /// 示例值：007 + /// 示例值：A168688 /// [JsonPropertyName("job_code")] public string? JobCode { get; set; } /// - /// 职位过期时间，「null」代表「长期有效」 + /// 职位到期时间，毫秒时间戳，「null」代表「长期有效」 /// 必填：否 - /// 示例值：1111 + /// 示例值：1722837278000 /// [JsonPropertyName("job_expire_time")] public string? JobExpireTime { get; set; } @@ -98,49 +98,49 @@ public record PortalJobPost public int? JobProcessType { get; set; } /// - /// 职位雇佣类型 + /// 职位雇佣类型，请参考[枚举常量介绍](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) /// public record IdNameObject { /// - /// ID + /// 职位雇佣类型ID /// 必填：否 - /// 示例值：1213213123123 + /// 示例值：101 /// [JsonPropertyName("id")] public string? Id { get; set; } /// - /// 名称 + /// 职位雇佣类型名称 /// 必填：否 /// [JsonPropertyName("name")] public I18n? Name { get; set; } /// - /// 名称 + /// 职位雇佣类型名称 /// public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：全职 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：Full-time /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -148,14 +148,14 @@ public record I18n } /// - /// 职位部门 + /// 部门 /// 必填：否 /// [JsonPropertyName("job_department")] public IdNameObject? JobDepartment { get; set; } /// - /// 职位类型 + /// 职位类别 /// 必填：否 /// [JsonPropertyName("job_type")] @@ -176,49 +176,49 @@ public record I18n public IdNameObject? MaxJobLevel { get; set; } /// - /// 职位地址 + /// 职位地址，废弃字段，请使用`address_list`字段 /// 必填：否 /// [JsonPropertyName("address")] public CommonAddress? Address { get; set; } /// - /// 职位地址 + /// 职位地址，废弃字段，请使用`address_list`字段 /// public record CommonAddress { /// - /// ID + /// 职位地址ID，详情请参考：[获取地址列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/list) /// 必填：否 - /// 示例值：6583482347283472832 + /// 示例值：7389174667692834820 /// [JsonPropertyName("id")] public string? Id { get; set; } /// - /// 名称 + /// 职位地址名称 /// 必填：否 /// [JsonPropertyName("name")] public I18n? Name { get; set; } /// - /// 名称 + /// 职位地址名称 /// public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：抖音大厦 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：Douyin Building /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -237,37 +237,37 @@ public record I18n public record CodeNameObject { /// - /// 编码 + /// 区域编码 /// 必填：否 - /// 示例值：1111 + /// 示例值：DS_1000002 /// [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 + /// 示例值：Daguan /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -282,7 +282,7 @@ public record I18n public CodeNameObject? City { get; set; } /// - /// 省信息 + /// 省份信息 /// 必填：否 /// [JsonPropertyName("state")] @@ -297,17 +297,17 @@ public record I18n } /// - /// 月薪范围-最低薪资 + /// 月薪范围-最低薪资，单位：K /// 必填：否 - /// 示例值：5000 + /// 示例值：5 /// [JsonPropertyName("min_salary")] public string? MinSalary { get; set; } /// - /// 月薪范围-最高薪资 + /// 月薪范围-最高薪资，单位：K /// 必填：否 - /// 示例值：10000 + /// 示例值：50 /// [JsonPropertyName("max_salary")] public string? MaxSalary { get; set; } @@ -332,7 +332,7 @@ public record I18n public int? RequiredDegree { get; set; } /// - /// 经验 + /// 工作经验 /// 必填：否 /// 示例值：1 /// 可选值： @@ -350,7 +350,7 @@ public record I18n public int? Experience { get; set; } /// - /// 数量 + /// 招聘数量 /// 必填：否 /// 示例值：12 /// @@ -358,7 +358,7 @@ public record I18n public int? Headcount { get; set; } /// - /// 职位亮点 + /// 职位亮点列表，详情请参考：[枚举常量介绍](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/enum) /// 必填：否 /// [JsonPropertyName("high_light_list")] @@ -375,7 +375,7 @@ public record I18n /// /// 职位要求 /// 必填：否 - /// 示例值：大专 + /// 示例值：有相关经验者优先 /// [JsonPropertyName("requirement")] public string? Requirement { get; set; } @@ -388,37 +388,37 @@ public record I18n public IdNameObject? Creator { get; set; } /// - /// 创建时间 + /// 创建时间，毫秒时间戳 /// 必填：否 - /// 示例值：1111 + /// 示例值：1716791547691 /// [JsonPropertyName("create_time")] public string? CreateTime { get; set; } /// - /// 修改时间 + /// 修改时间，毫秒时间戳 /// 必填：否 - /// 示例值：222 + /// 示例值：1716791547691 /// [JsonPropertyName("modify_time")] public string? ModifyTime { get; set; } /// - /// 自定义字段 + /// 自定义字段列表，详情可参考：[获取职位模板](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_schema/list) /// 必填：否 /// [JsonPropertyName("customized_data_list")] public WebsiteJobPostCustomizedData[]? CustomizedDataLists { get; set; } /// - /// 自定义字段 + /// 自定义字段列表，详情可参考：[获取职位模板](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_schema/list) /// public record WebsiteJobPostCustomizedData { /// /// 自定义字段 ID /// 必填：否 - /// 示例值：xxxx + /// 示例值：7368811146881091852 /// [JsonPropertyName("object_id")] public string? ObjectId { get; set; } @@ -436,17 +436,17 @@ public record WebsiteJobPostCustomizedData public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：集团数字化 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：group digitization /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -485,9 +485,9 @@ public record I18n public record WebsiteJobPostCustomizedValue { /// - /// 当字段类型为单行文本、多行文本、模块、默认字段时，从此字段取值 + /// 当字段类型为单行文本、多行文本、默认字段时，从此字段取值 /// 必填：否 - /// 示例值：text + /// 示例值：集团数字化是大方向 /// [JsonPropertyName("content")] public string? Content { get; set; } @@ -507,7 +507,7 @@ public record WebsiteJobPostCustomizedOption /// /// 选项 ID /// 必填：否 - /// 示例值：AA + /// 示例值：1 /// [JsonPropertyName("key")] public string? Key { get; set; } @@ -525,17 +525,17 @@ public record WebsiteJobPostCustomizedOption public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：支持 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：support /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -562,17 +562,17 @@ public record I18n public record WebsiteJobPostCustomizedTimeRange { /// - /// 开始时间 + /// 开始时间，毫秒时间戳 /// 必填：否 - /// 示例值：AA + /// 示例值：1716791547691 /// [JsonPropertyName("start_time")] public string? StartTime { get; set; } /// - /// 结束时间 + /// 结束时间，毫秒时间戳 /// 必填：否 - /// 示例值：AA + /// 示例值：1716891547691 /// [JsonPropertyName("end_time")] public string? EndTime { get; set; } @@ -589,7 +589,7 @@ public record WebsiteJobPostCustomizedTimeRange /// /// 当字段类型为数字时，从此字段取值 /// 必填：否 - /// 示例值：111 + /// 示例值：88 /// [JsonPropertyName("number")] public string? Number { get; set; } @@ -604,7 +604,7 @@ public record WebsiteJobPostCustomizedTimeRange public IdNameObject? JobFunction { get; set; } /// - /// 职位广告地址列表 + /// 职位地址列表 /// 必填：否 /// [JsonPropertyName("address_list")] diff --git a/src/Hire/GetHireV1ReferralsGetByApplicationResponseDto.cs b/src/Hire/GetHireV1ReferralsGetByApplicationResponseDto.cs index 7abd3bc0..1e45c59b 100644 --- a/src/Hire/GetHireV1ReferralsGetByApplicationResponseDto.cs +++ b/src/Hire/GetHireV1ReferralsGetByApplicationResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 获取内推信息 响应体 -/// 根据投递 ID 获取内推信息。 +/// 根据投递 ID 获取内推信息，包含内推人信息、内推创建时间等。 /// 接口ID：6964264269274595330 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/get-candidates/referral/get_by_application /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2freferral%2fget_by_application @@ -34,9 +34,9 @@ public record GetHireV1ReferralsGetByApplicationResponseDto public record GetHireV1ReferralsGetByApplicationResponseDtoReferral { /// - /// 内推的 ID + /// 内推 ID /// 必填：是 - /// 示例值：6643786345878 + /// 示例值：7392247983414413606 /// [JsonPropertyName("id")] public string Id { get; set; } = string.Empty; @@ -50,7 +50,7 @@ public record GetHireV1ReferralsGetByApplicationResponseDtoReferral public string ApplicationId { get; set; } = string.Empty; /// - /// 创建时间（ms） + /// 创建时间，毫秒时间戳 /// 必填：是 /// 示例值：1618899376474 /// @@ -58,9 +58,9 @@ public record GetHireV1ReferralsGetByApplicationResponseDtoReferral public long CreateTime { get; set; } /// - /// 内推人的 ID + /// 内推人 ID，与`user_id_type`类型一致 /// 必填：是 - /// 示例值：ou_xxxx + /// 示例值：ou_669760b021dbd9edbf2f3dc11b3a25ed /// [JsonPropertyName("referral_user_id")] public string ReferralUserId { get; set; } = string.Empty; @@ -78,37 +78,37 @@ public record GetHireV1ReferralsGetByApplicationResponseDtoReferral public record IdNameObject { /// - /// ID + /// 内推人ID，同`referral_user_id`，与`user_id_type`类型一致 /// 必填：否 - /// 示例值：1213213123123 + /// 示例值：ou_669760b021dbd9edbf2f3dc11b3a25ed /// [JsonPropertyName("id")] public string? Id { get; set; } /// - /// 名称 + /// 内推人名称 /// 必填：否 /// [JsonPropertyName("name")] public I18n? Name { get; set; } /// - /// 名称 + /// 内推人名称 /// public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：张三 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：zhangsan /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } diff --git a/src/Hire/PostHireV1AgenciesProtectBodyDto.cs b/src/Hire/PostHireV1AgenciesProtectBodyDto.cs index b0c1c96d..37e9ceae 100644 --- a/src/Hire/PostHireV1AgenciesProtectBodyDto.cs +++ b/src/Hire/PostHireV1AgenciesProtectBodyDto.cs @@ -4,7 +4,7 @@ // Created : 2024-07-22 // // Last Modified By : yxr -// Last Modified On : 2024-07-22 +// Last Modified On : 2024-08-07 // ************************************************************************ // // MIT @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 设置猎头保护期 请求体 -/// 设置猎头保护期。 +/// 设置指定人才的猎头保护期，当「飞书招聘」内置的保护期功能不满足需求时，客户可通过此接口自定义人才的保护期。 /// 接口ID：6965472560995041282 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/get-candidates/agency/protect /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2fagency%2fprotect @@ -22,7 +22,7 @@ namespace FeishuNetSdk.Hire; public record PostHireV1AgenciesProtectBodyDto { /// - /// 人才ID + /// 人才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)接口获取 /// 必填：是 /// 示例值：6962051712422398239 /// @@ -30,7 +30,7 @@ public record PostHireV1AgenciesProtectBodyDto public string TalentId { get; set; } = string.Empty; /// - /// 供应商ID + /// 猎头供应商ID /// 必填：是 /// 示例值：6898173495386147079 /// @@ -38,7 +38,7 @@ public record PostHireV1AgenciesProtectBodyDto public string SupplierId { get; set; } = string.Empty; /// - /// 猎头顾问ID + /// 猎头顾问ID，需与`user_id_type`类型一致 /// 必填：是 /// 示例值：ou_f476cb099ac9227c9bae09ce46112579 /// @@ -46,20 +46,20 @@ public record PostHireV1AgenciesProtectBodyDto public string ConsultantId { get; set; } = string.Empty; /// - /// 保护期创建时间 + /// 保护期创建时间，毫秒时间戳 /// 必填：是 /// 示例值：1610695587000 /// [JsonPropertyName("protect_create_time")] - public int ProtectCreateTime { get; set; } + public long ProtectCreateTime { get; set; } /// - /// 保护期过期时间 + /// 保护期过期时间，毫秒时间戳 /// 必填：是 /// 示例值：1626333987000 /// [JsonPropertyName("protect_expire_time")] - public int ProtectExpireTime { get; set; } + public long ProtectExpireTime { get; set; } /// /// 推荐语 diff --git a/src/Hire/PostHireV1AgenciesProtectionPeriodSearchBodyDto.cs b/src/Hire/PostHireV1AgenciesProtectionPeriodSearchBodyDto.cs index c31c02b1..49ebe3f0 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/server-docs/hire-v1/candidate-management/talent/batch_get_id)获取 + /// 人才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 1b0e114e..0f381bd2 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 @@ -38,14 +38,14 @@ public record PostHireV1AgenciesProtectionPeriodSearchResponseDto public bool? OnboardedInProtection { get; set; } /// - /// 入职所在保护期 + /// 入职时所在保护期，当且仅当`is_onboarded = true && onboarded_in_protection = true`时，该字段有值 /// 必填：否 /// [JsonPropertyName("onboarded_protection")] public AgencyProtection? OnboardedProtection { get; set; } /// - /// 入职所在保护期 + /// 入职时所在保护期，当且仅当`is_onboarded = true && onboarded_in_protection = true`时，该字段有值 /// public record AgencyProtection { @@ -62,7 +62,7 @@ public record AgencyProtection public int? ProtectionType { get; set; } /// - /// 如保护期类型为职位保护，返回职位保护所在的投递id + /// 如保护期类型为 职位保护期（`2`）时，返回职位保护所在的投递id，详情请参考：[获取投递信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/get) /// 必填：否 /// 示例值：6930815272790114323 /// @@ -70,7 +70,7 @@ public record AgencyProtection public string? ApplicationId { get; set; } /// - /// 保护期开始时间 + /// 保护期开始时间，毫秒时间戳 /// 必填：否 /// 示例值：1700023694629 /// @@ -78,7 +78,7 @@ public record AgencyProtection public string? StartTime { get; set; } /// - /// 保护期过期时间 + /// 保护期过期时间，毫秒时间戳 /// 必填：否 /// 示例值：1700023694630 /// @@ -86,7 +86,7 @@ public record AgencyProtection public string? ExpireTime { get; set; } /// - /// 推荐的猎头供应商 ID + /// 猎头供应商 ID /// 必填：否 /// 示例值：6930815272790114324 /// @@ -94,21 +94,21 @@ public record AgencyProtection public string? AgencySupplierId { get; set; } /// - /// 推荐的猎头供应商名称 + /// 猎头供应商名称 /// 必填：否 /// [JsonPropertyName("agency_supplier_name")] public I18n? AgencySupplierName { get; set; } /// - /// 推荐的猎头供应商名称 + /// 猎头供应商名称 /// public record I18n { /// /// 中文名称 /// 必填：否 - /// 示例值：测试猎头 + /// 示例值：超越猎头公司 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } @@ -116,14 +116,15 @@ public record I18n /// /// 英文名称 /// 必填：否 - /// 示例值：test agency + /// 示例值：chaoyue head-hunting company /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } } /// - /// 推荐的猎头顾问ID，目前仅作为唯一标识，不可查询具体的人员信息 + /// 猎头顾问ID，与`user_id_type`类型一致。 + /// **注意**：由于猎头顾问位于猎头供应商租户里，不在该接口调用方租户里，无法直接通过此ID查询猎头顾问信息。 /// 必填：否 /// 示例值：6930815272790114324 /// @@ -131,7 +132,7 @@ public record I18n public string? AgencySupplierUserId { get; set; } /// - /// 推荐的猎头顾问名称 + /// 猎头顾问名称 /// 必填：否 /// [JsonPropertyName("agency_supplier_user_name")] @@ -139,7 +140,7 @@ public record I18n } /// - /// 人才保护信息 + /// 保护期列表，若返回空，则表明人才上没有任何的保护期 /// 必填：否 /// [JsonPropertyName("protection_list")] diff --git a/src/Hire/PostHireV1JobRequirementsBodyDto.cs b/src/Hire/PostHireV1JobRequirementsBodyDto.cs index 9f084998..60a6e7be 100644 --- a/src/Hire/PostHireV1JobRequirementsBodyDto.cs +++ b/src/Hire/PostHireV1JobRequirementsBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 创建招聘需求 请求体 -/// 创建招聘需求，除招聘需求编号为必填外，其他字段是否必填与飞书招聘「招聘需求字段管理」内设置一致。 +/// 创建招聘需求，可指定招聘需求部门、招聘人数、需求描述等，具体可参考「飞书招聘」-「设置」-「招聘需求字段管理」，或者参考[获取招聘需求模板](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_requirement_schema/list)。 /// 接口ID：6989078472837283843 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/recruitment-related-configuration/job_requirement/create /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2fjob_requirement%2fcreate @@ -22,9 +22,9 @@ namespace FeishuNetSdk.Hire; public record PostHireV1JobRequirementsBodyDto { /// - /// 招聘需求编号 + /// 招聘需求编号，需传入唯一的编号 /// 必填：是 - /// 示例值：xx1 + /// 示例值：R01905 /// [JsonPropertyName("short_code")] public string ShortCode { get; set; } = string.Empty; @@ -32,7 +32,7 @@ public record PostHireV1JobRequirementsBodyDto /// /// 需求名称 /// 必填：是 - /// 示例值：test + /// 示例值：HR部门春季招聘需求 /// [JsonPropertyName("name")] public string Name { get; set; } = string.Empty; @@ -56,13 +56,14 @@ public record PostHireV1JobRequirementsBodyDto /// /// 需求人数 /// 必填：是 - /// 示例值：11 + /// 示例值：10 /// [JsonPropertyName("head_count")] public int HeadCount { get; set; } /// - /// 职位性质 ID，可在「招聘枚举常量」文档中查看枚举值，即将下线，请尽快切换至「employee_type_id」字段。与「employee_type_id」字段必填其一 + /// 职位性质 ID，可在[枚举常量介绍](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/enum)查阅枚举值。 + /// - **注意**：该字段即将下线，请使用`employee_type_id`字段，与`employee_type_id`字段必填其一 /// 必填：否 /// 示例值：101 /// @@ -70,8 +71,7 @@ public record PostHireV1JobRequirementsBodyDto public string? RecruitmentTypeId { get; set; } /// - /// 人员类型ID - /// 获取枚举详情见本文档「查询参数」部分；使用该字段前，请联系招聘团队确认已在灰度内 + /// 人员类型ID，类型需与`employee_type_id_type`保持一致 /// 必填：否 /// 示例值：6807409776231254285 /// @@ -79,8 +79,7 @@ public record PostHireV1JobRequirementsBodyDto public string? EmployeeTypeId { get; set; } /// - /// 最高职级 ID - /// 获取枚举详情见本文档「查询参数」部分 + /// 最高职级 ID，需与`job_level_id_type`类型保持一致 /// 必填：否 /// 示例值：6807409776231254286 /// @@ -88,8 +87,7 @@ public record PostHireV1JobRequirementsBodyDto public string? MaxLevelId { get; set; } /// - /// 最低职级 ID - /// 获取枚举详情见本文档「查询参数」部分 + /// 最低职级 ID，需与`job_level_id_type`类型保持一致 /// 必填：否 /// 示例值：6807409776231254287 /// @@ -97,8 +95,7 @@ public record PostHireV1JobRequirementsBodyDto public string? MinLevelId { get; set; } /// - /// 职位序列 ID - /// 获取枚举详情见本文档「查询参数」部分 + /// 职位序列 ID，需与`job_family_id_type`类型保持一致 /// 必填：否 /// 示例值：6911957338526091536 /// @@ -118,7 +115,7 @@ public record PostHireV1JobRequirementsBodyDto public int? Category { get; set; } /// - /// 需求部门的 open department id + /// 需求部门ID，需与`department_id_type`类型一致 /// 必填：否 /// 示例值：od-4e6ac4d14bcd5071a37a39de902c7141 /// @@ -126,7 +123,7 @@ public record PostHireV1JobRequirementsBodyDto public string? DepartmentId { get; set; } /// - /// 需求负责人 ID 列表 + /// 需求负责人 ID 列表，需与`user_id_type`类型保持一致 /// 必填：否 /// 示例值：ou_7dab8a3d3cdcc9da365777c7ad535d62 /// @@ -134,14 +131,14 @@ public record PostHireV1JobRequirementsBodyDto public string[]? RecruiterIdList { get; set; } /// - /// 需求用人经理 ID 列表 + /// 需求用人经理 ID 列表，需与`user_id_type`类型保持一致 /// 必填：否 /// [JsonPropertyName("jr_hiring_manager_id_list")] public string[]? JrHiringManagerIdList { get; set; } /// - /// 直属上级 ID + /// 直属上级 ID，需与`user_id_type`类型保持一致 /// 必填：否 /// 示例值：ou_7dab8a3d3cdcc9da365777c7ad535d62 /// @@ -149,7 +146,7 @@ public record PostHireV1JobRequirementsBodyDto public string[]? DirectLeaderIdList { get; set; } /// - /// 开始日期，毫秒级时间戳 + /// 开始日期，毫秒时间戳 /// 必填：否 /// 示例值：1625729379000 /// @@ -157,7 +154,7 @@ public record PostHireV1JobRequirementsBodyDto public string? StartTime { get; set; } /// - /// 预计完成日期，毫秒级时间戳 + /// 预计完成日期，毫秒时间戳 /// 必填：否 /// 示例值：1625729379000 /// @@ -197,7 +194,7 @@ public record PostHireV1JobRequirementsBodyDto public int? RequiredDegree { get; set; } /// - /// 最高薪资，单位：千 + /// 最高薪资，单位：K /// 必填：否 /// 示例值：10 /// @@ -205,17 +202,17 @@ public record PostHireV1JobRequirementsBodyDto public string? MaxSalary { get; set; } /// - /// 最低薪资，单位：千 + /// 最低薪资，单位：K /// 必填：否 - /// 示例值：15 + /// 示例值：5 /// [JsonPropertyName("min_salary")] public string? MinSalary { get; set; } /// - /// 工作地点 ID，枚举值可通过「获取地址列表」接口查询获得 + /// 工作地址ID，可通过[获取地址列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/list)获取 /// 必填：否 - /// 示例值：11 + /// 示例值：7265901641899311105 /// [JsonPropertyName("address_id")] public string? AddressId { get; set; } @@ -223,25 +220,25 @@ public record PostHireV1JobRequirementsBodyDto /// /// 需求描述 /// 必填：否 - /// 示例值：11 + /// 示例值：部门人力紧缺，需要招聘资深工程师10名 /// [JsonPropertyName("description")] public string? Description { get; set; } /// - /// 自定义字段 + /// 自定义字段，可通过[获取招聘需求模板](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)获取自定义字段列表、类型等 /// public record JobRequirementCustomizedData { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取招聘需求模板](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_requirement_schema/list)获取 /// 必填：否 /// 示例值：1213213123123 /// @@ -249,22 +246,25 @@ public record JobRequirementCustomizedData public string? ObjectId { get; set; } /// - /// 自定义字段 value，1. 对于自定义字段，若字段类型为单行文本/多行文本，传值格式为"这是一个文本"；2. 若字段类型为单选，传值内容为选项的 ID，格式为"6890840516938696974"； - /// 3. 若字段类型为多选，传值内容为选项的ID 列表，格式为"[\"6890840516938696974\", \"6890840516938696975\" ]"； - /// 4. 若字段类型为时间段，传值格式为"[\"1609430400000\", \"1612108800000\" ]"，单位是毫米级时间戳； - /// 5. 若字段类型为年份选择，传值格式为"1609430400000"，单位是毫秒级时间戳； - /// 6. 若字段类型为月份选择，传值格式为"1625068800000"，单位是毫秒级时间戳； - /// 7. 若字段类型为数字，传值格式为"1"; - /// 8. 若字段为富文本，传值举例{\"0\":{\"ops\":[{\"insert\":\"测试富文本\",\"attributes\":{\"bold\":\"true\"}},{\"insert\":\"\\n\"}],\"zoneId\":\"0\",\"zoneType\":\"Z\"}} + /// 自定义字段 value + /// - 若字段类型为单行文本/多行文本，格式为"简单文本"； + /// - 若字段类型为单选，传值内容为选项的 ID，格式为"6890840516938696974"； + /// - 若字段类型为多选，传值内容为选项的ID 列表，格式为"[\"6890840516938696974\", \"6890840516938696975\" ]"； + /// - 若字段类型为时间，格式为"1609430400000" + /// - 若字段类型为时间段，格式为"["1609430400000", \"1612108800000\" ]"，单位是毫秒时间戳； + /// - 若字段类型为年份选择，格式为"1609430400000"，单位是毫秒时间戳； + /// - 若字段类型为月份选择，格式为"1625068800000"，单位是毫秒时间戳； + /// - 若字段类型为数字，传值格式为"1"; + /// - 若字段类型为富文本，传值举例"富文本" /// 必填：否 - /// 示例值：测试 + /// 示例值：简单文本 /// [JsonPropertyName("value")] public string? Value { get; set; } } /// - /// 招聘类型，是否必填以「获取招聘需求模板」中字段限制为准，通过招聘需求新建职位时会根据此字段回填职位招聘类型 + /// 招聘类型 /// 必填：否 /// 示例值：1 /// 可选值： @@ -276,7 +276,7 @@ public record JobRequirementCustomizedData public int? ProcessType { get; set; } /// - /// 职位类别，枚举值通过「获取职位类别列表」接口获取，是否必填以「获取招聘需求模板」中字段限制为准，通过招聘需求新建职位时会根据此字段回填职位类别 + /// 职位类别，可通过[获取职位类别列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_type/list)获取 /// 必填：否 /// 示例值：6930815272790114324 /// diff --git a/src/Hire/PostHireV1JobRequirementsResponseDto.cs b/src/Hire/PostHireV1JobRequirementsResponseDto.cs index fc318033..b35feef8 100644 --- a/src/Hire/PostHireV1JobRequirementsResponseDto.cs +++ b/src/Hire/PostHireV1JobRequirementsResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 创建招聘需求 响应体 -/// 创建招聘需求，除招聘需求编号为必填外，其他字段是否必填与飞书招聘「招聘需求字段管理」内设置一致。 +/// 创建招聘需求，可指定招聘需求部门、招聘人数、需求描述等，具体可参考「飞书招聘」-「设置」-「招聘需求字段管理」，或者参考[获取招聘需求模板](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_requirement_schema/list)。 /// 接口ID：6989078472837283843 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/recruitment-related-configuration/job_requirement/create /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2fjob_requirement%2fcreate @@ -44,7 +44,7 @@ public record JobRequirementDto /// /// 招聘需求编号 /// 必填：否 - /// 示例值：xx1 + /// 示例值：R01905 /// [JsonPropertyName("short_code")] public string? ShortCode { get; set; } @@ -52,7 +52,7 @@ public record JobRequirementDto /// /// 需求名称 /// 必填：否 - /// 示例值：test + /// 示例值：HR部门春季招聘需求 /// [JsonPropertyName("name")] public string? Name { get; set; } @@ -76,55 +76,55 @@ public record JobRequirementDto /// /// 需求人数 /// 必填：否 - /// 示例值：11 + /// 示例值：10 /// [JsonPropertyName("head_count")] public int? HeadCount { get; set; } /// - /// 职位性质 ，可在「招聘枚举常量」文档中查看枚举值，推荐使用「employee_type」字段 + /// 职位性质 ，可在[枚举常量介绍](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/enum)文档中查看枚举值，建议使用`employee_type`字段 /// 必填：否 /// [JsonPropertyName("recruitment_type")] public IdNameObject? RecruitmentType { get; set; } /// - /// 职位性质 ，可在「招聘枚举常量」文档中查看枚举值，推荐使用「employee_type」字段 + /// 职位性质 ，可在[枚举常量介绍](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/enum)文档中查看枚举值，建议使用`employee_type`字段 /// public record IdNameObject { /// - /// ID + /// 职位性质ID /// 必填：否 - /// 示例值：1213213123123 + /// 示例值：101 /// [JsonPropertyName("id")] public string? Id { get; set; } /// - /// 名称 + /// 职位性质名称 /// 必填：否 /// [JsonPropertyName("name")] public I18n? Name { get; set; } /// - /// 名称 + /// 职位性质名称 /// public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：社招-全职 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：Social recruitment - Full time /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -132,28 +132,28 @@ public record I18n } /// - /// 人员类型，通过[「获取员工类型列表」](https://open.feishu.cn/document/server-docs/people_admin-v1/employee_type/list)接口获取详情。使用前请咨询招聘团队，确保已经在相关的灰度内 + /// 人员类型，与`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,35 +172,35 @@ 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")] public IdNameObject[]? DirectLeaderLists { get; set; } /// - /// 开始日期，毫秒级时间戳 + /// 开始日期，毫秒时间戳 /// 必填：否 /// 示例值：1625729379000 /// @@ -208,7 +208,7 @@ public record I18n public string? StartTime { get; set; } /// - /// 预计完成日期，毫秒级时间戳 + /// 预计完成日期，毫秒时间戳 /// 必填：否 /// 示例值：1625729379000 /// @@ -248,23 +248,23 @@ public record I18n public int? RequiredDegree { get; set; } /// - /// 最高薪资 + /// 最高薪资，单位：K /// 必填：否 - /// 示例值：123 + /// 示例值：10 /// [JsonPropertyName("max_salary")] public string? MaxSalary { get; set; } /// - /// 最低薪资 + /// 最低薪资，单位：K /// 必填：否 - /// 示例值：11 + /// 示例值：5 /// [JsonPropertyName("min_salary")] public string? MinSalary { get; set; } /// - /// 工作地点 + /// 工作地址 /// 必填：否 /// [JsonPropertyName("address")] @@ -273,7 +273,7 @@ public record I18n /// /// 需求描述 /// 必填：否 - /// 示例值：11 + /// 示例值：部门人力紧缺，需要招聘资深工程师10名 /// [JsonPropertyName("description")] public string? Description { get; set; } @@ -293,7 +293,7 @@ public record JobRequirementCustomizedDataDto /// /// 自定义字段 ID /// 必填：否 - /// 示例值：xxxx + /// 示例值：123123123 /// [JsonPropertyName("object_id")] public string? ObjectId { get; set; } @@ -311,17 +311,17 @@ public record JobRequirementCustomizedDataDto public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：招聘原因 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：Recruitment reason /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -363,7 +363,7 @@ public record JobRequirementCustomizedValue /// /// 当字段类型为单行文本、多行文本、模块、默认字段时，从此字段取值 /// 必填：否 - /// 示例值：text + /// 示例值：人员紧缺程度 /// [JsonPropertyName("content")] public string? Content { get; set; } @@ -383,7 +383,7 @@ public record JobRequirementCustomizedOption /// /// 选项 ID /// 必填：否 - /// 示例值：AA + /// 示例值：serious /// [JsonPropertyName("key")] public string? Key { get; set; } @@ -401,17 +401,17 @@ public record JobRequirementCustomizedOption public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：严重 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：serious /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -438,24 +438,24 @@ public record I18n public record JobRequirementCustomizedTimeRange { /// - /// 开始时间，毫秒级时间戳 + /// 开始时间，毫秒时间戳 /// 必填：否 - /// 示例值：AA + /// 示例值：1625729379000 /// [JsonPropertyName("start_time")] public string? StartTime { get; set; } /// - /// 结束时间，毫秒级时间戳 + /// 结束时间，毫秒时间戳 /// 必填：否 - /// 示例值：AA + /// 示例值：1625729380000 /// [JsonPropertyName("end_time")] public string? EndTime { get; set; } } /// - /// 当字段类型为日期选择、月份选择、年份选择时，从此字段取值，该字段是毫秒级时间戳 + /// 当字段类型为日期选择、月份选择、年份选择时，从此字段取值，该字段是毫秒时间戳 /// 必填：否 /// 示例值：1625456721000 /// @@ -465,7 +465,7 @@ public record JobRequirementCustomizedTimeRange /// /// 当字段类型为数字时，从此字段取值 /// 必填：否 - /// 示例值：111 + /// 示例值：100 /// [JsonPropertyName("number")] public string? Number { get; set; } @@ -524,7 +524,7 @@ public record JobTypeInfo public record I18n { /// - /// 职位类别中文名称 + /// 中文名称 /// 必填：否 /// 示例值：金融 /// @@ -532,7 +532,7 @@ public record I18n public string? ZhCn { get; set; } /// - /// 职位类别英文名称 + /// 英文名称 /// 必填：否 /// 示例值：finance /// diff --git a/src/Hire/PostHireV1ReferralsSearchBodyDto.cs b/src/Hire/PostHireV1ReferralsSearchBodyDto.cs index 6cfd5ab0..14c10e69 100644 --- a/src/Hire/PostHireV1ReferralsSearchBodyDto.cs +++ b/src/Hire/PostHireV1ReferralsSearchBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 查询人才内推信息 请求体 -/// 查询人才内推信息，按内推投递的「创建时间」正向排序 +/// 根据人才查询内推信息列表，包含内推人信息、内推时间、投递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/server-docs/hire-v1/candidate-management/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 4492331e..445a42c1 100644 --- a/src/Hire/PostHireV1ReferralsSearchResponseDto.cs +++ b/src/Hire/PostHireV1ReferralsSearchResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 查询人才内推信息 响应体 -/// 查询人才内推信息，按内推投递的「创建时间」正向排序 +/// 根据人才查询内推信息列表，包含内推人信息、内推时间、投递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 @@ -34,7 +34,7 @@ public record PostHireV1ReferralsSearchResponseDto public record ReferralInfo { /// - /// 内推的 ID + /// 内推 ID /// 必填：否 /// 示例值：6930815272790114322 /// @@ -42,17 +42,16 @@ public record ReferralInfo public string? Id { get; set; } /// - /// 投递 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")] public string[]? ApplicationIds { get; set; } /// - /// 创建时间（ms） + /// 内推创建时间，毫秒时间戳 /// 必填：否 /// 示例值：1618899376474 /// @@ -72,7 +71,7 @@ public record ReferralInfo public record IdNameObject { /// - /// 内推人ID + /// 内推人ID，跟`user_id_type`类型一致 /// 必填：否 /// 示例值：6930815272790114324 /// @@ -80,29 +79,29 @@ public record IdNameObject public string? Id { get; set; } /// - /// 名称 + /// 内推人名称 /// 必填：否 /// [JsonPropertyName("name")] public I18n? Name { get; set; } /// - /// 名称 + /// 内推人名称 /// public record I18n { /// - /// 中文 + /// 中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：张三 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：zhangsan /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } diff --git a/src/Hire/PutHireV1JobRequirementsByJobRequirementIdBodyDto.cs b/src/Hire/PutHireV1JobRequirementsByJobRequirementIdBodyDto.cs index e9d7659c..351b4865 100644 --- a/src/Hire/PutHireV1JobRequirementsByJobRequirementIdBodyDto.cs +++ b/src/Hire/PutHireV1JobRequirementsByJobRequirementIdBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 更新招聘需求 请求体 -/// 更新招聘需求 +/// 更新指定招聘需求的信息，包含招聘需求的名称、状态、需求人数等。 /// 接口ID：6989078472837169155 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/recruitment-related-configuration/job_requirement/update /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2fjob_requirement%2fupdate @@ -24,7 +24,7 @@ public record PutHireV1JobRequirementsByJobRequirementIdBodyDto /// /// 需求名称 /// 必填：是 - /// 示例值：test + /// 示例值：HR部门春季招聘需求 /// [JsonPropertyName("name")] public string Name { get; set; } = string.Empty; @@ -54,7 +54,8 @@ public record PutHireV1JobRequirementsByJobRequirementIdBodyDto public int HeadCount { get; set; } /// - /// 职位性质 ID，可在「招聘枚举常量」文档中查看枚举值，即将下线，请尽快切换至「employee_type_id」字段,与「employee_type_id」必填其一 + /// 职位性质 ID，可在[枚举常量介绍](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/enum)查阅枚举值。 + /// - **注意**：该字段即将下线，请使用「employee_type_id」字段。与「employee_type_id」字段必填其一 /// 必填：否 /// 示例值：101 /// @@ -62,8 +63,7 @@ public record PutHireV1JobRequirementsByJobRequirementIdBodyDto public string? RecruitmentTypeId { get; set; } /// - /// 人员类型ID - /// 获取枚举详情见本文档「查询参数」部分；使用该字段前，请联系招聘团队确认已在灰度内 + /// 人员类型ID，类型需与`employee_type_id_type`保持一致 /// 必填：否 /// 示例值：6807409776231254285 /// @@ -71,26 +71,23 @@ public record PutHireV1JobRequirementsByJobRequirementIdBodyDto public string? EmployeeTypeId { get; set; } /// - /// 最高职级 ID - /// 获取枚举详情见本文档「查询参数」部分 + /// 最高职级 ID，需与`job_level_id_type`类型保持一致 /// 必填：否 - /// 示例值：6807409776231254285 + /// 示例值：6807409776231254286 /// [JsonPropertyName("max_level_id")] public string? MaxLevelId { get; set; } /// - /// 最低职级 ID - /// 获取枚举详情见本文档「查询参数」部分 + /// 最低职级 ID，需与`job_level_id_type`类型保持一致 /// 必填：否 - /// 示例值：6911957338526091534 + /// 示例值：6807409776231254287 /// [JsonPropertyName("min_level_id")] public string? MinLevelId { get; set; } /// - /// 职位序列 ID - /// 获取枚举详情见本文档「查询参数」部分 + /// 职位序列 ID，需与`job_family_id_type`类型保持一致 /// 必填：否 /// 示例值：6911957338526091536 /// @@ -110,7 +107,7 @@ public record PutHireV1JobRequirementsByJobRequirementIdBodyDto public int? Category { get; set; } /// - /// 需求部门的 open department id + /// 需求部门ID，需与`department_id_type`类型一致 /// 必填：否 /// 示例值：od-4e6ac4d14bcd5071a37a39de902c7141 /// @@ -118,7 +115,7 @@ public record PutHireV1JobRequirementsByJobRequirementIdBodyDto public string? DepartmentId { get; set; } /// - /// 需求负责人 ID 列表 + /// 需求负责人 ID 列表，需与`user_id_type`类型保持一致 /// 必填：否 /// 示例值：ou_7dab8a3d3cdcc9da365777c7ad535d62 /// @@ -126,14 +123,14 @@ public record PutHireV1JobRequirementsByJobRequirementIdBodyDto public string[]? RecruiterIdList { get; set; } /// - /// 需求用人经理 ID 列表 + /// 需求用人经理 ID 列表，需与`user_id_type`类型保持一致 /// 必填：否 /// [JsonPropertyName("jr_hiring_manager_id_list")] public string[]? JrHiringManagerIdList { get; set; } /// - /// 直属上级 ID + /// 直属上级 ID，需与`user_id_type`类型保持一致 /// 必填：否 /// 示例值：ou_7dab8a3d3cdcc9da365777c7ad535d62 /// @@ -141,7 +138,7 @@ public record PutHireV1JobRequirementsByJobRequirementIdBodyDto public string[]? DirectLeaderIdList { get; set; } /// - /// 开始日期，毫秒级时间戳 + /// 开始日期，毫秒时间戳 /// 必填：否 /// 示例值：1625729379000 /// @@ -149,7 +146,7 @@ public record PutHireV1JobRequirementsByJobRequirementIdBodyDto public string? StartTime { get; set; } /// - /// 预计完成日期，毫秒级时间戳 + /// 预计完成日期，毫秒时间戳 /// 必填：否 /// 示例值：1625729379000 /// @@ -189,7 +186,7 @@ public record PutHireV1JobRequirementsByJobRequirementIdBodyDto public int? RequiredDegree { get; set; } /// - /// 最高薪资，单位：千 + /// 最高薪资，单位：K /// 必填：否 /// 示例值：10 /// @@ -197,17 +194,17 @@ public record PutHireV1JobRequirementsByJobRequirementIdBodyDto public string? MaxSalary { get; set; } /// - /// 最低薪资，单位：千 + /// 最低薪资，单位：K /// 必填：否 - /// 示例值：15 + /// 示例值：5 /// [JsonPropertyName("min_salary")] public string? MinSalary { get; set; } /// - /// 工作地点 ID，枚举值可通过「获取地址列表」接口查询获得 + /// 工作地点 ID，可通过[获取地址列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/list)获取 /// 必填：否 - /// 示例值：11 + /// 示例值：7265901641899311105 /// [JsonPropertyName("address_id")] public string? AddressId { get; set; } @@ -215,25 +212,25 @@ public record PutHireV1JobRequirementsByJobRequirementIdBodyDto /// /// 需求描述 /// 必填：否 - /// 示例值：11 + /// 示例值：部门人力紧缺，需要招聘资深工程师10名 /// [JsonPropertyName("description")] public string? Description { get; set; } /// - /// 自定义字段 + /// 自定义字段，可通过[获取招聘需求模板](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)获取，自定义字段是否必填需依据需求模板中自定义字段的定义 /// public record JobRequirementCustomizedData { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取招聘需求模板](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_requirement_schema/list)获取 /// 必填：否 /// 示例值：1213213123123 /// @@ -241,21 +238,25 @@ public record JobRequirementCustomizedData public string? ObjectId { get; set; } /// - /// 自定义字段 value，1. 对于自定义字段，若字段类型为单行文本/多行文本，传值格式为"这是一个文本"；2. 若字段类型为单选，传值内容为选项的 ID，格式为"6890840516938696974"； + /// 自定义字段 value + /// 1. 若字段类型为单行文本/多行文本，格式为"简单文本"； + /// 2. 若字段类型为单选，传值内容为选项的 ID，格式为"6890840516938696974"； /// 3. 若字段类型为多选，传值内容为选项的ID 列表，格式为"[\"6890840516938696974\", \"6890840516938696975\" ]"； - /// 4. 若字段类型为时间段，传值格式为"[\"1609430400000\", \"1612108800000\" ]"，单位是毫米级时间戳； - /// 5. 若字段类型为年份选择，传值格式为"1609430400000"，单位是毫秒级时间戳； - /// 6. 若字段类型为月份选择，传值格式为"1625068800000"，单位是毫秒级时间戳； + /// 4. 若字段类型为时间，格式为"1609430400000" + /// 5. 若字段类型为时间段，格式为"["1609430400000", \"1612108800000\" ]"，单位是毫秒时间戳； + /// 5. 若字段类型为年份选择，格式为"1609430400000"，单位是毫秒时间戳； + /// 6. 若字段类型为月份选择，格式为"1625068800000"，单位是毫秒时间戳； /// 7. 若字段类型为数字，传值格式为"1"; + /// 8. 若字段类型为富文本，传值举例"富文本" /// 必填：否 - /// 示例值：测试 + /// 示例值：简单文本 /// [JsonPropertyName("value")] public string? Value { get; set; } } /// - /// 招聘类型，是否必填以「获取招聘需求模板」中字段限制为准，通过招聘需求新建职位时会根据此字段回填职位招聘类型 + /// 招聘类型 /// 必填：否 /// 示例值：1 /// 可选值： @@ -267,7 +268,7 @@ public record JobRequirementCustomizedData public int? ProcessType { get; set; } /// - /// 职位类别，枚举值通过「获取职位类别列表」接口获取，是否必填以「获取招聘需求模板」中字段限制为准，通过招聘需求新建职位时会根据此字段回填职位类别 + /// 职位类别，可通过[获取职位类别列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_type/list)获取 /// 必填：否 /// 示例值：6930815272790114324 /// diff --git a/src/Hire/PutHireV1OfferCustomFieldsByOfferCustomFieldIdBodyDto.cs b/src/Hire/PutHireV1OfferCustomFieldsByOfferCustomFieldIdBodyDto.cs index 51988d3c..332e4688 100644 --- a/src/Hire/PutHireV1OfferCustomFieldsByOfferCustomFieldIdBodyDto.cs +++ b/src/Hire/PutHireV1OfferCustomFieldsByOfferCustomFieldIdBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 更新 Offer 申请表自定义字段 请求体 -/// 本接口支持修改 Offer 申请表的自定义字段，Offer 申请表的定义可参考「飞书招聘」-「设置」-「Offer 申请表设置」中的内容。 +/// 本接口支持修改 Offer 申请表的自定义字段，Offer 申请表的定义可参考「飞书招聘」-「设置」-「Offer 设置」-「Offer 申请表设置」中的内容。 /// 接口ID：7109767413990866947 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/recruitment-related-configuration/offer-settings/offer_application_form/update /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2foffer_custom_field%2fupdate diff --git a/src/IFeishuTenantApi.cs b/src/IFeishuTenantApi.cs index d1746947..cbe940e5 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-02 +// Last Modified On : 2024-08-08 // ************************************************************************ // // MIT @@ -2238,6 +2238,133 @@ System.Threading.Tasks.Task PostDocV2ByDocTokenBatchUpdateAsync( System.Threading.Tasks.Task> PostApprovalOpenapiV2ExternalListAsync( [JsonContent] Approval.Spec.PostApprovalOpenapiV2ExternalListBodyDto dto); + /// + /// 【管理后台】获取行为审计日志数据 + /// 接口ID：6921713375245352988 + /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uQjM5YjL0ITO24CNykjN/audit_log/audit_data_get + /// Authorization：tenant_access_token + /// 该接口用于查询成员的操作行为日志。行为审计日志中记录了成员进行操作的时间、地点、操作对象等信息。通过查询成员行为日志，管理员可以发现成员是否有违规操作，以保护企业数据和信息安全。 + /// - 性能说明：查询时请适当缩短查询时间范围和适当控制查询频次（避免重复的无效查询等情况） + /// 权限要求： + /// admin:audit_info:readonly + /// + /// 字段权限要求： + /// contact:user.employee_id:readonly + /// + /// + /// + /// 必填：否 + /// 用户 ID 类型 + /// **示例值**：user_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) + /// **默认值**：`user_id` + /// **当值为 `user_id`，字段权限要求**： + /// <md-perm name="contact:user.employee_id:readonly" desc="获取用户 user ID" support_app_types="custom" tags="">获取用户 user ID</md-perm> + /// + /// open_id：标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。[了解更多：如何获取 Open ID](/ssl + /// union_id：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。[了解更多：如何获取 Union ID？](/ssl + /// user_id：标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。[了解更多：如何获取 User ID？](/ssl + /// + /// 默认值：open_id + /// + /// + /// 必填：否 + /// 日志时间范围： 结束时间。格式： 秒级时间戳。默认值： 此刻。起止日期之间相差不能超过30天 + /// **示例值**：1668700799 + /// 默认值：null + /// + /// + /// 必填：否 + /// 日志时间范围： 起始时间。格式： 秒级时间戳。默认值：30日前此刻。起止日期之间相差不能超过30天 + /// **示例值**：1668528000 + /// 默认值：null + /// + /// + /// 必填：否 + /// 行为审计的事件名称，可选事件名称见[枚举值列表](https://open.feishu.cn/document/ukTMukTMukTM/uQjM5YjL0ITO24CNykjN/audit_log/appendix) + /// **示例值**：space_create_doc + /// 默认值：null + /// + /// + /// 必填：否 + /// 过滤操作者: 操作者类型。 与 operator_value 配合使用，当填写operator_value时，此项必填 + /// **示例值**：user + /// **可选值有**： + /// user:用户,bot:[当前未开放] 以bot_id来识别用户 + /// + /// user：用户 + /// bot：[当前未开放] 以bot_id来识别用户 + /// + /// 默认值：null + /// + /// + /// 必填：否 + /// 操作者值 + /// **示例值**：55ed16fe + /// 默认值：null + /// + /// + /// 必填：否 + /// 行为审计的事件模块，可选事件模块见[枚举值列表](https://open.feishu.cn/document/ukTMukTMukTM/uQjM5YjL0ITO24CNykjN/audit_log/appendix) + /// **示例值**：1 + /// 默认值：null + /// + /// + /// 必填：否 + /// 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果 + /// **示例值**：LC39/f1%2B/Sz9Uv39Gf39/ew/cd5WY0gfGYFdixOW9cVk4bC79ituO/gx0qpPn1bYf92nz/kI0nNJOG3wCwDJKoNU%2BtyaXbpI8pV/9UNDMZT0BNeyanFH17Wv711Qh9anR3l2GjQfc2fUqXtxg1YPp63XyhYY4iRMv54ySRG7r%2BI89iS3zAoPzFuuU1MUJKsf + /// 默认值：null + /// + /// + /// 必填：否 + /// 分页大小 + /// **示例值**：20 + /// **默认值**：`20` + /// **数据校验规则**： + /// - 取值范围：`1` ～ `200` + /// 默认值：10 + /// + /// + /// 必填：否 + /// 用户类型 + /// **示例值**：1 + /// **可选值有**： + /// 0:互联网上的任何人,1:组织内成员,2:组织外成员 + /// + /// 0：互联网上的任何人 + /// 1：组织内成员 + /// 2：组织外成员 + /// + /// 默认值：null + /// + /// + /// 必填：否 + /// 过滤操作对象: 操作对象类型. 与object_value配合使用 + /// **示例值**：1 + /// 默认值：null + /// + /// + /// 必填：否 + /// 过滤操作对象: 操作对象ID. 与object_type配合使用 + /// **示例值**：55ed16fe + /// 默认值：null + /// + [HttpGet("/open-apis/admin/v1/audit_infos")] + System.Threading.Tasks.Task> GetAdminV1AuditInfosAsync( + [PathQuery] string? user_id_type = "open_id", + [PathQuery] int? latest = null, + [PathQuery] int? oldest = null, + [PathQuery] string? event_name = null, + [PathQuery] string? operator_type = null, + [PathQuery] string? operator_value = null, + [PathQuery] int? event_module = null, + [PathQuery] string? page_token = null, + [PathQuery] int? page_size = 10, + [PathQuery] int? user_type = null, + [PathQuery] int? object_type = null, + [PathQuery] string? object_value = null); + /// /// 【视频会议】获取 Top 用户列表 /// 接口ID：6921909217674723355 @@ -3545,6 +3672,7 @@ System.Threading.Tasks.Task DeleteContactV3UsersByUserIdAsync( /// 示例值：10 /// 默认值：20 /// + [Obsolete("历史版本")] [HttpGet("/open-apis/contact/v3/departments")] System.Threading.Tasks.Task> GetContactV3DepartmentsAsync( [PathQuery] string? user_id_type = "open_id", @@ -5618,6 +5746,7 @@ System.Threading.Tasks.Task PutImV1ChatsByChatIdModerationAsync( /// 示例值：true /// 默认值：null /// + [Obsolete("历史版本")] [HttpGet("/open-apis/bitable/v1/apps/{app_token}/tables/{table_id}/records/{record_id}")] System.Threading.Tasks.Task> GetBitableV1AppsByAppTokenTablesByTableIdRecordsByRecordIdAsync( [PathQuery] string app_token, @@ -6366,8 +6495,8 @@ System.Threading.Tasks.Task DeleteCalendarV4CalendarsByCalendarI /// /// 路径参数 /// 必填：是 - /// 日程 ID。 - /// 创建日程时会返回日程 ID。你也可以调用以下接口获取某一日历的 ID。 + /// 日程 ID。获取方式： + /// - [创建日程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/create)会返回日程 ID /// - [获取日程列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/list) /// - [搜索日程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/search) /// 示例值：xxxxxxxxx_0 @@ -9956,7 +10085,7 @@ System.Threading.Tasks.Task DeleteVcV1ReservesByReserveIdAsync( /// 接口ID：6964264269274595330 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/referral/get_by_application /// Authorization：tenant_access_token - /// 根据投递 ID 获取内推信息。 + /// 根据投递 ID 获取内推信息，包含内推人信息、内推创建时间等。 /// 权限要求： /// hire:referral /// hire:referral:readonly @@ -9967,7 +10096,7 @@ System.Threading.Tasks.Task DeleteVcV1ReservesByReserveIdAsync( /// /// /// 必填：是 - /// 投递的 ID + /// 投递 ID，可通过[获取投递列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/list)获取 /// 示例值：6134134355464633 /// /// @@ -10519,7 +10648,7 @@ System.Threading.Tasks.Task PostHireV1ApplicationsByApplicationI /// 接口ID：6965472560995041282 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/agency/protect /// Authorization：tenant_access_token - /// 设置猎头保护期。 + /// 设置指定人才的猎头保护期，当「飞书招聘」内置的保护期功能不满足需求时，客户可通过此接口自定义人才的保护期。 /// 权限要求： /// hire:agency /// @@ -10550,7 +10679,7 @@ System.Threading.Tasks.Task PostHireV1AgenciesProtectAsync( /// 接口ID：6965472560995057666 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/agency/get /// Authorization：tenant_access_token - /// 根据猎头供应商 ID 获取猎头供应商信息。 + /// 根据猎头供应商 ID 获取有合作关系的猎头供应商信息，包含猎头供应商ID、名称、联系人等。 /// 权限要求： /// hire:agency /// hire:agency:readonly @@ -10587,7 +10716,7 @@ System.Threading.Tasks.Task PostHireV1AgenciesProtectAsync( /// 接口ID：6965472560995074050 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/agency/query /// Authorization：tenant_access_token - /// 根据猎头供应商名称查询猎头供应商信息。 + /// 根据猎头供应商名称查询有合作关系的猎头供应商信息，包含猎头供应商ID、名称、联系人等。 /// 权限要求： /// hire:agency /// hire:agency:readonly @@ -10598,7 +10727,7 @@ System.Threading.Tasks.Task PostHireV1AgenciesProtectAsync( /// /// /// 必填：是 - /// 猎头供应商名称 + /// 猎头供应商名称，精准匹配查询(区分大小写) /// 示例值：超越猎头公司 /// /// @@ -13150,7 +13279,7 @@ System.Threading.Tasks.Task PostHireV1ApplicationsByApplicationI /// 接口ID：6989078472837169155 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_requirement/update /// Authorization：tenant_access_token - /// 更新招聘需求 + /// 更新指定招聘需求的信息，包含招聘需求的名称、状态、需求人数等。 /// 权限要求： /// hire:job_requirement /// @@ -13161,8 +13290,8 @@ System.Threading.Tasks.Task PostHireV1ApplicationsByApplicationI /// /// 路径参数 /// 必填：是 - /// 招聘需求ID - /// 示例值：623455234 + /// 招聘需求ID，可通过[获取招聘需求列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_requirement/list)获取 + /// 示例值：6949805467799537964 /// /// /// 必填：否 @@ -13188,20 +13317,20 @@ System.Threading.Tasks.Task PostHireV1ApplicationsByApplicationI /// /// 必填：否 /// 此次调用中使用的「职级 ID」的类型 - /// 示例值：6942778198054125570 + /// 示例值：job_level_id /// /// 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 /// /// /// 必填：否 /// 此次调用中使用的「序列 ID」的类型 - /// 示例值：6942778198054125571 + /// 示例值：job_family_id /// /// 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 /// @@ -13211,7 +13340,7 @@ System.Threading.Tasks.Task PostHireV1ApplicationsByApplicationI /// 示例值：employee_type_enum_id /// /// 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 /// @@ -13245,7 +13374,7 @@ System.Threading.Tasks.Task PutHireV1JobRequirementsByJobRequire /// 接口ID：6989078472837201923 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_requirement/delete /// Authorization：tenant_access_token - /// 删除招聘需求。 + /// 删除指定的招聘需求，请注意：若该招聘需求已经关联到职位上，则需先接触关联后，才能删除招聘需求。 /// 权限要求： /// hire:job_requirement /// @@ -13253,8 +13382,8 @@ System.Threading.Tasks.Task PutHireV1JobRequirementsByJobRequire /// /// 路径参数 /// 必填：是 - /// 招聘需求 ID - /// 示例值：1616161616 + /// 招聘需求ID，可通过[获取招聘需求列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_requirement/list)获取 + /// 示例值：6949805467799537964 /// [HttpDelete("/open-apis/hire/v1/job_requirements/{job_requirement_id}")] System.Threading.Tasks.Task DeleteHireV1JobRequirementsByJobRequirementIdAsync( @@ -13383,11 +13512,11 @@ System.Threading.Tasks.Task DeleteHireV1JobRequirementsByJobRequ [PathQuery] string? employee_type_id_type = "people_admin_employee_type_id"); /// - /// 【招聘】获取招聘需求模板 + /// 【招聘】获取招聘需求模板列表 /// 接口ID：6989078472837234691 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_requirement_schema/list /// Authorization：tenant_access_token - /// 获取招聘需求模板。 + /// 获取招聘需求模板列表，包含需求模板ID，以及模板里的字段定义等。 /// 权限要求： /// hire:job_requirement /// hire:job_requirement:readonly @@ -13396,7 +13525,7 @@ System.Threading.Tasks.Task DeleteHireV1JobRequirementsByJobRequ /// /// 必填：否 /// 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果 - /// 示例值：1231231987 + /// 示例值：eyJvZmZzZXQiOjEwLCJ0aW1NTUyMjM2NzIsImlkIjpudWxsfQ /// 默认值：null /// /// @@ -13482,7 +13611,7 @@ System.Threading.Tasks.Task DeleteHireV1JobRequirementsByJobRequ /// /// /// 必填：否 - /// 面试 ID，可通过[获取面试信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/interview/list)接口获取，（不允许 application_id、interview_id、start_time、end_time 同时为空） + /// 面试 ID（不允许 application_id、interview_id、start_time、end_time 同时为空） /// 示例值：6888217964693309704 /// 默认值：null /// @@ -13535,7 +13664,7 @@ System.Threading.Tasks.Task DeleteHireV1JobRequirementsByJobRequ /// 接口ID：6989078472837283843 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_requirement/create /// Authorization：tenant_access_token - /// 创建招聘需求，除招聘需求编号为必填外，其他字段是否必填与飞书招聘「招聘需求字段管理」内设置一致。 + /// 创建招聘需求，可指定招聘需求部门、招聘人数、需求描述等，具体可参考「飞书招聘」-「设置」-「招聘需求字段管理」，或者参考[获取招聘需求模板](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_requirement_schema/list)。 /// 权限要求： /// hire:job_requirement /// @@ -13567,20 +13696,20 @@ System.Threading.Tasks.Task DeleteHireV1JobRequirementsByJobRequ /// /// 必填：否 /// 此次调用中使用的「职级 ID」的类型 - /// 示例值：6942778198054125570 + /// 示例值：job_level_id /// /// 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 /// /// /// 必填：否 /// 此次调用中使用的「序列 ID」的类型 - /// 示例值：6942778198054125571 + /// 示例值：job_family_id /// /// 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 /// @@ -13590,7 +13719,7 @@ System.Threading.Tasks.Task DeleteHireV1JobRequirementsByJobRequ /// 示例值：employee_type_enum_id /// /// 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 /// @@ -14293,7 +14422,7 @@ System.Threading.Tasks.Task PatchApplicationV6ApplicationsByAppI /// /// position_location：职位地址 /// interview_location：面试地址 - /// store_location：门店地址 + /// store_location：门店地址。当前仅支持未接入飞书人事的租户使用 /// /// [HttpGet("/open-apis/hire/v1/locations")] @@ -15992,6 +16121,7 @@ System.Threading.Tasks.Task PostHireV1AdvertisementsByAdvertisem /// 默认值：open_id /// /// 请求体 + [Obsolete("迁移至新版本：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/lingo-v1/draft/create")] [HttpPost("/open-apis/baike/v1/drafts")] System.Threading.Tasks.Task> PostBaikeV1DraftsAsync( [JsonContent] Baike.PostBaikeV1DraftsBodyDto dto, @@ -16029,6 +16159,7 @@ System.Threading.Tasks.Task PostHireV1AdvertisementsByAdvertisem /// 默认值：open_id /// /// 请求体 + [Obsolete("迁移至新版本：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/lingo-v1/draft/update")] [HttpPut("/open-apis/baike/v1/drafts/{draft_id}")] System.Threading.Tasks.Task> PutBaikeV1DraftsByDraftIdAsync( [PathQuery] string draft_id, @@ -16079,6 +16210,7 @@ System.Threading.Tasks.Task PostHireV1AdvertisementsByAdvertisem /// /// 默认值：open_id /// + [Obsolete("迁移至新版本：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/lingo-v1/entity/get")] [HttpGet("/open-apis/baike/v1/entities/{entity_id}")] System.Threading.Tasks.Task> GetBaikeV1EntitiesByEntityIdAsync( [PathQuery] string entity_id, @@ -16130,6 +16262,7 @@ System.Threading.Tasks.Task PostHireV1AdvertisementsByAdvertisem /// /// 默认值：open_id /// + [Obsolete("迁移至新版本：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/lingo-v1/entity/list")] [HttpGet("/open-apis/baike/v1/entities")] System.Threading.Tasks.Task> GetBaikeV1EntitiesAsync( [PathQuery] int? page_size = 20, @@ -16150,6 +16283,7 @@ System.Threading.Tasks.Task PostHireV1AdvertisementsByAdvertisem /// /// /// 请求体 + [Obsolete("迁移至新版本：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/lingo-v1/entity/match")] [HttpPost("/open-apis/baike/v1/entities/match")] System.Threading.Tasks.Task> PostBaikeV1EntitiesMatchAsync( [JsonContent] Baike.PostBaikeV1EntitiesMatchBodyDto dto); @@ -16193,6 +16327,7 @@ System.Threading.Tasks.Task PostHireV1AdvertisementsByAdvertisem /// 默认值：open_id /// /// 请求体 + [Obsolete("迁移至新版本：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/lingo-v1/entity/search")] [HttpPost("/open-apis/baike/v1/entities/search")] System.Threading.Tasks.Task> PostBaikeV1EntitiesSearchAsync( [JsonContent] Baike.PostBaikeV1EntitiesSearchBodyDto dto, @@ -16213,6 +16348,7 @@ System.Threading.Tasks.Task PostHireV1AdvertisementsByAdvertisem /// /// /// 请求体 + [Obsolete("迁移至新版本：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/lingo-v1/entity/highlight")] [HttpPost("/open-apis/baike/v1/entities/highlight")] System.Threading.Tasks.Task> PostBaikeV1EntitiesHighlightAsync( [JsonContent] Baike.PostBaikeV1EntitiesHighlightBodyDto dto); @@ -17008,7 +17144,7 @@ System.Threading.Tasks.Task DeleteCorehrV1ContractsByContractIdA /// 示例值：7110120266637772332 /// 默认值：null /// - [Obsolete("迁移至新版本：https://open.feishu.cn/documenthttps://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/pre_hire/query")] + [Obsolete("迁移至新版本：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/pre_hire/query")] [HttpGet("/open-apis/corehr/v1/pre_hires")] System.Threading.Tasks.Task> GetCorehrV1PreHiresAsync( [PathQuery] string? page_token = null, @@ -17273,7 +17409,7 @@ System.Threading.Tasks.Task DeleteCorehrV1ContractsByContractIdA /// 待入职ID，可从[搜索待入职人员信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/pre_hire/search)接口获取 /// 示例值：121215 /// - [Obsolete("迁移至新版本：https://open.feishu.cn/documenthttps://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/pre_hire/query")] + [Obsolete("迁移至新版本：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/pre_hire/query")] [HttpGet("/open-apis/corehr/v1/pre_hires/{pre_hire_id}")] System.Threading.Tasks.Task> GetCorehrV1PreHiresByPreHireIdAsync( [PathQuery] string pre_hire_id); @@ -19411,11 +19547,11 @@ System.Threading.Tasks.Task PostImV1ChatsByChatIdTopNoticeDelete /// /// /// 必填：是 - /// 请求体和响应体中的 user_id 的员工工号类型 + /// 响应体中的 user_id 的员工ID类型。如果没有后台管理权限，可使用[通过手机号或邮箱获取用户 ID](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/batch_get_id) /// 示例值：employee_id /// - /// employee_id：员工 employee ID，即飞书管理后台 > 组织架构 > 成员与部门 > 成员详情中的用户 ID - /// employee_no：员工工号，即飞书管理后台 > 组织架构 > 成员与部门 > 成员详情中的工号 + /// employee_id：员工 employee ID，即[飞书管理后台](https://example.feishu.cn/admin/contacts/departmentanduser) > 组织架构 > 成员与部门 > 成员详情中的用户 ID + /// employee_no：员工工号，即[飞书管理后台](https://example.feishu.cn/admin/contacts/departmentanduser) > 组织架构 > 成员与部门 > 成员详情中的工号 /// /// /// 请求体 @@ -19639,7 +19775,7 @@ System.Threading.Tasks.Task PostImV1ChatsByChatIdTopNoticeDelete /// 接口ID：7044467124773650433 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_stats_view/update /// Authorization：tenant_access_token - /// 更新开发者定制的日度统计或月度统计的统计报表表头设置信息。 + /// 更新开发者定制的日度统计或月度统计的统计报表表头设置信息。报表的表头信息可以在考勤统计-[报表](https://example.feishu.cn/people/workforce-management/manage/statistics/report)中查询到具体的报表信息，此接口专门用于更新表头信息。 /// 权限要求： /// attendance:task /// @@ -19652,11 +19788,11 @@ System.Threading.Tasks.Task PostImV1ChatsByChatIdTopNoticeDelete /// /// /// 必填：是 - /// 员工工号类型 + /// 响应体中的 user_id 的员工ID类型。如果没有后台管理权限，可使用[通过手机号或邮箱获取用户 ID](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/batch_get_id) /// 示例值：employee_id /// - /// employee_id：员工 employee ID，即飞书管理后台 > 组织架构 > 成员与部门 > 成员详情中的用户 ID - /// employee_no：员工工号，即飞书管理后台 > 组织架构 > 成员与部门 > 成员详情中的工号 + /// employee_id：员工 employee ID，即[飞书管理后台](https://example.feishu.cn/admin/contacts/departmentanduser) > 组织架构 > 成员与部门 > 成员详情中的用户 ID + /// employee_no：员工工号，即[飞书管理后台](https://example.feishu.cn/admin/contacts/departmentanduser) > 组织架构 > 成员与部门 > 成员详情中的工号 /// /// /// 请求体 @@ -19759,11 +19895,11 @@ System.Threading.Tasks.Task DeleteAttendanceV1GroupsByGroupIdAsy /// /// /// 必填：是 - /// 请求体和响应体中的 user_id 的员工工号类型 + /// 响应体中的 user_id 的员工ID类型。如果没有后台管理权限，可使用[通过手机号或邮箱获取用户 ID](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/batch_get_id) /// 示例值：employee_id /// - /// employee_id：员工 employee ID，即飞书管理后台 > 组织架构 > 成员与部门 > 成员详情中的用户 ID - /// employee_no：员工工号，即飞书管理后台 > 组织架构 > 成员与部门 > 成员详情中的工号 + /// employee_id：员工 employee ID，即[飞书管理后台](https://example.feishu.cn/admin/contacts/departmentanduser) > 组织架构 > 成员与部门 > 成员详情中的用户 ID + /// employee_no：员工工号，即[飞书管理后台](https://example.feishu.cn/admin/contacts/departmentanduser) > 组织架构 > 成员与部门 > 成员详情中的工号 /// /// /// 请求体 @@ -21032,7 +21168,7 @@ System.Threading.Tasks.Task DeleteCorehrV1EmploymentsByEmploymen /// 接口ID：7072642400195723292 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_data/patch /// Authorization：tenant_access_token - /// 更新任职信息 + /// 默认为新增一条任职记录，包括职务、职级、序列、部门等信息。 /// 权限要求： /// corehr:corehr /// corehr:job_data:write @@ -21079,6 +21215,17 @@ System.Threading.Tasks.Task DeleteCorehrV1EmploymentsByEmploymen /// /// 默认值：people_corehr_department_id /// + /// + /// 必填：否 + /// 是否强校验。值为 true 时，会对入参进行业务校验，并产生异动记录、发送异动事件。 + /// - 默认值：false + /// - 仅在新增任职版本时生效，即当 version_id 有值时该字段不生效 + /// - 使用此功能时，试用期相关字段不支持 + /// - 当响应返回的任职数据无变化时，请检查人事系统-异动管理 + /// - 功能灰度中，若需要请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 示例值：false + /// 默认值：null + /// /// 请求体 [HttpPatch("/open-apis/corehr/v1/job_datas/{job_data_id}")] System.Threading.Tasks.Task> PatchCorehrV1JobDatasByJobDataIdAsync( @@ -21086,7 +21233,8 @@ System.Threading.Tasks.Task DeleteCorehrV1EmploymentsByEmploymen [JsonContent] FeishuPeople.PatchCorehrV1JobDatasByJobDataIdBodyDto dto, [PathQuery] string? client_token = null, [PathQuery] string? user_id_type = "people_corehr_id", - [PathQuery] string? department_id_type = "people_corehr_department_id"); + [PathQuery] string? department_id_type = "people_corehr_department_id", + [PathQuery] string? strict_verify = null); /// /// 【飞书人事】删除国家证件类型 @@ -21657,7 +21805,7 @@ System.Threading.Tasks.Task DeleteCorehrV1CompaniesByCompanyIdAs /// 默认值：null /// /// 请求体 - [Obsolete("迁移至新版本：https://open.feishu.cn/documenthttps://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/pre_hire/patch")] + [Obsolete("迁移至新版本：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/pre_hire/patch")] [HttpPatch("/open-apis/corehr/v1/pre_hires/{pre_hire_id}")] System.Threading.Tasks.Task> PatchCorehrV1PreHiresByPreHireIdAsync( [PathQuery] string pre_hire_id, @@ -22292,6 +22440,7 @@ System.Threading.Tasks.Task PostAdminV1PasswordResetAsync( /// 默认值：open_id /// /// 请求体 + [Obsolete("迁移至新版本：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/lingo-v1/entity/create")] [HttpPost("/open-apis/baike/v1/entities")] System.Threading.Tasks.Task> PostBaikeV1EntitiesAsync( [JsonContent] Baike.PostBaikeV1EntitiesBodyDto dto, @@ -22329,6 +22478,7 @@ System.Threading.Tasks.Task PostAdminV1PasswordResetAsync( /// 默认值：open_id /// /// 请求体 + [Obsolete("迁移至新版本：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/lingo-v1/entity/update")] [HttpPut("/open-apis/baike/v1/entities/{entity_id}")] System.Threading.Tasks.Task> PutBaikeV1EntitiesByEntityIdAsync( [PathQuery] string entity_id, @@ -22360,6 +22510,7 @@ System.Threading.Tasks.Task PostAdminV1PasswordResetAsync( /// 示例值：408ecac018b2e3518db37275e812****bb8ad3e755fc886f322ac6c430ba /// 默认值：null /// + [Obsolete("迁移至新版本：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/lingo-v1/classification/list")] [HttpGet("/open-apis/baike/v1/classifications")] System.Threading.Tasks.Task> GetBaikeV1ClassificationsAsync( [PathQuery] int? page_size = 20, @@ -24588,7 +24739,7 @@ System.Threading.Tasks.Task PostWikiV2SpacesBySpaceIdNodesByNode /// 接口ID：7109767413990866947 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/offer_custom_field/update /// Authorization：tenant_access_token - /// 本接口支持修改 Offer 申请表的自定义字段，Offer 申请表的定义可参考「飞书招聘」-「设置」-「Offer 申请表设置」中的内容。 + /// 本接口支持修改 Offer 申请表的自定义字段，Offer 申请表的定义可参考「飞书招聘」-「设置」-「Offer 设置」-「Offer 申请表设置」中的内容。 /// 权限要求： /// hire:offer_selection_object /// @@ -26911,7 +27062,7 @@ System.Threading.Tasks.Task PostContactV3UsersByUserIdResurrectA /// 接口ID：7127187941650595843 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave_granting_record/delete /// Authorization：tenant_access_token - /// 删除飞书人事休假系统中的假期发放记录（仅支持删除发放来源是「手动发放」或「外部系统发放」的记录）。 + /// 删除飞书人事休假系统中的发放记录，假勤管理-休假管理-[发放记录](https://example.feishu.cn/people/workforce-management/manage/leave/leave_admin/granting_record)（仅支持删除发放来源是「手动发放」或「外部系统发放」的记录）。 /// 权限要求： /// corehr:corehr /// corehr:leave_granting_record:write @@ -26920,7 +27071,7 @@ System.Threading.Tasks.Task PostContactV3UsersByUserIdResurrectA /// /// 路径参数 /// 必填：是 - /// 假期发放记录 ID，从发放记录中可以获得 + /// 假期发放记录 ID，从[创建假期发放记录](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave_granting_record/create)中可以获得 /// 示例值：6893014062142064135 /// [HttpDelete("/open-apis/corehr/v1/leave_granting_records/{leave_granting_record_id}")] @@ -26932,7 +27083,7 @@ System.Threading.Tasks.Task DeleteCorehrV1LeaveGrantingRecordsBy /// 接口ID：7127187941650612227 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave_granting_record/create /// Authorization：tenant_access_token - /// 向飞书人事休假系统写入假期发放记录。 + /// 向飞书人事休假系统写入假期发放记录。对应假勤管理-休假管理-[发放记录](https://example.feishu.cn/people/workforce-management/manage/leave/leave_admin/granting_record)的创建或者导入功能 /// 权限要求： /// corehr:corehr /// corehr:leave_granting_record:write @@ -27091,6 +27242,7 @@ System.Threading.Tasks.Task PostApprovalV4TasksResubmitAsync( /// 必填：是 /// 二进制文件内容，高宽像素在 320-4096 像素之间，大小在 3KB-10MB 的图片 /// + [Obsolete("迁移至新版本：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/lingo-v1/file/upload")] [HttpPost("/open-apis/baike/v1/files/upload")] System.Threading.Tasks.Task> PostBaikeV1FilesUploadAsync( [FormDataContent] Baike.PostBaikeV1FilesUploadBodyDto dto, @@ -27115,6 +27267,7 @@ System.Threading.Tasks.Task PostApprovalV4TasksResubmitAsync( /// 示例值：boxbcEcmKiD3***vgqWTpvdc7jc /// /// 返回文件二进制流 + [Obsolete("迁移至新版本：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/lingo-v1/file/download")] [HttpGet("/open-apis/baike/v1/files/{file_token}/download")] System.Threading.Tasks.Task GetBaikeV1FilesByFileTokenDownloadAsync( [PathQuery] string file_token); @@ -27789,6 +27942,7 @@ System.Threading.Tasks.Task DeleteDriveV1FilesByFileTokenVersion /// /// /// 请求体 + [Obsolete("迁移至新版本：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/lingo-v1/entity/extract")] [HttpPost("/open-apis/baike/v1/entities/extract")] System.Threading.Tasks.Task> PostBaikeV1EntitiesExtractAsync( [JsonContent] Baike.PostBaikeV1EntitiesExtractBodyDto dto); @@ -30817,7 +30971,7 @@ System.Threading.Tasks.Task PutContactV3FunctionalRolesByRoleIdA /// 接口ID：7204730827112185860 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/referral_website-job_post/get /// Authorization：tenant_access_token - /// 根据广告 ID 获取内推官网下的职位广告详情。 + /// 根据职位广告 ID 获取内推官网下的职位广告详情，包含职位广告 ID 以及职位信息等。 /// 权限要求： /// hire:referral_website:readonly /// @@ -30828,7 +30982,7 @@ System.Threading.Tasks.Task PutContactV3FunctionalRolesByRoleIdA /// /// 路径参数 /// 必填：是 - /// 职位广告 ID + /// 职位广告 ID，可通过[获取内推官网下职位广告列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/referral_website-job_post/list)获取 /// 示例值：6701528341100366094 /// /// @@ -30855,10 +31009,10 @@ System.Threading.Tasks.Task PutContactV3FunctionalRolesByRoleIdA /// /// 必填：否 /// 此次调用中使用的「职级 ID」的类型 - /// 示例值：6942778198054125570 + /// 示例值：job_level_id /// /// 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 /// @@ -30870,11 +31024,11 @@ System.Threading.Tasks.Task PutContactV3FunctionalRolesByRoleIdA [PathQuery] string? job_level_id_type = "people_admin_job_level_id"); /// - /// 【招聘】获取内推官网下的职位列表 + /// 【招聘】获取内推官网下职位广告列表 /// 接口ID：7204730827112202244 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/referral_website-job_post/list /// Authorization：tenant_access_token - /// 获取内推官网下的职位列表。自定义数据暂不支持列表获取，请从「获取内推官网下职位广告详情」接口获取。 + /// 获取内推官网下的职位列表，包含职位广告ID、职位广告名称、职位信息等。 /// 权限要求： /// hire:referral_website:readonly /// @@ -30928,10 +31082,10 @@ System.Threading.Tasks.Task PutContactV3FunctionalRolesByRoleIdA /// /// 必填：否 /// 此次调用中使用的「职级 ID」的类型 - /// 示例值：6942778198054125570 + /// 示例值：job_level_id /// /// 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 /// @@ -32277,8 +32431,6 @@ System.Threading.Tasks.Task GetCorehrV1FilesByIdAsync( /// corehr:person.martyr_family:write /// corehr:person.national_id:read /// corehr:person.national_id:write - /// corehr:person.nationality:read - /// corehr:person.nationality:write /// corehr:person.native_region:read /// corehr:person.native_region:write /// corehr:person.personal_profile:read @@ -32298,7 +32450,7 @@ System.Threading.Tasks.Task GetCorehrV1FilesByIdAsync( /// 路径参数 /// 必填：是 /// 个人信息 ID - /// - 该 ID 在创建个人信息时可从响应体中获取（person_id） + /// - 该 ID 在[【创建个人信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/person/create)时可从响应体中获取（person_id） /// - 此外你也可以调用[【搜索员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search)接口，获取指定员工的 person_id。 /// 示例值：12454646 /// @@ -32370,10 +32522,9 @@ System.Threading.Tasks.Task GetCorehrV1FilesByIdAsync( /// corehr:person.martyr_family:write /// corehr:person.national_id:read /// corehr:person.national_id:write - /// corehr:person.nationality:read - /// corehr:person.nationality:write /// corehr:person.native_region:read /// corehr:person.native_region:write + /// corehr:person.passport_number:read /// corehr:person.personal_profile:read /// corehr:person.personal_profile:write /// corehr:person.phone:read @@ -32771,7 +32922,7 @@ System.Threading.Tasks.Task PostHireV1TalentsByTalentIdOnboardSt /// /// 路径参数 /// 必填：是 - /// 假期类型ID + /// 假期类型ID，可通过[获取假期类型列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave/leave_types)获取 /// 示例值：7111688079785723436 /// /// @@ -32798,7 +32949,7 @@ System.Threading.Tasks.Task PostHireV1TalentsByTalentIdOnboardSt /// 接口ID：7239198678939713540 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/leave_accrual_record/patch /// Authorization：tenant_access_token - /// 仅可更新「发放数量」和「失效日期」 + /// 更新发放记录的发放数量和失效日期，对应假勤管理-休假管理-[发放记录](https://example.feishu.cn/people/workforce-management/manage/leave/leave_admin/granting_record) /// 权限要求： /// attendance:rule /// @@ -32809,7 +32960,7 @@ System.Threading.Tasks.Task PostHireV1TalentsByTalentIdOnboardSt /// /// 路径参数 /// 必填：是 - /// 假期类型ID + /// 假期类型ID，可通过[获取假期类型列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave/leave_types)获取 /// 示例值：7111688079785723436 /// /// @@ -37221,7 +37372,7 @@ System.Threading.Tasks.Task PatchApplicationV6ApplicationsByAppI /// /// /// 必填：否 - /// 面试评价 ID 列表，使用该筛选项时不会分页 + /// 面试评价 ID 列表，可通过[获取面试信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/interview/list)获取，使用该筛选项时不会分页 /// 默认值：null /// /// @@ -38169,7 +38320,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 @@ -38250,7 +38401,7 @@ System.Threading.Tasks.Task DeleteHireV1TripartiteAgreementsByTr /// 接口ID：7307160083569704963 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/referral/search /// Authorization：tenant_access_token - /// 查询人才内推信息，按内推投递的「创建时间」正向排序 + /// 根据人才查询内推信息列表，包含内推人信息、内推时间、投递ID等，按内推投递的`创建时间`从小到大排序返回。 /// 权限要求： /// hire:referral /// hire:referral:readonly @@ -39647,9 +39798,7 @@ System.Threading.Tasks.Task PostImV2UrlPreviewsBatchUpdateAsync( /// 接口ID：7361028373559230467 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/external_referral_reward/delete /// Authorization：tenant_access_token - /// - 支持通过 ID 删除「导入外部内推奖励」中导入的内推奖励，删除后，招聘系统中「内推奖励管理」中对应的明细将消失 - /// - 若删除「已确认」、「已发放」的奖励，内推人-「我的奖励」中对应明细将消失 - /// 请注意与涉及的内推人提前沟通 + /// 根据外部内推奖励ID删除外部内推奖励。 /// 权限要求： /// hire:external_referral_reward /// @@ -39657,7 +39806,7 @@ System.Threading.Tasks.Task PostImV2UrlPreviewsBatchUpdateAsync( /// /// 路径参数 /// 必填：是 - /// 外部内推奖励ID + /// 外部内推奖励ID，同[导入外部内推奖励](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/external_referral_reward/create)接口的参数`external_id` /// 示例值：6930815272790114324 /// [HttpDelete("/open-apis/hire/v1/external_referral_rewards/{external_referral_reward_id}")] diff --git a/src/IFeishuUserApi.cs b/src/IFeishuUserApi.cs index 8e17ce74..8f84a884 100644 --- a/src/IFeishuUserApi.cs +++ b/src/IFeishuUserApi.cs @@ -2056,6 +2056,7 @@ System.Threading.Tasks.Task PostDocV2ByDocTokenBatchUpdateAsync( /// 默认值：20 /// /// 用户凭证 + [Obsolete("历史版本")] [HttpGet("/open-apis/contact/v3/departments")] System.Threading.Tasks.Task> GetContactV3DepartmentsAsync( UserAccessToken access_token, @@ -3229,6 +3230,7 @@ System.Threading.Tasks.Task PutImV1ChatsByChatIdModerationAsync( /// 默认值：null /// /// 用户凭证 + [Obsolete("历史版本")] [HttpGet("/open-apis/bitable/v1/apps/{app_token}/tables/{table_id}/records/{record_id}")] System.Threading.Tasks.Task> GetBitableV1AppsByAppTokenTablesByTableIdRecordsByRecordIdAsync( UserAccessToken access_token, @@ -4027,8 +4029,8 @@ System.Threading.Tasks.Task DeleteCalendarV4CalendarsByCalendarI /// /// 路径参数 /// 必填：是 - /// 日程 ID。 - /// 创建日程时会返回日程 ID。你也可以调用以下接口获取某一日历的 ID。 + /// 日程 ID。获取方式： + /// - [创建日程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/create)会返回日程 ID /// - [获取日程列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/list) /// - [搜索日程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-event/search) /// 示例值：xxxxxxxxx_0 @@ -9039,6 +9041,7 @@ System.Threading.Tasks.Task DeleteTaskV1TasksByTaskIdCommentsByC /// /// 请求体 /// 用户凭证 + [Obsolete("迁移至新版本：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/lingo-v1/draft/create")] [HttpPost("/open-apis/baike/v1/drafts")] System.Threading.Tasks.Task> PostBaikeV1DraftsAsync( UserAccessToken access_token, @@ -9078,6 +9081,7 @@ System.Threading.Tasks.Task DeleteTaskV1TasksByTaskIdCommentsByC /// /// 请求体 /// 用户凭证 + [Obsolete("迁移至新版本：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/lingo-v1/draft/update")] [HttpPut("/open-apis/baike/v1/drafts/{draft_id}")] System.Threading.Tasks.Task> PutBaikeV1DraftsByDraftIdAsync( UserAccessToken access_token, @@ -9130,6 +9134,7 @@ System.Threading.Tasks.Task DeleteTaskV1TasksByTaskIdCommentsByC /// 默认值：open_id /// /// 用户凭证 + [Obsolete("迁移至新版本：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/lingo-v1/entity/get")] [HttpGet("/open-apis/baike/v1/entities/{entity_id}")] System.Threading.Tasks.Task> GetBaikeV1EntitiesByEntityIdAsync( UserAccessToken access_token, @@ -9183,6 +9188,7 @@ System.Threading.Tasks.Task DeleteTaskV1TasksByTaskIdCommentsByC /// 默认值：open_id /// /// 用户凭证 + [Obsolete("迁移至新版本：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/lingo-v1/entity/list")] [HttpGet("/open-apis/baike/v1/entities")] System.Threading.Tasks.Task> GetBaikeV1EntitiesAsync( UserAccessToken access_token, @@ -9205,6 +9211,7 @@ System.Threading.Tasks.Task DeleteTaskV1TasksByTaskIdCommentsByC /// /// 请求体 /// 用户凭证 + [Obsolete("迁移至新版本：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/lingo-v1/entity/match")] [HttpPost("/open-apis/baike/v1/entities/match")] System.Threading.Tasks.Task> PostBaikeV1EntitiesMatchAsync( UserAccessToken access_token, @@ -9250,6 +9257,7 @@ System.Threading.Tasks.Task DeleteTaskV1TasksByTaskIdCommentsByC /// /// 请求体 /// 用户凭证 + [Obsolete("迁移至新版本：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/lingo-v1/entity/search")] [HttpPost("/open-apis/baike/v1/entities/search")] System.Threading.Tasks.Task> PostBaikeV1EntitiesSearchAsync( UserAccessToken access_token, @@ -9272,6 +9280,7 @@ System.Threading.Tasks.Task DeleteTaskV1TasksByTaskIdCommentsByC /// /// 请求体 /// 用户凭证 + [Obsolete("迁移至新版本：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/lingo-v1/entity/highlight")] [HttpPost("/open-apis/baike/v1/entities/highlight")] System.Threading.Tasks.Task> PostBaikeV1EntitiesHighlightAsync( UserAccessToken access_token, @@ -10806,6 +10815,7 @@ System.Threading.Tasks.Task DeleteOkrV1ProgressRecordsByProgress /// /// 请求体 /// 用户凭证 + [Obsolete("迁移至新版本：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/lingo-v1/entity/create")] [HttpPost("/open-apis/baike/v1/entities")] System.Threading.Tasks.Task> PostBaikeV1EntitiesAsync( UserAccessToken access_token, @@ -10845,6 +10855,7 @@ System.Threading.Tasks.Task DeleteOkrV1ProgressRecordsByProgress /// /// 请求体 /// 用户凭证 + [Obsolete("迁移至新版本：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/lingo-v1/entity/update")] [HttpPut("/open-apis/baike/v1/entities/{entity_id}")] System.Threading.Tasks.Task> PutBaikeV1EntitiesByEntityIdAsync( UserAccessToken access_token, @@ -10878,6 +10889,7 @@ System.Threading.Tasks.Task DeleteOkrV1ProgressRecordsByProgress /// 默认值：null /// /// 用户凭证 + [Obsolete("迁移至新版本：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/lingo-v1/classification/list")] [HttpGet("/open-apis/baike/v1/classifications")] System.Threading.Tasks.Task> GetBaikeV1ClassificationsAsync( UserAccessToken access_token, @@ -12772,6 +12784,7 @@ System.Threading.Tasks.Task PostCalendarV4CalendarsByCalendarIdE /// 二进制文件内容，高宽像素在 320-4096 像素之间，大小在 3KB-10MB 的图片 /// /// 用户凭证 + [Obsolete("迁移至新版本：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/lingo-v1/file/upload")] [HttpPost("/open-apis/baike/v1/files/upload")] System.Threading.Tasks.Task> PostBaikeV1FilesUploadAsync( UserAccessToken access_token, @@ -12798,6 +12811,7 @@ System.Threading.Tasks.Task PostCalendarV4CalendarsByCalendarIdE /// /// 返回文件二进制流 /// 用户凭证 + [Obsolete("迁移至新版本：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/lingo-v1/file/download")] [HttpGet("/open-apis/baike/v1/files/{file_token}/download")] System.Threading.Tasks.Task GetBaikeV1FilesByFileTokenDownloadAsync( UserAccessToken access_token, @@ -13171,6 +13185,7 @@ System.Threading.Tasks.Task DeleteDriveV1FilesByFileTokenVersion /// /// 请求体 /// 用户凭证 + [Obsolete("迁移至新版本：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/lingo-v1/entity/extract")] [HttpPost("/open-apis/baike/v1/entities/extract")] System.Threading.Tasks.Task> PostBaikeV1EntitiesExtractAsync( UserAccessToken access_token, diff --git a/src/Task/PostTaskV2TasksBodyDto.cs b/src/Task/PostTaskV2TasksBodyDto.cs index 5d4725ef..73d09fb9 100644 --- a/src/Task/PostTaskV2TasksBodyDto.cs +++ b/src/Task/PostTaskV2TasksBodyDto.cs @@ -145,7 +145,7 @@ public record I18nText /// /// 法语 /// 必填：否 - /// 示例值：Tabledetravail + /// 示例值：Table de travail /// [JsonPropertyName("fr_fr")] public string? FrFr { get; set; } @@ -153,7 +153,7 @@ public record I18nText /// /// 意大利语 /// 必填：否 - /// 示例值：bancodilavoro + /// 示例值：banco di lavoro /// [JsonPropertyName("it_it")] public string? ItIt { get; set; } @@ -185,7 +185,7 @@ public record I18nText /// /// 西班牙语 /// 必填：否 - /// 示例值：bancodetrabajo + /// 示例值：banco de trabajo /// [JsonPropertyName("es_es")] public string? EsEs { get; set; } @@ -213,9 +213,11 @@ public record PostTaskV2TasksBodyDtoOriginHref { /// /// 来源链接对应的地址，如填写必须以https://或者http://开头。 + /// **说明**：如需调整 PC 端链接打开方式，可在飞书客户端的 **设置** > **效率** > **链接打开方式** 内调整。 /// 必填：否 /// 示例值：https://www.example.com /// 最大长度：1024 + /// 最小长度：0 /// [JsonPropertyName("url")] public string? Url { get; set; } @@ -393,7 +395,7 @@ public record I18nText /// /// 法语 /// 必填：否 - /// 示例值：Tabledetravail + /// 示例值：Table de travail /// [JsonPropertyName("fr_fr")] public string? FrFr { get; set; } @@ -401,7 +403,7 @@ public record I18nText /// /// 意大利语 /// 必填：否 - /// 示例值：bancodilavoro + /// 示例值：banco di lavoro /// [JsonPropertyName("it_it")] public string? ItIt { get; set; } @@ -433,7 +435,7 @@ public record I18nText /// /// 西班牙语 /// 必填：否 - /// 示例值：bancodetrabajo + /// 示例值：banco de trabajo /// [JsonPropertyName("es_es")] public string? EsEs { get; set; } @@ -498,6 +500,7 @@ public record TaskInTasklistInfo /// 必填：否 /// 示例值：daa2237f-8310-4707-a83b-52c8a81e0fb7 /// 最大长度：100 + /// 最小长度：10 /// [JsonPropertyName("client_token")] public string? ClientToken { get; set; } @@ -557,6 +560,8 @@ public record Reminder /// 任务完成模式, 1 - 会签任务; 2 - 或签任务 /// 必填：否 /// 示例值：2 + /// 最大值：2 + /// 最小值：1 /// 默认值：2 /// [JsonPropertyName("mode")]