diff --git a/TenantAccessList.md b/TenantAccessList.md index a9709b56..42a33236 100644 --- a/TenantAccessList.md +++ b/TenantAccessList.md @@ -75,15 +75,15 @@ GetDriveV1Files 382024-05-29✓云文档获取文件夹元数据 GetDriveExplorerV2FolderByFolderTokenMeta -392024-05-31✓云文档新建文件夹 +392024-07-23✓云文档新建文件夹 PostDriveV1FilesCreateFolder 402024-05-29✓云文档获取文件元数据 PostDriveV1MetasBatchQuery 412024-05-29✓云文档新建文件 PostDriveExplorerV2FileByFolderToken -422024-05-29✓云文档复制文件 +422024-07-23✓云文档复制文件 PostDriveV1FilesByFileTokenCopy -432024-05-29✓云文档移动文件或文件夹 +432024-07-23✓云文档移动文件或文件夹 PostDriveV1FilesByFileTokenMove 442024-05-29✓云文档删除文件或文件夹 DeleteDriveV1FilesByFileToken @@ -115,19 +115,19 @@ GetDriveV1FilesByFileTokenGetSubscribe 582024-07-05✓通讯录查询指定用户组 GetContactV3GroupByGroupId -592024-05-29✓云文档上传文件 +592024-07-23✓云文档上传文件 PostDriveV1FilesUploadAll 602024-05-29✓云文档分片上传文件-预上传 PostDriveV1FilesUploadPrepare 612024-05-29✓云文档分片上传文件-上传分片 PostDriveV1FilesUploadPart -622024-05-29✓云文档分片上传文件-完成上传 +622024-07-23✓云文档分片上传文件-完成上传 PostDriveV1FilesUploadFinish 632024-05-29✓云文档下载文件 GetDriveV1FilesByFileTokenDownload -642024-06-14✓云文档创建导入任务 +642024-07-23✓云文档创建导入任务 PostDriveV1ImportTasks -652024-06-14✓云文档查询导入任务结果 +652024-07-23✓云文档查询导入任务结果 GetDriveV1ImportTasksByTicket 662024-06-14✓云文档创建导出任务 PostDriveV1ExportTasks @@ -147,21 +147,21 @@ GetDriveV1FilesByFileTokenVersionsByVersionId 742024-07-15✓云文档获取文档版本列表 GetDriveV1FilesByFileTokenVersions -752024-04-09✓云文档转移所有者 +752024-07-23✓云文档转移所有者 PostDriveV1PermissionsByTokenMembersTransferOwner -762024-04-09✓云文档判断当前用户是否有某权限 +762024-07-23✓云文档判断当前用户是否有某权限 GetDriveV1PermissionsByTokenMembersAuth -772024-07-02✓云文档获取协作者列表（新版） +772024-07-23✓云文档获取协作者列表 GetDriveV1PermissionsByTokenMembers -782024-04-17✓云文档[不推荐] 获取协作者列表 +782024-07-23✓云文档[不推荐] 获取协作者列表 PostDrivePermissionMemberList -792024-07-02✓云文档增加协作者权限 +792024-07-23✓云文档增加协作者权限 PostDriveV1PermissionsByTokenMembers 802024-07-05✓通讯录查询用户所属用户组 GetContactV3GroupMemberBelong -812024-07-02✓云文档更新协作者权限 +812024-07-23✓云文档更新协作者权限 PutDriveV1PermissionsByTokenMembersByMemberId -822024-07-02✓云文档移除协作者权限 +822024-07-23✓云文档移除协作者权限 DeleteDriveV1PermissionsByTokenMembersByMemberId 832024-04-09✓云文档开启密码 PostDriveV1PermissionsByTokenPublicPassword @@ -169,9 +169,9 @@ PutDriveV1PermissionsByTokenPublicPassword 852024-04-09✓云文档关闭密码 DeleteDriveV1PermissionsByTokenPublicPassword -862024-04-09✓云文档获取云文档权限设置 +862024-07-23✓云文档获取云文档权限设置 GetDriveV1PermissionsByTokenPublic -872024-04-09✓云文档更新云文档权限设置 +872024-07-23✓云文档更新云文档权限设置 PatchDriveV1PermissionsByTokenPublic 882024-05-21✓云文档获取云文档权限设置 GetDriveV2PermissionsByTokenPublic @@ -439,7 +439,7 @@ GetWikiV2Spaces 2202024-07-22✓云文档获取知识空间信息 GetWikiV2SpacesBySpaceId -2212024-01-18✓云文档添加知识空间成员 +2212024-07-23✓云文档添加知识空间成员 PostWikiV2SpacesBySpaceIdMembers 2222024-01-18✓云文档删除知识空间成员 DeleteWikiV2SpacesBySpaceIdMembersByMemberId @@ -533,25 +533,25 @@ GetCalendarV4CalendarsByCalendarIdEventsByEventIdAttendeesByAttendeeIdChatMembers 2672024-05-20✓视频会议预约会议 PostVcV1ReservesApply -2682023-07-10✓视频会议删除预约 +2682024-07-23✓视频会议删除预约 DeleteVcV1ReservesByReserveId 2692024-07-05✓通讯录删除单位 DeleteContactV3UnitByUnitId -2702024-05-20✓视频会议更新预约 +2702024-07-23✓视频会议更新预约 PutVcV1ReservesByReserveId -2712024-05-20✓视频会议获取预约 +2712024-07-23✓视频会议获取预约 GetVcV1ReservesByReserveId -2722024-05-20✓视频会议获取活跃会议 +2722024-07-23✓视频会议获取活跃会议 GetVcV1ReservesByReserveIdGetActiveMeeting 2732023-08-23✓视频会议移除参会人 PostVcV1MeetingsByMeetingIdKickout 2742023-08-23✓视频会议设置主持人 PatchVcV1MeetingsByMeetingIdSetHost -2752024-07-09✓视频会议获取会议详情 +2752024-07-23✓视频会议获取会议详情 GetVcV1MeetingsByMeetingId 2762024-05-20✓视频会议获取与会议号关联的会议列表 GetVcV1MeetingsListByNo -2772024-06-14✓视频会议获取录制文件 +2772024-07-23✓视频会议获取录制文件 GetVcV1MeetingsByMeetingIdRecording 2782024-04-29✓视频会议获取会议报告 GetVcV1ReportsGetDaily @@ -559,79 +559,79 @@ GetVcV1ReportsGetTopUser 2802024-07-05✓通讯录修改单位信息 PatchContactV3UnitByUnitId -2812024-04-29✓视频会议导出会议明细 +2812024-07-23✓视频会议导出会议明细 PostVcV1ExportsMeetingList -2822024-04-29✓视频会议导出参会人明细 +2822024-07-23✓视频会议导出参会人明细 PostVcV1ExportsParticipantList -2832024-01-08✓视频会议导出参会人会议质量数据 +2832024-07-23✓视频会议导出参会人会议质量数据 PostVcV1ExportsParticipantQualityList -2842023-07-14✓视频会议导出会议室预定数据 +2842024-07-23✓视频会议导出会议室预定数据 PostVcV1ExportsResourceReservationList -2852023-07-14✓视频会议查询导出任务结果 +2852024-07-23✓视频会议查询导出任务结果 GetVcV1ExportsByTaskId -2862023-07-14✓视频会议下载导出文件 +2862024-07-23✓视频会议下载导出文件 GetVcV1ExportsDownload -2872024-06-21✓视频会议创建会议室层级 +2872024-07-23✓视频会议创建会议室层级 PostVcV1RoomLevels -2882024-04-26✓视频会议删除会议室层级 +2882024-07-23✓视频会议删除会议室层级 PostVcV1RoomLevelsDel -2892024-04-26✓视频会议更新会议室层级 +2892024-07-23✓视频会议更新会议室层级 PatchVcV1RoomLevelsByRoomLevelId -2902024-04-26✓视频会议查询会议室层级详情 +2902024-07-23✓视频会议查询会议室层级详情 GetVcV1RoomLevelsByRoomLevelId 2912024-07-05✓通讯录建立部门与单位的绑定关系 PostContactV3UnitBindDepartment -2922024-04-26✓视频会议批量查询会议室层级详情 +2922024-07-23✓视频会议批量查询会议室层级详情 PostVcV1RoomLevelsMget -2932024-04-26✓视频会议查询会议室层级列表 +2932024-07-23✓视频会议查询会议室层级列表 GetVcV1RoomLevels -2942024-04-26✓视频会议搜索会议室层级 +2942024-07-23✓视频会议搜索会议室层级 GetVcV1RoomLevelsSearch -2952024-04-26✓视频会议创建会议室 +2952024-07-23✓视频会议创建会议室 PostVcV1Rooms -2962024-04-26✓视频会议删除会议室 +2962024-07-23✓视频会议删除会议室 DeleteVcV1RoomsByRoomId -2972024-04-26✓视频会议更新会议室 +2972024-07-23✓视频会议更新会议室 PatchVcV1RoomsByRoomId -2982024-04-26✓视频会议查询会议室详情 +2982024-07-23✓视频会议查询会议室详情 GetVcV1RoomsByRoomId -2992024-04-26✓视频会议批量查询会议室详情 +2992024-07-23✓视频会议批量查询会议室详情 PostVcV1RoomsMget -3002024-04-26✓视频会议查询会议室列表 +3002024-07-23✓视频会议查询会议室列表 GetVcV1Rooms -3012024-04-26✓视频会议查询会议室配置 +3012024-07-23✓视频会议查询会议室配置 GetVcV1ScopeConfig 3022024-07-05✓通讯录解除部门与单位的绑定关系 PostContactV3UnitUnbindDepartment -3032024-04-26✓视频会议设置会议室配置 +3032024-07-23✓视频会议设置会议室配置 PostVcV1ScopeConfig -3042024-04-26✓视频会议查询会议室预定限制 +3042024-07-23✓视频会议查询会议室预定限制 GetVcV1ReserveConfigsReserveScope -3052024-04-26✓视频会议更新会议室预定限制 +3052024-07-23✓视频会议更新会议室预定限制 PatchVcV1ReserveConfigsByReserveConfigId -3062024-04-26✓视频会议查询会议室预定表单 +3062024-07-23✓视频会议查询会议室预定表单 GetVcV1ReserveConfigsByReserveConfigIdForm -3072024-04-26✓视频会议更新会议室预定表单 +3072024-07-23✓视频会议更新会议室预定表单 PatchVcV1ReserveConfigsByReserveConfigIdForm -3082024-04-26✓视频会议查询会议室预定管理员 +3082024-07-23✓视频会议查询会议室预定管理员 GetVcV1ReserveConfigsByReserveConfigIdAdmin -3092024-04-26✓视频会议更新会议室预定管理员 +3092024-07-23✓视频会议更新会议室预定管理员 PatchVcV1ReserveConfigsByReserveConfigIdAdmin -3102024-04-26✓视频会议查询禁用状态变更通知 +3102024-07-23✓视频会议查询禁用状态变更通知 GetVcV1ReserveConfigsByReserveConfigIdDisableInform -3112024-04-26✓视频会议更新禁用状态变更通知 +3112024-07-23✓视频会议更新禁用状态变更通知 PatchVcV1ReserveConfigsByReserveConfigIdDisableInform -3122024-05-31✓视频会议查询会议明细 +3122024-07-23✓视频会议查询会议明细 GetVcV1MeetingList 3132024-07-05✓通讯录获取单位绑定的部门列表 GetContactV3UnitListDepartment -3142024-04-29✓视频会议查询参会人明细 +3142024-07-23✓视频会议查询参会人明细 GetVcV1ParticipantList -3152024-01-08✓视频会议查询参会人会议质量数据 +3152024-07-23✓视频会议查询参会人会议质量数据 GetVcV1ParticipantQualityList -3162024-02-19✓视频会议查询会议室预定数据 +3162024-07-23✓视频会议查询会议室预定数据 GetVcV1ResourceReservationList -3172024-02-19✓视频会议获取告警记录 +3172024-07-23✓视频会议获取告警记录 GetVcV1Alerts 3182024-07-12✓考勤打卡创建班次 PostAttendanceV1Shifts @@ -655,17 +655,17 @@ PostAttendanceV1GroupsSearch 3282024-07-10✓考勤打卡查询所有考勤组 GetAttendanceV1Groups -3292024-07-16✓考勤打卡创建或修改排班表 +3292024-07-24✓考勤打卡创建或修改排班表 PostAttendanceV1UserDailyShiftsBatchCreate -3302024-07-16✓考勤打卡查询排班表 +3302024-07-24✓考勤打卡查询排班表 PostAttendanceV1UserDailyShiftsQuery 3312023-09-11✓考勤打卡更新统计设置 PutAttendanceV1UserStatsViewsByUserStatsViewId -3322024-06-12✓考勤打卡查询统计表头 +3322024-07-24✓考勤打卡查询统计表头 PostAttendanceV1UserStatsFieldsQuery -3332023-09-11✓考勤打卡查询统计设置 +3332024-07-23✓考勤打卡查询统计设置 PostAttendanceV1UserStatsViewsQuery -3342024-07-16✓考勤打卡查询统计数据 +3342024-07-24✓考勤打卡查询统计数据 PostAttendanceV1UserStatsDatasQuery 3352024-07-05✓通讯录删除用户 DeleteContactV3UsersByUserId @@ -767,7 +767,7 @@ PostApprovalV4InstancesQuery 3842024-02-04✓审批查询抄送列表 PostApprovalV4InstancesSearchCc -3852024-02-04✓审批查询任务列表 +3852024-07-23✓审批查询任务列表 PostApprovalV4TasksSearch 3862022-12-28✓审批查询用户的任务列表 GetApprovalV4TasksQuery @@ -1145,15 +1145,15 @@ PatchApplicationV6ApplicationsByAppIdAppVersionsByVersionId 5732023-07-21✓应用信息更新应用分组信息 PatchApplicationV6ApplicationsByAppId -5742023-07-21✓应用信息获取多部门应用使用概览 +5742024-07-23✓应用信息获取多部门应用使用概览 PostApplicationV6ApplicationsByAppIdAppUsageDepartmentOverview -5752023-07-21✓应用信息获取应用使用概览 +5752024-07-23✓应用信息获取应用使用概览 PostApplicationV6ApplicationsByAppIdAppUsageOverview 5762023-07-21✓应用信息更新应用反馈 PatchApplicationV6ApplicationsByAppIdFeedbacksByFeedbackId -5772022-07-13✓应用信息获取应用反馈列表 +5772024-07-23✓应用信息获取应用反馈列表 GetApplicationV6ApplicationsByAppIdFeedbacks -5782023-10-18✓应用信息更新应用红点 +5782024-07-23✓应用信息更新应用红点 PostApplicationV6AppBadgeSet 5792023-07-07✓企业信息获取企业席位信息接口 GetTenantV2TenantAssignInfoListQuery @@ -1235,7 +1235,7 @@ PostDocumentAiV1ContractFieldExtraction 6182023-10-31✓AI 能力识别文件中的名片 PostDocumentAiV1BusinessCardRecognize -6192024-07-16✓AI 能力识别图片中的文字 +6192024-07-23✓AI 能力识别图片中的文字 PostOpticalCharRecognitionV1ImageBasicRecognize 6202024-01-03✓AI 能力识别语音文件 PostSpeechToTextV1SpeechFileRecognize @@ -1339,9 +1339,9 @@ PutImV1MessagesByMessageId 6702023-07-14✓飞书人事批量查询货币信息 GetCorehrV1Currencies -6712024-07-17✓飞书人事（企业版）批量查询员工信息 +6712024-07-24✓飞书人事（企业版）批量查询员工信息 PostCorehrV2EmployeesBatchGet -6722024-07-17✓飞书人事（企业版）搜索员工信息 +6722024-07-24✓飞书人事（企业版）搜索员工信息 PostCorehrV2EmployeesSearch 6732024-07-22✓飞书人事创建雇佣信息 PostCorehrV1Employments @@ -1349,9 +1349,9 @@ PatchCorehrV1EmploymentsByEmploymentId 6752024-02-06✓飞书人事删除雇佣信息 DeleteCorehrV1EmploymentsByEmploymentId -6762024-07-08✓飞书人事（企业版）创建个人信息 +6762024-07-24✓飞书人事（企业版）创建个人信息 PostCorehrV2Persons -6772024-07-08✓飞书人事（企业版）更新个人信息 +6772024-07-24✓飞书人事（企业版）更新个人信息 PatchCorehrV2PersonsByPersonId 6782024-02-06✓飞书人事删除个人信息 DeleteCorehrV1PersonsByPersonId @@ -1465,19 +1465,19 @@ GetCorehrV1PreHiresByPreHireId 7332024-07-15✓飞书人事[不推荐] 批量查询待入职信息 GetCorehrV1PreHires -7342024-06-07✓飞书人事（企业版）搜索合同 +7342024-07-23✓飞书人事（企业版）搜索合同 PostCorehrV2ContractsSearch -7352024-01-24✓消息与群组获取消息中的资源文件 +7352024-07-23✓消息与群组获取消息中的资源文件 GetImV1MessagesByMessageIdResourcesByFileKey -7362023-07-14✓飞书人事创建合同 +7362024-07-23✓飞书人事创建合同 PostCorehrV1Contracts -7372024-02-06✓飞书人事删除合同 +7372024-07-23✓飞书人事删除合同 DeleteCorehrV1ContractsByContractId -7382023-07-14✓飞书人事更新合同 +7382024-07-23✓飞书人事更新合同 PatchCorehrV1ContractsByContractId -7392024-06-07✓飞书人事查询单个合同 +7392024-07-23✓飞书人事查询单个合同 GetCorehrV1ContractsByContractId -7402024-06-07✓飞书人事批量查询合同 +7402024-07-23✓飞书人事批量查询合同 GetCorehrV1Contracts 7412024-07-15✓飞书人事（企业版）搜索试用期信息 PostCorehrV2ProbationSearch @@ -1515,7 +1515,7 @@ PatchImV1MessagesByMessageIdUrgentApp 7582024-06-03✓飞书人事批量查询员工假期余额 GetCorehrV1LeavesLeaveBalances -7592024-06-03✓飞书人事批量查询员工请假记录 +7592024-07-24✓飞书人事批量查询员工请假记录 GetCorehrV1LeavesLeaveRequestHistory 7602024-07-12✓飞书人事（企业版）查询员工 HRBP / 属地 BP PostCorehrV2EmployeesBpsBatchGet @@ -1693,9 +1693,9 @@ GetImV1ImagesByImageKey 8472024-06-25✓招聘停用内推账户 PostHireV1ReferralAccountByReferralAccountIdDeactivate -8482024-02-04✓招聘全额提取内推账号余额 +8482024-07-24✓招聘全额提取内推账户余额 PostHireV1ReferralAccountByReferralAccountIdWithdraw -8492024-02-04✓招聘内推账号提现对账接口 +8492024-07-24✓招聘内推账户提现数据对账 PostHireV1ReferralAccountReconciliation 8502024-07-11✓招聘获取附件信息 GetHireV1AttachmentsByAttachmentId @@ -1755,7 +1755,7 @@ PostPerformanceV1ReviewDatasQuery 8782023-10-25✓词典创建草稿 PostLingoV1Drafts -8792024-07-10✓消息与群组更新应用发送的消息卡片 +8792024-07-23✓消息与群组更新应用发送的消息卡片 PatchImV1MessagesByMessageId 8802023-10-25✓词典更新草稿 PutLingoV1DraftsByDraftId @@ -1787,9 +1787,9 @@ GetLingoV1FilesByFileTokenDownload 8942024-04-26✓安全合规获取OpenAPI审计日志数据 PostSecurityAndComplianceV1OpenapiLogsListData -8952024-07-18✓妙记获取妙记统计数据 +8952024-07-23✓妙记获取妙记统计数据 GetMinutesV1MinutesByMinuteTokenStatistics -8962024-07-18✓妙记获取妙记信息 +8962024-07-23✓妙记获取妙记信息 GetMinutesV1MinutesByMinuteToken 8972023-06-29✓工作台获取工作台访问数据 PostWorkplaceV1WorkplaceAccessDataSearch @@ -1973,15 +1973,15 @@ GetMeetingRoomCountryList 9872022-07-20✓会议室获取城市列表 GetMeetingRoomDistrictList -9882023-07-05✓视频会议创建签到板部署码 +9882024-07-23✓视频会议创建签到板部署码 PostVcV1RoomConfigsSetCheckboardAccessCode -9892023-07-05✓视频会议创建会议室部署码 +9892024-07-23✓视频会议创建会议室部署码 PostVcV1RoomConfigsSetRoomAccessCode 9902024-06-05✓消息与群组创建群 PostImV1Chats -9912023-07-05✓视频会议查询会议室配置 +9912024-07-23✓视频会议查询会议室配置 GetVcV1RoomConfigsQuery -9922023-07-05✓视频会议设置会议室配置 +9922024-07-23✓视频会议设置会议室配置 PostVcV1RoomConfigsSet 9932021-10-22✓身份验证JSAPI 临时授权凭证 PostJssdkTicketGet @@ -2101,7 +2101,7 @@ PostImV2UrlPreviewsBatchUpdate 10512024-05-23✓飞书人事（企业版）查询指定生效日期的部门基本信息 PostCorehrV2DepartmentsQueryTimeline -10522024-07-15✓飞书人事（企业版）更新待入职信息 +10522024-07-24✓飞书人事（企业版）更新待入职信息 PatchCorehrV2PreHiresByPreHireId 10532024-07-11✓飞书人事（企业版）获取流程表单数据 GetCorehrV2ProcessesByProcessIdFormVariableData @@ -2191,9 +2191,9 @@ GetHireV1Subjects 10962024-07-22✓招聘获取职能分类列表 GetHireV1JobFunctions -10972024-07-22✓招聘搜索招聘官网下的职位列表 +10972024-07-24✓招聘搜索招聘官网下的职位列表 PostHireV1WebsitesByWebsiteIdJobPostsSearch -10982024-07-12✓招聘创建人才 +10982024-07-24✓招聘创建人才 PostHireV1TalentsCombinedCreate 10992024-07-22✓招聘获取申请表附加信息 PostHireV1ApplicationsDiversityInclusionsSearch @@ -2247,96 +2247,104 @@ PostCorehrV2PreHiresQuery 11242024-07-22✓招聘职位发布至官网 PostHireV1AdvertisementsByAdvertisementIdPublish -11252024-07-22新增招聘设置猎头保护期 +11252024-07-22✓招聘设置猎头保护期 PostHireV1AgenciesProtect -11262024-07-22新增招聘获取猎头供应商信息 +11262024-07-22✓招聘获取猎头供应商信息 GetHireV1AgenciesByAgencyId -11272024-07-22新增招聘查询猎头供应商信息 +11272024-07-22✓招聘查询猎头供应商信息 GetHireV1AgenciesQuery -11282024-07-22新增招聘转移投递阶段 +11282024-07-22✓招聘转移投递阶段 PostHireV1ApplicationsByApplicationIdTransferStage -11292024-07-22新增招聘获取职位模板 +11292024-07-22✓招聘获取职位模板 GetHireV1JobSchemas -11302024-07-22新增招聘获取面试评价详细信息 +11302024-07-22✓招聘获取面试评价详细信息 GetHireV1InterviewRecordsByInterviewRecordId -11312024-07-22新增招聘获取招聘官网下职位广告详情 +11312024-07-24✓招聘获取招聘官网下职位广告详情 GetHireV1WebsitesByWebsiteIdJobPostsByJobPostId -11322024-07-22新增招聘新建招聘官网投递 +11322024-07-24✓招聘新建招聘官网投递 PostHireV1WebsitesByWebsiteIdDeliveriesCreateByResume -11332024-07-22新增招聘获取 Offer 申请表列表 +11332024-07-22✓招聘获取 Offer 申请表列表 GetHireV1OfferApplicationForms -11342024-07-22新增招聘关闭职位 +11342024-07-22✓招聘关闭职位 PostHireV1JobsByJobIdClose -11352024-07-22新增招聘重启职位 +11352024-07-22✓招聘重启职位 PostHireV1JobsByJobIdOpen -11362024-07-22新增招聘添加笔试结果 +11362024-07-22✓招聘添加笔试结果 PostHireV1Exams -11372024-07-22新增招聘更新人才信息 +11372024-07-22✓招聘更新人才信息 PostHireV1TalentsCombinedUpdate -11382024-07-22新增招聘创建人才外部信息 +11382024-07-22✓招聘创建人才外部信息 PostHireV1TalentsByTalentIdExternalInfo -11392024-07-22新增招聘更新人才外部信息 +11392024-07-22✓招聘更新人才外部信息 PutHireV1TalentsByTalentIdExternalInfo -11402024-07-22新增招聘获取背调信息列表 +11402024-07-22✓招聘获取背调信息列表 GetHireV1BackgroundCheckOrders -11412024-07-22新增招聘获取人才面试信息 +11412024-07-22✓招聘获取人才面试信息 GetHireV1InterviewsGetByTalent -11422024-07-22新增招聘获取面试登记表模板列表 +11422024-07-22✓招聘获取面试登记表模板列表 GetHireV1InterviewRegistrationSchemas -11432024-07-22新增招聘获取 Offer 申请表模板信息 +11432024-07-22✓招聘获取 Offer 申请表模板信息 GetHireV1OfferApplicationFormsByOfferApplicationFormId -11442024-07-22新增招聘获取员工笔试阅卷任务 +11442024-07-22✓招聘获取员工笔试阅卷任务 GetHireV1ExamMarkingTasks -11452024-07-22新增招聘获取员工评估任务 +11452024-07-22✓招聘获取员工评估任务 GetHireV1EvaluationTasks -11462024-07-22新增招聘获取员工面试任务 +11462024-07-22✓招聘获取员工面试任务 GetHireV1InterviewTasks -11472024-07-22新增招聘获取面试轮次类型列表 +11472024-07-22✓招聘获取面试轮次类型列表 GetHireV1InterviewRoundTypes -11482024-07-22新增招聘更新职位相关人员 +11482024-07-22✓招聘更新职位相关人员 PostHireV1JobsByJobIdManagersBatchUpdate -11492024-07-22新增招聘查询操作人对人才的操作记录 +11492024-07-22✓招聘查询操作人对人才的操作记录 PostHireV1TalentOperationLogsSearch -11502024-07-22新增招聘获取职位广告发布记录 +11502024-07-22✓招聘获取职位广告发布记录 PostHireV1JobPublishRecordsSearch -11512024-07-22新增招聘更新 Offer 申请表自定义字段 +11512024-07-22✓招聘更新 Offer 申请表自定义字段 PutHireV1OfferCustomFieldsByOfferCustomFieldId -11522024-07-22新增招聘获取笔试列表 +11522024-07-22✓招聘获取笔试列表 PostHireV1TestsSearch -11532024-07-22新增招聘获取人才信息 V2 +11532024-07-22✓招聘获取人才信息 V2 GetHireV2TalentsByTalentId -11542024-07-22新增招聘获取面试评价信息附件 +11542024-07-22✓招聘获取面试评价信息附件 GetHireV1InterviewRecordsAttachments -11552024-07-22新增招聘获取外部投递信息 +11552024-07-22✓招聘获取外部投递信息 GetHireV1ExternalApplications -11562024-07-22新增招聘获取人才库列表 +11562024-07-22✓招聘获取人才库列表 GetHireV1TalentPools -11572024-07-22新增招聘将人才加入人才库 +11572024-07-22✓招聘将人才加入人才库 PostHireV1TalentPoolsByTalentPoolIdTalentRelationship -11582024-07-22新增招聘更新人才在职状态 +11582024-07-22✓招聘更新人才在职状态 PostHireV1TalentsByTalentIdOnboardStatus -11592024-07-22新增招聘更新外部面评 +11592024-07-22✓招聘更新外部面评 PatchHireV1ExternalInterviewAssessmentsByExternalInterviewAssessmentId -11602024-07-22新增招聘批量获取面试评价详细信息 +11602024-07-22✓招聘批量获取面试评价详细信息 GetHireV1InterviewRecords -11612024-07-22新增招聘创建三方协议 +11612024-07-22✓招聘创建三方协议 PostHireV1TripartiteAgreements -11622024-07-22新增招聘删除三方协议 +11622024-07-22✓招聘删除三方协议 DeleteHireV1TripartiteAgreementsByTripartiteAgreementId -11632024-07-22新增招聘查询猎头保护期信息 +11632024-07-22✓招聘查询猎头保护期信息 PostHireV1AgenciesProtectionPeriodSearch -11642024-07-22新增招聘获取三方协议 +11642024-07-22✓招聘获取三方协议 GetHireV1TripartiteAgreements -11652024-07-22新增招聘更新三方协议 +11652024-07-22✓招聘更新三方协议 PutHireV1TripartiteAgreementsByTripartiteAgreementId -11662024-07-22新增招聘查询人才内推信息 +11662024-07-22✓招聘查询人才内推信息 PostHireV1ReferralsSearch -11672024-07-22新增招聘导入外部内推奖励 +11672024-07-22✓招聘导入外部内推奖励 PostHireV1ExternalReferralRewards -11682024-07-19新增招聘获取面试评价表列表 +11682024-07-19✓招聘获取面试评价表列表 GetHireV1InterviewFeedbackForms -11692024-07-22新增招聘删除外部内推奖励 +11692024-07-22✓招聘删除外部内推奖励 DeleteHireV1ExternalReferralRewardsByExternalReferralRewardId -11702024-07-22新增多维表格批量获取记录 +11702024-07-22✓多维表格批量获取记录 PostBitableV1AppsByAppTokenTablesByTableIdRecordsBatchGet +11712024-07-23新增应用信息获取消息推送概览 +PostApplicationV6ApplicationsByAppIdAppUsageMessagePushOverview +11722024-07-22新增飞书人事（企业版）通过/拒绝审批任务 +PutCorehrV2ProcessesByProcessIdApproversByApproverId +11732024-07-23新增考勤打卡查询归档报表表头 +PostAttendanceV1ArchiveRuleUserStatsFieldsQuery +11742024-07-23新增考勤打卡查询所有归档规则 +GetAttendanceV1ArchiveRule diff --git a/UserAccessList.md b/UserAccessList.md index e4106152..1f05914e 100644 --- a/UserAccessList.md +++ b/UserAccessList.md @@ -135,7 +135,7 @@ DeleteSheetsV2SpreadsheetsBySpreadsheetTokenProtectedRangeBatchDel 682024-07-16✓云文档查询下拉列表设置 GetSheetsV2SpreadsheetsBySpreadsheetTokenDataValidation -692024-07-10✓消息与群组更新应用发送的消息卡片 +692024-07-23✓消息与群组更新应用发送的消息卡片 PatchImV1MessagesByMessageId 702024-07-16✓云文档设置下拉列表 PostSheetsV2SpreadsheetsBySpreadsheetTokenDataValidation @@ -263,7 +263,7 @@ GetWikiV2SpacesBySpaceId 1322023-07-27✓云文档创建知识空间 PostWikiV2Spaces -1332024-01-18✓云文档添加知识空间成员 +1332024-07-23✓云文档添加知识空间成员 PostWikiV2SpacesBySpaceIdMembers 1342024-01-18✓云文档删除知识空间成员 DeleteWikiV2SpacesBySpaceIdMembersByMemberId @@ -377,15 +377,15 @@ GetCalendarV4ExchangeBindingsByExchangeBindingId 1892024-05-20✓视频会议预约会议 PostVcV1ReservesApply -1902023-07-10✓视频会议删除预约 +1902024-07-23✓视频会议删除预约 DeleteVcV1ReservesByReserveId 1912024-06-21✓消息与群组更新群置顶 PostImV1ChatsByChatIdTopNoticePutTopNotice -1922024-05-20✓视频会议更新预约 +1922024-07-23✓视频会议更新预约 PutVcV1ReservesByReserveId -1932024-05-20✓视频会议获取预约 +1932024-07-23✓视频会议获取预约 GetVcV1ReservesByReserveId -1942024-05-20✓视频会议获取活跃会议 +1942024-07-23✓视频会议获取活跃会议 GetVcV1ReservesByReserveIdGetActiveMeeting 1952023-08-23✓视频会议邀请参会人 PatchVcV1MeetingsByMeetingIdInvite @@ -393,7 +393,7 @@ PatchVcV1MeetingsByMeetingIdSetHost 1972023-08-23✓视频会议结束会议 PatchVcV1MeetingsByMeetingIdEnd -1982024-07-09✓视频会议获取会议详情 +1982024-07-23✓视频会议获取会议详情 GetVcV1MeetingsByMeetingId 1992024-05-20✓视频会议获取与会议号关联的会议列表 GetVcV1MeetingsListByNo @@ -403,21 +403,21 @@ PatchVcV1MeetingsByMeetingIdRecordingStop 2022024-06-21✓消息与群组撤销群置顶 PostImV1ChatsByChatIdTopNoticeDeleteTopNotice -2032024-06-14✓视频会议获取录制文件 +2032024-07-23✓视频会议获取录制文件 GetVcV1MeetingsByMeetingIdRecording -2042023-07-10✓视频会议授权录制文件 +2042024-07-23✓视频会议授权录制文件 PatchVcV1MeetingsByMeetingIdRecordingSetPermission -2052024-04-29✓视频会议导出会议明细 +2052024-07-23✓视频会议导出会议明细 PostVcV1ExportsMeetingList -2062024-04-29✓视频会议导出参会人明细 +2062024-07-23✓视频会议导出参会人明细 PostVcV1ExportsParticipantList -2072024-01-08✓视频会议导出参会人会议质量数据 +2072024-07-23✓视频会议导出参会人会议质量数据 PostVcV1ExportsParticipantQualityList -2082023-07-14✓视频会议导出会议室预定数据 +2082024-07-23✓视频会议导出会议室预定数据 PostVcV1ExportsResourceReservationList -2092023-07-14✓视频会议查询导出任务结果 +2092024-07-23✓视频会议查询导出任务结果 GetVcV1ExportsByTaskId -2102023-07-14✓视频会议下载导出文件 +2102024-07-23✓视频会议下载导出文件 GetVcV1ExportsDownload 2112023-07-14删除视频会议创建会议室层级 PostVcV1RoomLevels @@ -451,7 +451,7 @@ GetImV1ChatsSearch 2262023-07-14删除视频会议查询会议室列表 GetVcV1Rooms -2272024-04-26✓视频会议搜索会议室 +2272024-07-23✓视频会议搜索会议室 PostVcV1RoomsSearch 2282023-07-14删除视频会议查询会议室配置 GetVcV1ScopeConfig @@ -475,13 +475,13 @@ GetVcV1ReserveConfigsByReserveConfigIdDisableInform 2382023-08-29删除视频会议更新禁用状态变更通知 PatchVcV1ReserveConfigsByReserveConfigIdDisableInform -2392024-05-31✓视频会议查询会议明细 +2392024-07-23✓视频会议查询会议明细 GetVcV1MeetingList -2402024-04-29✓视频会议查询参会人明细 +2402024-07-23✓视频会议查询参会人明细 GetVcV1ParticipantList -2412024-01-08✓视频会议查询参会人会议质量数据 +2412024-07-23✓视频会议查询参会人会议质量数据 GetVcV1ParticipantQualityList -2422024-02-19✓视频会议查询会议室预定数据 +2422024-07-23✓视频会议查询会议室预定数据 GetVcV1ResourceReservationList 2432022-12-28✓审批查询用户的任务列表 GetApprovalV4TasksQuery @@ -763,9 +763,9 @@ PostLingoV1FilesUpload 3822023-10-25✓词典下载图片 GetLingoV1FilesByFileTokenDownload -3832024-07-18✓妙记获取妙记统计数据 +3832024-07-23✓妙记获取妙记统计数据 GetMinutesV1MinutesByMinuteTokenStatistics -3842024-07-18✓妙记获取妙记信息 +3842024-07-23✓妙记获取妙记信息 GetMinutesV1MinutesByMinuteToken 3852023-04-07✓应用信息获取用户自定义常用的应用 GetApplicationV5ApplicationsFavourite @@ -851,15 +851,15 @@ GetDriveExplorerV2FolderByFolderTokenMeta 4262024-07-09✓通讯录搜索用户 GetHttpsbyOpenLarkofficeComSearchV1User -4272024-05-31✓云文档新建文件夹 +4272024-07-23✓云文档新建文件夹 PostDriveV1FilesCreateFolder 4282024-05-29✓云文档获取文件元数据 PostDriveV1MetasBatchQuery 4292024-05-29✓云文档新建文件 PostDriveExplorerV2FileByFolderToken -4302024-05-29✓云文档复制文件 +4302024-07-23✓云文档复制文件 PostDriveV1FilesByFileTokenCopy -4312024-05-29✓云文档移动文件或文件夹 +4312024-07-23✓云文档移动文件或文件夹 PostDriveV1FilesByFileTokenMove 4322024-05-29✓云文档删除文件或文件夹 DeleteDriveV1FilesByFileToken @@ -891,7 +891,7 @@ GetDriveV1FilesByFileTokenGetSubscribe 4462024-07-11✓云文档搜索云文档 PostSuiteDocsApiSearchObject -4472024-05-29✓云文档上传文件 +4472024-07-23✓云文档上传文件 PostDriveV1FilesUploadAll 4482024-07-05✓通讯录批量获取部门信息 GetContactV3DepartmentsBatch @@ -899,13 +899,13 @@ PostDriveV1FilesUploadPrepare 4502024-05-29✓云文档分片上传文件-上传分片 PostDriveV1FilesUploadPart -4512024-05-29✓云文档分片上传文件-完成上传 +4512024-07-23✓云文档分片上传文件-完成上传 PostDriveV1FilesUploadFinish 4522024-05-29✓云文档下载文件 GetDriveV1FilesByFileTokenDownload -4532024-06-14✓云文档创建导入任务 +4532024-07-23✓云文档创建导入任务 PostDriveV1ImportTasks -4542024-06-14✓云文档查询导入任务结果 +4542024-07-23✓云文档查询导入任务结果 GetDriveV1ImportTasksByTicket 4552024-06-14✓云文档创建导出任务 PostDriveV1ExportTasks @@ -925,21 +925,21 @@ GetDriveV1FilesByFileTokenVersionsByVersionId 4632024-07-15✓云文档获取文档版本列表 GetDriveV1FilesByFileTokenVersions -4642024-04-09✓云文档转移所有者 +4642024-07-23✓云文档转移所有者 PostDriveV1PermissionsByTokenMembersTransferOwner -4652024-04-09✓云文档判断当前用户是否有某权限 +4652024-07-23✓云文档判断当前用户是否有某权限 GetDriveV1PermissionsByTokenMembersAuth -4662024-07-02✓云文档获取协作者列表（新版） +4662024-07-23✓云文档获取协作者列表 GetDriveV1PermissionsByTokenMembers -4672024-04-17✓云文档[不推荐] 获取协作者列表 +4672024-07-23✓云文档[不推荐] 获取协作者列表 PostDrivePermissionMemberList -4682024-07-02✓云文档增加协作者权限 +4682024-07-23✓云文档增加协作者权限 PostDriveV1PermissionsByTokenMembers -4692024-07-02✓云文档更新协作者权限 +4692024-07-23✓云文档更新协作者权限 PutDriveV1PermissionsByTokenMembersByMemberId 4702024-07-05✓通讯录获取父部门信息 GetContactV3DepartmentsParent -4712024-07-02✓云文档移除协作者权限 +4712024-07-23✓云文档移除协作者权限 DeleteDriveV1PermissionsByTokenMembersByMemberId 4722024-04-09✓云文档开启密码 PostDriveV1PermissionsByTokenPublicPassword @@ -947,9 +947,9 @@ PutDriveV1PermissionsByTokenPublicPassword 4742024-04-09✓云文档关闭密码 DeleteDriveV1PermissionsByTokenPublicPassword -4752024-04-09✓云文档获取云文档权限设置 +4752024-07-23✓云文档获取云文档权限设置 GetDriveV1PermissionsByTokenPublic -4762024-04-09✓云文档更新云文档权限设置 +4762024-07-23✓云文档更新云文档权限设置 PatchDriveV1PermissionsByTokenPublic 4772024-05-21✓云文档获取云文档权限设置 GetDriveV2PermissionsByTokenPublic @@ -1027,8 +1027,12 @@ PostDriveV1PermissionsByTokenMembersBatchCreate 5142024-07-16✓日历创建会议纪要 PostCalendarV4CalendarsByCalendarIdEventsByEventIdMeetingMinute -5152024-07-22新增招聘获取待办列表 +5152024-07-22✓招聘获取待办列表 GetHireV1Todos -5162024-07-22新增多维表格批量获取记录 +5162024-07-22✓多维表格批量获取记录 PostBitableV1AppsByAppTokenTablesByTableIdRecordsBatchGet +5172024-07-23新增考勤打卡查询归档报表表头 +PostAttendanceV1ArchiveRuleUserStatsFieldsQuery +5182024-07-23新增考勤打卡查询所有归档规则 +GetAttendanceV1ArchiveRule diff --git a/src/Application.Spec/GetApplicationV6ApplicationsByAppIdFeedbacksResponseDto.cs b/src/Application/GetApplicationV6ApplicationsByAppIdFeedbacksResponseDto.cs similarity index 72% rename from src/Application.Spec/GetApplicationV6ApplicationsByAppIdFeedbacksResponseDto.cs rename to src/Application/GetApplicationV6ApplicationsByAppIdFeedbacksResponseDto.cs index 06ddeaa4..209acc86 100644 --- a/src/Application.Spec/GetApplicationV6ApplicationsByAppIdFeedbacksResponseDto.cs +++ b/src/Application/GetApplicationV6ApplicationsByAppIdFeedbacksResponseDto.cs @@ -4,14 +4,14 @@ // Created : 2024-06-24 // // Last Modified By : yxr -// Last Modified On : 2024-06-24 +// Last Modified On : 2024-07-24 // ************************************************************************ // // MIT // // 获取应用反馈列表 响应体 // ************************************************************************ -namespace FeishuNetSdk.Application.Spec; +namespace FeishuNetSdk.Application; /// /// 获取应用反馈列表 响应体 /// 查询应用的反馈数据 @@ -24,72 +24,83 @@ public record GetApplicationV6ApplicationsByAppIdFeedbacksResponseDto /// /// 应用的反馈列表 /// 必填：否 + /// 最大长度：1000 + /// 最小长度：0 /// [JsonPropertyName("feedback_list")] - public ApplicationFeedback[]? FeedbackList { get; set; } + public ApplicationFeedback[]? FeedbackLists { get; set; } - /// + /// + /// 应用的反馈列表 + /// public record ApplicationFeedback { /// /// 应用反馈 ID，应用反馈记录唯一标识 - /// 必填：否 + /// 必填：是 + /// 示例值：7057888018203574291 /// [JsonPropertyName("feedback_id")] - public string? FeedbackId { get; set; } + public string FeedbackId { get; set; } = string.Empty; /// /// 被反馈应用ID - /// 必填：否 + /// 必填：是 + /// 示例值：cli_9b445f5258795107 /// [JsonPropertyName("app_id")] - public string? AppId { get; set; } + public string AppId { get; set; } = string.Empty; /// /// 反馈提交时间，格式为yyyy-mm-dd hh:mm:ss - /// 必填：否 + /// 必填：是 + /// 示例值：2022-01-30 11:30:12 /// [JsonPropertyName("feedback_time")] - public string? FeedbackTime { get; set; } + public string FeedbackTime { get; set; } = string.Empty; /// /// 反馈用户的租户名， 查询 isv 应用时返回 /// 必填：否 + /// 示例值：字节跳动 /// [JsonPropertyName("tenant_name")] public string? TenantName { get; set; } /// /// 反馈类型 - /// **可选值有**： - /// 1:故障反馈,2:产品建议 - /// 必填：否 + /// 必填：是 + /// 示例值：1 /// 可选值： /// 1：故障反馈 /// 2：产品建议 /// + /// 默认值：1 /// [JsonPropertyName("feedback_type")] - public int? FeedbackType { get; set; } + public int FeedbackType { get; set; } /// /// 反馈处理状态 - /// **可选值有**： - /// 0:反馈未处理,1:反馈已处理,2:反馈处理中,3:反馈已关闭 - /// 必填：否 + /// 必填：是 + /// 示例值：0 /// 可选值： /// 0：反馈未处理 /// 1：反馈已处理 /// 2：反馈处理中 /// 3：反馈已关闭 /// + /// 默认值：0 /// [JsonPropertyName("status")] - public int? Status { get; set; } + public int Status { get; set; } /// /// 故障类型列表：1: 黑屏 2: 白屏 3: 无法打开小程序 4: 卡顿 5: 小程序闪退 6: 页面加载慢 7: 死机 8: 其他异常 /// 必填：否 + /// 示例值：[1,2,3] + /// 最大长度：30 + /// 最小长度：0 /// [JsonPropertyName("fault_type")] public int[]? FaultType { get; set; } @@ -97,31 +108,30 @@ public record ApplicationFeedback /// /// 故障时间，格式为yyyy-mm-dd hh:mm:ss /// 必填：否 + /// 示例值：2022-01-30 11:30:12 /// [JsonPropertyName("fault_time")] public string? FaultTime { get; set; } /// /// 反馈来源：1： 小程序 2：网页应用 3：机器人 4：webSDK - /// **可选值有**： - /// 1:小程序,2:网页应用,3:机器人,4:WebSDK /// 必填：否 + /// 示例值：1 /// 可选值： /// 1：小程序 /// 2：网页应用 /// 3：机器人 /// 4：WebSDK /// + /// 默认值：1 /// [JsonPropertyName("source")] public int? Source { get; set; } /// /// 用户联系方式，只有用户填写联系方式后返回 - /// **字段权限要求（满足任一）**： - /// <md-perm name="contact:user.email:readonly" desc="获取用户邮箱信息" support_app_types="custom" tags="">获取用户邮箱信息</md-perm> - /// <md-perm name="contact:user.phone:readonly" desc="获取用户手机号" support_app_types="custom" tags="">获取用户手机号</md-perm> /// 必填：否 + /// 示例值：wang@bytedance.com /// [JsonPropertyName("contact")] public string? Contact { get; set; } @@ -129,20 +139,23 @@ public record ApplicationFeedback /// /// 反馈处理时间，格式为yyyy-mm-dd hh:mm:ss /// 必填：否 + /// 示例值：2022-01-30 11:30:12 /// [JsonPropertyName("update_time")] public string? UpdateTime { get; set; } /// /// 反馈问题描述 - /// 必填：否 + /// 必填：是 + /// 示例值：反馈描述 /// [JsonPropertyName("description")] - public string? Description { get; set; } + public string Description { get; set; } = string.Empty; /// /// 反馈用户id，租户内用户的唯一标识 ，ID值与查询参数中的user_id_type对应 /// 必填：否 + /// 示例值：ou_9565b69967831233761cc2f11b4c089f /// [JsonPropertyName("user_id")] public string? UserId { get; set; } @@ -150,6 +163,7 @@ public record ApplicationFeedback /// /// 操作者id，租户内用户的唯一标识， ID值与查询参数中的user_id_type 对应 /// 必填：否 + /// 示例值：ou_9565b69967831233761cc2f11b4c089f /// [JsonPropertyName("operator_id")] public string? OperatorId { get; set; } @@ -157,6 +171,7 @@ public record ApplicationFeedback /// /// 反馈图片url列表，url 过期时间三天 /// 必填：否 + /// 最大长度：10 /// [JsonPropertyName("images")] public string[]? Images { get; set; } @@ -167,21 +182,24 @@ public record ApplicationFeedback /// - 如触发反馈的应用类型为网页或网页应用，则上报当前网页的url信息 /// - 如为其他应用类型，则字段返回值为空 /// 必填：否 + /// 示例值：index/page /// [JsonPropertyName("feedback_path")] public string? FeedbackPath { get; set; } } /// - /// 是否还有更多用户反馈列表，true：是，false：否 - /// 必填：否 + /// 是否还有更多项 + /// 必填：是 + /// 示例值：true /// [JsonPropertyName("has_more")] - public bool? HasMore { get; set; } + public bool HasMore { get; set; } /// - /// 拉取下一页应用反馈列表时使用的 page_token + /// 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token /// 必填：否 + /// 示例值：7064688334618378259 /// [JsonPropertyName("page_token")] public string? PageToken { get; set; } diff --git a/src/Application/PostApplicationV6ApplicationsByAppIdAppUsageMessagePushOverviewBodyDto.cs b/src/Application/PostApplicationV6ApplicationsByAppIdAppUsageMessagePushOverviewBodyDto.cs new file mode 100644 index 00000000..c6c2d6f9 --- /dev/null +++ b/src/Application/PostApplicationV6ApplicationsByAppIdAppUsageMessagePushOverviewBodyDto.cs @@ -0,0 +1,54 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-07-24 +// +// Last Modified By : yxr +// Last Modified On : 2024-07-24 +// ************************************************************************ +// +// MIT +// +// 获取消息推送概览 请求体 +// ************************************************************************ +namespace FeishuNetSdk.Application; +/// +/// 获取消息推送概览 请求体 +/// 目标：查看应用在某一天/某一周/某一个月的机器人消息推送数据，可以根据部门做筛选 +/// 接口ID：7036626399368953884 +/// 文档地址：https://open.feishu.cn/document/server-docs/application-v6/app-usage/message_push_overview +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fapplication-v6%2fapplication-app_usage%2fmessage_push_overview +/// +public record PostApplicationV6ApplicationsByAppIdAppUsageMessagePushOverviewBodyDto +{ + /// + /// 查询日期，若cycle_type为week，则输入的date必须为周一； 若cycle_type为month，则输入的date必须为每月1号 + /// 必填：是 + /// 示例值：2021-07-08 + /// + [JsonPropertyName("date")] + public string Date { get; set; } = string.Empty; + + /// + /// 枚举值：day，week，month；week指自然周，返回当前日期所在周的数据；不满一周则从周一到当前日期算。month指自然月，返回当前日期所在月的数据。 + /// 必填：是 + /// 示例值：1 + /// 可选值： + /// 1：日活，指自然日，返回当前日期所在日的数据 + /// 2：周活，指自然周，返回当前日期所在周的数据。若到查询时当周还没结束，则返回周一到当前日期的数值。例如在2021/7/15 查询2021/7/5 这一周的数据，则代表的是2021/7/5 ~ 2021/7/11。但若是在2021/7/8 查询2021/7/5 这一周的数据，则返回的是2021/7/5 ~ 2021/7/7 的数据 + /// 3：月活，指自然月，返回当前日期所在月的数据。若不满一个月则返回当月1日到截止日期前的数据。例如在2021/8/15 查询 7月的数据，则代表2021/7/1~2021/7/31。 若在2021/8/15 查询8月的数据，则代表2021/8/1~2021/8/14的数据 + /// + /// + [JsonPropertyName("cycle_type")] + public int CycleType { get; set; } + + /// + /// 需要查询的部门id，获取方法可参考[部门ID概述](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview) + /// - 若部门id为空，则返回当前租户的使用数据；若填写部门id，则返回当前部门的使用数据（包含子部门的用户）； + /// - 若路径参数中department_id_type为空或者为open_department_id，则此处应该填写部门的 open_department_id；若路径参数中department_id_type为department_id，则此处应该填写部门的 department_id。返回当前部门的使用数据； 若不填写，则返回当前租户的使用数据 + /// 必填：否 + /// 示例值：od-4e6ac4d14bcd5071a37a39de902c7141 + /// + [JsonPropertyName("department_id")] + public string? DepartmentId { get; set; } +} diff --git a/src/Application/PostApplicationV6ApplicationsByAppIdAppUsageMessagePushOverviewResponseDto.cs b/src/Application/PostApplicationV6ApplicationsByAppIdAppUsageMessagePushOverviewResponseDto.cs new file mode 100644 index 00000000..ecba94de --- /dev/null +++ b/src/Application/PostApplicationV6ApplicationsByAppIdAppUsageMessagePushOverviewResponseDto.cs @@ -0,0 +1,53 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-07-24 +// +// Last Modified By : yxr +// Last Modified On : 2024-07-24 +// ************************************************************************ +// +// MIT +// +// 获取消息推送概览 响应体 +// ************************************************************************ +namespace FeishuNetSdk.Application; +/// +/// 获取消息推送概览 响应体 +/// 目标：查看应用在某一天/某一周/某一个月的机器人消息推送数据，可以根据部门做筛选 +/// 接口ID：7036626399368953884 +/// 文档地址：https://open.feishu.cn/document/server-docs/application-v6/app-usage/message_push_overview +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fapplication-v6%2fapplication-app_usage%2fmessage_push_overview +/// +public record PostApplicationV6ApplicationsByAppIdAppUsageMessagePushOverviewResponseDto +{ + /// + /// 消息推送情况，指标值包括：send_msg_count：消息推送数、send_user_count：消息触达人数、read_in_1h_count：消息1h阅读量、read_in_12h_count：消息12h阅读量 + /// 必填：否 + /// 最大长度：10 + /// + [JsonPropertyName("items")] + public ApplicationAppUsage[]? Items { get; set; } + + /// + /// 消息推送情况，指标值包括：send_msg_count：消息推送数、send_user_count：消息触达人数、read_in_1h_count：消息1h阅读量、read_in_12h_count：消息12h阅读量 + /// + public record ApplicationAppUsage + { + /// + /// 指标名称 + /// 必填：是 + /// 示例值：pv + /// + [JsonPropertyName("metric_name")] + public string MetricName { get; set; } = string.Empty; + + /// + /// 指标值 + /// 必填：是 + /// 示例值：100 + /// + [JsonPropertyName("metric_value")] + public int MetricValue { get; set; } + } +} diff --git a/src/Approval/PostApprovalV4TasksSearchResponseDto.cs b/src/Approval/PostApprovalV4TasksSearchResponseDto.cs index 2eca3cd3..7545c5aa 100644 --- a/src/Approval/PostApprovalV4TasksSearchResponseDto.cs +++ b/src/Approval/PostApprovalV4TasksSearchResponseDto.cs @@ -381,7 +381,7 @@ public record InstanceSearchLink public string? UpdateTime { get; set; } /// - /// 三方审批扩展 ID + /// 三方审批扩展 任务ID /// 必填：否 /// 示例值：123123daddf21313 /// diff --git a/src/Attendance/GetAttendanceV1ArchiveRuleResponseDto.cs b/src/Attendance/GetAttendanceV1ArchiveRuleResponseDto.cs new file mode 100644 index 00000000..f946c0f6 --- /dev/null +++ b/src/Attendance/GetAttendanceV1ArchiveRuleResponseDto.cs @@ -0,0 +1,114 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-07-24 +// +// Last Modified By : yxr +// Last Modified On : 2024-07-24 +// ************************************************************************ +// +// MIT +// +// 查询所有归档规则 响应体 +// ************************************************************************ +namespace FeishuNetSdk.Attendance; +/// +/// 查询所有归档规则 响应体 +/// 查询所有归档规则，对应后台假勤管理-考勤统计-报表-[归档报表](https://example.feishu.cn/people/workforce-management/manage/statistics/report)功能 +/// 接口ID：7368679915980947458 +/// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/archive_rule/list +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fattendance-v1%2farchive_rule%2flist +/// +public record GetAttendanceV1ArchiveRuleResponseDto +{ + /// + /// 分页查询结果项 + /// 必填：否 + /// + [JsonPropertyName("items")] + public ArchiveReportMeta[]? Items { get; set; } + + /// + /// 分页查询结果项 + /// + public record ArchiveReportMeta + { + /// + /// 引用报表 ID，暂时无用 + /// 必填：否 + /// 示例值：7341290237441605652 + /// + [JsonPropertyName("report_id")] + public string? ReportId { get; set; } + + /// + /// 引用报表name + /// 必填：否 + /// 示例值：月报汇总 + /// + [JsonPropertyName("report_name")] + public I18nMap? ReportName { get; set; } + + /// + /// 引用报表name + /// + public record I18nMap + { + /// + /// 中文名称 + /// 必填：否 + /// 示例值：1 + /// + [JsonPropertyName("zh")] + public string? Zh { get; set; } + + /// + /// 英文名称 + /// 必填：否 + /// 示例值：alice + /// + [JsonPropertyName("en")] + public string? En { get; set; } + + /// + /// 日文名称 + /// 必填：否 + /// 示例值：1 + /// + [JsonPropertyName("ja")] + public string? Ja { get; set; } + } + + /// + /// 归档报表规则ID，可用于[查询归档报表表头](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/archive_rule/user_stats_fields_query) + /// 必填：否 + /// 示例值：7341290237441605652 + /// + [JsonPropertyName("archive_rule_id")] + public string? ArchiveRuleId { get; set; } + + /// + /// 归档报表name + /// 必填：否 + /// 示例值：归档全员 + /// + [JsonPropertyName("archive_rule_name")] + public I18nMap? ArchiveRuleName { get; set; } + } + + /// + /// 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token + /// 必填：否 + /// 示例值：xxx + /// + [JsonPropertyName("page_token")] + public string? PageToken { get; set; } + + /// + /// 是否还有更多项 + /// 必填：否 + /// 示例值：true + /// + [JsonPropertyName("has_more")] + public bool? HasMore { get; set; } +} diff --git a/src/Attendance/PostAttendanceV1ArchiveRuleUserStatsFieldsQueryBodyDto.cs b/src/Attendance/PostAttendanceV1ArchiveRuleUserStatsFieldsQueryBodyDto.cs new file mode 100644 index 00000000..7e5b0e03 --- /dev/null +++ b/src/Attendance/PostAttendanceV1ArchiveRuleUserStatsFieldsQueryBodyDto.cs @@ -0,0 +1,59 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-07-24 +// +// Last Modified By : yxr +// Last Modified On : 2024-07-24 +// ************************************************************************ +// +// MIT +// +// 查询归档报表表头 请求体 +// ************************************************************************ +namespace FeishuNetSdk.Attendance; +/// +/// 查询归档报表表头 请求体 +/// 查询归档报表表头，对应后台假勤管理-考勤统计-报表-[归档报表](https://example.feishu.cn/people/workforce-management/manage/statistics/report)中一个归档报表的表头信息。归档报表支持引用系统报表，可设置归档时间和数据归档周期，并且支持根据部门/人员、国家/地区、人员类型、工作地点、职级、序列、职务进行人员圈选。 +/// 接口ID：7368679915980898306 +/// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/archive_rule/user_stats_fields_query +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fattendance-v1%2farchive_rule%2fuser_stats_fields_query +/// +public record PostAttendanceV1ArchiveRuleUserStatsFieldsQueryBodyDto +{ + /// + /// 语言类型。默认为zh。 + /// 可选值有： + /// * `en`：英语 + /// * `ja`：日语 + /// * `zh`：中文 + /// 必填：否 + /// 示例值：zh + /// + [JsonPropertyName("locale")] + public string? Locale { get; set; } + + /// + /// 月份，日期格式为yyyyMM。注意此字段应为必填字段 + /// 必填：否 + /// 示例值：202409 + /// + [JsonPropertyName("month")] + public string? Month { get; set; } + + /// + /// 归档规则id，可根据[查询所有归档规则](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/archive_rule/list)获得。注意此字段应为必填字段 + /// 必填：否 + /// 示例值：1 + /// + [JsonPropertyName("archive_rule_id")] + public string? ArchiveRuleId { get; set; } + + /// + /// 操作者id，对应employee_type。注意此字段应为必填字段 + /// 必填：否 + /// 示例值：ax8ud + /// + [JsonPropertyName("operator_id")] + public string? OperatorId { get; set; } +} diff --git a/src/Attendance/PostAttendanceV1ArchiveRuleUserStatsFieldsQueryResponseDto.cs b/src/Attendance/PostAttendanceV1ArchiveRuleUserStatsFieldsQueryResponseDto.cs new file mode 100644 index 00000000..f7531d37 --- /dev/null +++ b/src/Attendance/PostAttendanceV1ArchiveRuleUserStatsFieldsQueryResponseDto.cs @@ -0,0 +1,59 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-07-24 +// +// Last Modified By : yxr +// Last Modified On : 2024-07-24 +// ************************************************************************ +// +// MIT +// +// 查询归档报表表头 响应体 +// ************************************************************************ +namespace FeishuNetSdk.Attendance; +/// +/// 查询归档报表表头 响应体 +/// 查询归档报表表头，对应后台假勤管理-考勤统计-报表-[归档报表](https://example.feishu.cn/people/workforce-management/manage/statistics/report)中一个归档报表的表头信息。归档报表支持引用系统报表，可设置归档时间和数据归档周期，并且支持根据部门/人员、国家/地区、人员类型、工作地点、职级、序列、职务进行人员圈选。 +/// 接口ID：7368679915980898306 +/// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/archive_rule/user_stats_fields_query +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fattendance-v1%2farchive_rule%2fuser_stats_fields_query +/// +public record PostAttendanceV1ArchiveRuleUserStatsFieldsQueryResponseDto +{ + /// + /// 统计数据表头 + /// 必填：否 + /// + [JsonPropertyName("archive_report_fields")] + public ArchiveField[]? ArchiveReportFields { get; set; } + + /// + /// 统计数据表头 + /// + public record ArchiveField + { + /// + /// 字段编号 + /// 必填：否 + /// 示例值：1 + /// + [JsonPropertyName("code")] + public string? Code { get; set; } + + /// + /// 字段名称 + /// 必填：否 + /// 示例值：工号 + /// + [JsonPropertyName("title")] + public string? Title { get; set; } + + /// + /// 一级表头名字 + /// 必填：否 + /// + [JsonPropertyName("upper_titles")] + public string[]? UpperTitles { get; set; } + } +} diff --git a/src/Attendance/PostAttendanceV1UserDailyShiftsBatchCreateBodyDto.cs b/src/Attendance/PostAttendanceV1UserDailyShiftsBatchCreateBodyDto.cs index 47a4bdcc..aa6dce59 100644 --- a/src/Attendance/PostAttendanceV1UserDailyShiftsBatchCreateBodyDto.cs +++ b/src/Attendance/PostAttendanceV1UserDailyShiftsBatchCreateBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Attendance; /// /// 创建或修改排班表 请求体 -/// 班表是用来描述考勤组内人员每天按哪个班次进行上班。目前班表支持按一个整月对一位或多位人员进行排班。当用户的排班数据不存在时会进行创建，当用户的排班数据存在时会按照入参信息进行修改。注意：每人每天只能在一个考勤组中。 +/// 排班表是用来描述考勤组内人员每天按哪个班次进行上班。目前排班表支持按一个整月对一位或多位人员进行排班。当用户的排班数据不存在时会进行创建，当用户的排班数据存在时会按照入参信息进行修改。注意：每人每天只能在一个考勤组中。 /// 接口ID：7044467124773388289 /// 文档地址：https://open.feishu.cn/document/server-docs/attendance-v1/user_daily_shift/batch_create /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fattendance-v1%2fuser_daily_shift%2fbatch_create @@ -22,14 +22,14 @@ namespace FeishuNetSdk.Attendance; public record PostAttendanceV1UserDailyShiftsBatchCreateBodyDto { /// - /// 班表信息列表（数量限制50以内） + /// 排班表信息列表（数量限制50以内） /// 必填：是 /// [JsonPropertyName("user_daily_shifts")] public UserDailyShift[] UserDailyShifts { get; set; } = Array.Empty(); /// - /// 班表信息列表（数量限制50以内） + /// 排班表信息列表（数量限制50以内） /// public record UserDailyShift { @@ -50,7 +50,7 @@ public record UserDailyShift public string ShiftId { get; set; } = string.Empty; /// - /// 月份 + /// 月份，格式yyyyMM /// 必填：是 /// 示例值：202101 /// diff --git a/src/Attendance/PostAttendanceV1UserDailyShiftsBatchCreateResponseDto.cs b/src/Attendance/PostAttendanceV1UserDailyShiftsBatchCreateResponseDto.cs index c2f1dac5..2a14f025 100644 --- a/src/Attendance/PostAttendanceV1UserDailyShiftsBatchCreateResponseDto.cs +++ b/src/Attendance/PostAttendanceV1UserDailyShiftsBatchCreateResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Attendance; /// /// 创建或修改排班表 响应体 -/// 班表是用来描述考勤组内人员每天按哪个班次进行上班。目前班表支持按一个整月对一位或多位人员进行排班。当用户的排班数据不存在时会进行创建，当用户的排班数据存在时会按照入参信息进行修改。注意：每人每天只能在一个考勤组中。 +/// 排班表是用来描述考勤组内人员每天按哪个班次进行上班。目前排班表支持按一个整月对一位或多位人员进行排班。当用户的排班数据不存在时会进行创建，当用户的排班数据存在时会按照入参信息进行修改。注意：每人每天只能在一个考勤组中。 /// 接口ID：7044467124773388289 /// 文档地址：https://open.feishu.cn/document/server-docs/attendance-v1/user_daily_shift/batch_create /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fattendance-v1%2fuser_daily_shift%2fbatch_create diff --git a/src/Attendance/PostAttendanceV1UserDailyShiftsQueryResponseDto.cs b/src/Attendance/PostAttendanceV1UserDailyShiftsQueryResponseDto.cs index fd77ca84..d023b160 100644 --- a/src/Attendance/PostAttendanceV1UserDailyShiftsQueryResponseDto.cs +++ b/src/Attendance/PostAttendanceV1UserDailyShiftsQueryResponseDto.cs @@ -50,7 +50,7 @@ public record UserDailyShift public string ShiftId { get; set; } = string.Empty; /// - /// 月份 + /// 月份，格式yyyyMM /// 必填：是 /// 示例值：202101 /// diff --git a/src/Attendance/PostAttendanceV1UserStatsDatasQueryResponseDto.cs b/src/Attendance/PostAttendanceV1UserStatsDatasQueryResponseDto.cs index 3bae84dd..c7574977 100644 --- a/src/Attendance/PostAttendanceV1UserStatsDatasQueryResponseDto.cs +++ b/src/Attendance/PostAttendanceV1UserStatsDatasQueryResponseDto.cs @@ -4,7 +4,7 @@ // Created : 2024-06-24 // // Last Modified By : yxr -// Last Modified On : 2024-06-24 +// Last Modified On : 2024-07-24 // ************************************************************************ // // MIT @@ -114,6 +114,59 @@ public record UserStatsDataFeature /// [JsonPropertyName("title")] public string? Title { get; set; } + + /// + /// 时长，这个字段是一个map，key位时间单位，value为对应的时长值 + /// 必填：否 + /// + [JsonPropertyName("duration_num")] + public UserStatsDataDuration? DurationNum { get; set; } + + /// + /// 时长，这个字段是一个map，key位时间单位，value为对应的时长值 + /// + public record UserStatsDataDuration + { + /// + /// 天 + /// 必填：否 + /// 示例值：1 + /// + [JsonPropertyName("day")] + public string? Day { get; set; } + + /// + /// 半天 + /// 必填：否 + /// 示例值：1 + /// + [JsonPropertyName("half_day")] + public string? HalfDay { get; set; } + + /// + /// 小时 + /// 必填：否 + /// 示例值：1 + /// + [JsonPropertyName("hour")] + public string? Hour { get; set; } + + /// + /// 半小时 + /// 必填：否 + /// 示例值：1 + /// + [JsonPropertyName("half_hour")] + public string? HalfHour { get; set; } + + /// + /// 分钟 + /// 必填：否 + /// 示例值：1 + /// + [JsonPropertyName("minute")] + public string? Minute { get; set; } + } } } diff --git a/src/Attendance/PostAttendanceV1UserStatsFieldsQueryBodyDto.cs b/src/Attendance/PostAttendanceV1UserStatsFieldsQueryBodyDto.cs index 7a48aec6..732d876e 100644 --- a/src/Attendance/PostAttendanceV1UserStatsFieldsQueryBodyDto.cs +++ b/src/Attendance/PostAttendanceV1UserStatsFieldsQueryBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Attendance; /// /// 查询统计表头 请求体 -/// 查询考勤统计支持的日度统计或月度统计的统计表头。 +/// 查询考勤统计支持的日度统计或月度统计的统计表头。报表的表头信息可以在考勤统计-[报表](https://example.feishu.cn/people/workforce-management/manage/statistics/report)中查询到具体的报表信息，此接口专门用于查询表头数据 /// 接口ID：7044467124773814273 /// 文档地址：https://open.feishu.cn/document/server-docs/attendance-v1/user_stats_data/query-2 /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fattendance-v1%2fuser_stats_field%2fquery @@ -47,7 +47,7 @@ public record PostAttendanceV1UserStatsFieldsQueryBodyDto public string StatsType { get; set; } = string.Empty; /// - /// 开始时间 + /// 开始时间，格式为yyyyMMdd（无效字段） /// 必填：是 /// 示例值：20210316 /// @@ -55,7 +55,7 @@ public record PostAttendanceV1UserStatsFieldsQueryBodyDto public int StartDate { get; set; } /// - /// 结束时间（时间间隔不超过 40 天） + /// 结束时间，格式为yyyyMMdd（时间间隔不超过 40 天）（无效字段） /// 必填：是 /// 示例值：20210323 /// diff --git a/src/Attendance/PostAttendanceV1UserStatsFieldsQueryResponseDto.cs b/src/Attendance/PostAttendanceV1UserStatsFieldsQueryResponseDto.cs index bea99552..bb20a923 100644 --- a/src/Attendance/PostAttendanceV1UserStatsFieldsQueryResponseDto.cs +++ b/src/Attendance/PostAttendanceV1UserStatsFieldsQueryResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Attendance; /// /// 查询统计表头 响应体 -/// 查询考勤统计支持的日度统计或月度统计的统计表头。 +/// 查询考勤统计支持的日度统计或月度统计的统计表头。报表的表头信息可以在考勤统计-[报表](https://example.feishu.cn/people/workforce-management/manage/statistics/report)中查询到具体的报表信息，此接口专门用于查询表头数据 /// 接口ID：7044467124773814273 /// 文档地址：https://open.feishu.cn/document/server-docs/attendance-v1/user_stats_data/query-2 /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fattendance-v1%2fuser_stats_field%2fquery @@ -66,7 +66,7 @@ public record PostAttendanceV1UserStatsFieldsQueryResponseDtoUserStatsField public record Field { /// - /// 字段编号 + /// 分组编号 /// 必填：是 /// 示例值：50121 /// @@ -74,7 +74,7 @@ public record Field public string Code { get; set; } = string.Empty; /// - /// 字段名称 + /// 分组名称 /// 必填：是 /// 示例值：工号 /// @@ -82,19 +82,19 @@ public record Field public string Title { get; set; } = string.Empty; /// - /// 子字段列表 + /// 字段列表 /// 必填：否 /// [JsonPropertyName("child_fields")] public ChildField[]? ChildFields { get; set; } /// - /// 子字段列表 + /// 字段列表 /// public record ChildField { /// - /// 子字段编号 + /// 字段编号 /// 必填：是 /// 示例值：50121 /// @@ -102,7 +102,7 @@ public record ChildField public string Code { get; set; } = string.Empty; /// - /// 子字段名称 + /// 字段名称 /// 必填：是 /// 示例值：工号 /// diff --git a/src/Attendance/PostAttendanceV1UserStatsViewsQueryBodyDto.cs b/src/Attendance/PostAttendanceV1UserStatsViewsQueryBodyDto.cs index 3fea99f9..5e22f305 100644 --- a/src/Attendance/PostAttendanceV1UserStatsViewsQueryBodyDto.cs +++ b/src/Attendance/PostAttendanceV1UserStatsViewsQueryBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Attendance; /// /// 查询统计设置 请求体 -/// 查询开发者定制的日度统计或月度统计的统计报表表头设置信息。 +/// 查询考勤统计支持的日度统计或月度统计的统计表头。报表的表头信息可以在考勤统计-[报表](https://example.feishu.cn/people/workforce-management/manage/statistics/report)中查询到具体的报表信息，此接口专门用于查询表头数据。注意此接口和[查询统计表头](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_stats_field/query)基本相同，区别点在于在兼容历史统计视图模型（历史统计数据模型可以按用户ID设置，后续统计升级为仅支持租户维度） /// 接口ID：7044467124773830657 /// 文档地址：https://open.feishu.cn/document/server-docs/attendance-v1/user_stats_data/query /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fattendance-v1%2fuser_stats_view%2fquery @@ -47,7 +47,7 @@ public record PostAttendanceV1UserStatsViewsQueryBodyDto public string StatsType { get; set; } = string.Empty; /// - /// 操作者的用户id + /// 操作者的用户id，对应employee_type /// * 必填字段(系统升级后，新系统要求必填) /// 必填：否 /// 示例值：dd31248a diff --git a/src/Attendance/PostAttendanceV1UserStatsViewsQueryResponseDto.cs b/src/Attendance/PostAttendanceV1UserStatsViewsQueryResponseDto.cs index 739bf880..85ac92ca 100644 --- a/src/Attendance/PostAttendanceV1UserStatsViewsQueryResponseDto.cs +++ b/src/Attendance/PostAttendanceV1UserStatsViewsQueryResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Attendance; /// /// 查询统计设置 响应体 -/// 查询开发者定制的日度统计或月度统计的统计报表表头设置信息。 +/// 查询考勤统计支持的日度统计或月度统计的统计表头。报表的表头信息可以在考勤统计-[报表](https://example.feishu.cn/people/workforce-management/manage/statistics/report)中查询到具体的报表信息，此接口专门用于查询表头数据。注意此接口和[查询统计表头](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_stats_field/query)基本相同，区别点在于在兼容历史统计视图模型（历史统计数据模型可以按用户ID设置，后续统计升级为仅支持租户维度） /// 接口ID：7044467124773830657 /// 文档地址：https://open.feishu.cn/document/server-docs/attendance-v1/user_stats_data/query /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fattendance-v1%2fuser_stats_view%2fquery @@ -34,7 +34,7 @@ public record PostAttendanceV1UserStatsViewsQueryResponseDto public record UserStatsView { /// - /// 视图 ID + /// 视图 ID，可用于[更新统计设置](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_stats_view/update) /// 必填：是 /// 示例值："TmpZNU5qTTJORFF6T1RnNU5UTTNOakV6TWl0dGIyNTBhQT09" /// @@ -54,7 +54,7 @@ public record UserStatsView public string StatsType { get; set; } = string.Empty; /// - /// 操作者的用户id + /// 操作者的用户id，对应employee_type /// 必填：是 /// 示例值："ec8ddg56" /// @@ -111,6 +111,12 @@ public record ChildItem /// /// 开关字段，0：关闭，1：开启（非开关字段场景：code = 51501 可选值为1-6） + /// `51501`：第 1 次 ~ 第$上下班 + /// `51502`：打卡时间 + /// `51503`：打卡结果 + /// `51504`：打卡原始记录 + /// `51505`：打卡地址 + /// `51506`：打卡备注 /// 必填：是 /// 示例值：0 /// @@ -127,6 +133,9 @@ public record ChildItem /// /// 列类型 + /// * `0`：未知（默认） + /// * `1`：复选框 + /// * `2`：文本 /// 必填：否 /// 示例值：0 /// diff --git a/src/Ccm/GetDriveV1PermissionsByTokenMembersResponseDto.cs b/src/Ccm/GetDriveV1PermissionsByTokenMembersResponseDto.cs index daffbcb5..6a69f936 100644 --- a/src/Ccm/GetDriveV1PermissionsByTokenMembersResponseDto.cs +++ b/src/Ccm/GetDriveV1PermissionsByTokenMembersResponseDto.cs @@ -13,7 +13,7 @@ // ************************************************************************ namespace FeishuNetSdk.Ccm; /// -/// 获取协作者列表（新版） 响应体 +/// 获取协作者列表 响应体 /// 该接口用于根据文件的 token 查询协作者。 /// 接口ID：7121656165336367106 /// 文档地址：https://open.feishu.cn/document/server-docs/docs/permission/permission-member/list diff --git a/src/Ccm/PostWikiV2SpacesBySpaceIdMembersBodyDto.cs b/src/Ccm/PostWikiV2SpacesBySpaceIdMembersBodyDto.cs index a3841138..78c1b984 100644 --- a/src/Ccm/PostWikiV2SpacesBySpaceIdMembersBodyDto.cs +++ b/src/Ccm/PostWikiV2SpacesBySpaceIdMembersBodyDto.cs @@ -22,31 +22,31 @@ namespace FeishuNetSdk.Ccm; public record PostWikiV2SpacesBySpaceIdMembersBodyDto { /// - /// “openchat” - 群id - /// “userid” - 用户id - /// “email” - 邮箱 - /// “opendepartmentid” - 部门id - /// “openid” - 应用openid - /// “unionid” - [unionid](/:ssltoken/home/user-identity-introduction/union-id - /// ) + /// 要添加的成员或管理员的身份类型。可选值： + /// - openchat：群组 ID。参考[群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description)获取 + /// - userid：用户 ID。详情参考[如何获取 User ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-user-id) + /// - email：用户邮箱 + /// - opendepartmentid：部门 ID。参考[部门资源介绍](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview)获取 + /// - openid：用户的 Open ID。详情参考[如何获取 Open ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid) + /// - unionid：用户的 Union ID。详情参考[如何获取 Union ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-union-id) /// 必填：是 - /// 示例值：userid + /// 示例值：openid /// [JsonPropertyName("member_type")] public string MemberType { get; set; } = string.Empty; /// - /// 用户id，值的类型由上面的 member_type 参数决定 + /// 成员或管理员的 ID，值的类型由 member_type 参数决定。参考 member_type 的描述获取不同类型的 ID。 /// 必填：是 - /// 示例值：1565676577122621 + /// 示例值：ou_449b53ad6aee526f7ed311b216aabcef /// [JsonPropertyName("member_id")] public string MemberId { get; set; } = string.Empty; /// - /// 角色: - /// “admin” - 管理员 - /// “member” - 成员 + /// 成员的角色类型。可选值: + /// - admin：管理员 + /// - member：成员 /// 必填：是 /// 示例值：admin /// diff --git a/src/Ccm/PostWikiV2SpacesBySpaceIdMembersResponseDto.cs b/src/Ccm/PostWikiV2SpacesBySpaceIdMembersResponseDto.cs index b932ae38..ac9d1c80 100644 --- a/src/Ccm/PostWikiV2SpacesBySpaceIdMembersResponseDto.cs +++ b/src/Ccm/PostWikiV2SpacesBySpaceIdMembersResponseDto.cs @@ -34,31 +34,31 @@ public record PostWikiV2SpacesBySpaceIdMembersResponseDto public record PostWikiV2SpacesBySpaceIdMembersResponseDtoMember { /// - /// “openchat” - 群id - /// “userid” - 用户id - /// “email” - 邮箱 - /// “opendepartmentid” - 部门id - /// “openid” - 应用openid - /// “unionid” - [unionid](/:ssltoken/home/user-identity-introduction/union-id - /// ) + /// 要添加的成员或管理员的身份类型。可选值： + /// - openchat：群组 ID。参考[群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description)获取 + /// - userid：用户 ID。详情参考[如何获取 User ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-user-id) + /// - email：用户邮箱 + /// - opendepartmentid：部门 ID。参考[部门资源介绍](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview)获取 + /// - openid：用户的 Open ID。详情参考[如何获取 Open ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid) + /// - unionid：用户的 Union ID。详情参考[如何获取 Union ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-union-id) /// 必填：是 - /// 示例值：userid + /// 示例值：openid /// [JsonPropertyName("member_type")] public string MemberType { get; set; } = string.Empty; /// - /// 用户id，值的类型由上面的 member_type 参数决定 + /// 成员或管理员的 ID，值的类型由 member_type 参数决定。 /// 必填：是 - /// 示例值：1565676577122621 + /// 示例值：ou_449b53ad6aee526f7ed311b216aabcef /// [JsonPropertyName("member_id")] public string MemberId { get; set; } = string.Empty; /// - /// 角色: - /// “admin” - 管理员 - /// “member” - 成员 + /// 成员的角色类型。可选值: + /// - admin：管理员 + /// - member：成员 /// 必填：是 /// 示例值：admin /// diff --git a/src/Corehr/PatchCorehrV2PersonsByPersonIdBodyDto.cs b/src/Corehr/PatchCorehrV2PersonsByPersonIdBodyDto.cs index 39f35929..7e226237 100644 --- a/src/Corehr/PatchCorehrV2PersonsByPersonIdBodyDto.cs +++ b/src/Corehr/PatchCorehrV2PersonsByPersonIdBodyDto.cs @@ -616,7 +616,8 @@ public record Email /// /// 邮箱用途，可通过[【枚举常量介绍】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)邮箱用途（email_usage）枚举定义获得 - /// 默认：emergency_contact + /// - 请勿填写 work 枚举，工作邮箱在雇佣信息中操作 + /// - 默认：emergency_contact /// 必填：否 /// [JsonPropertyName("email_usage")] @@ -624,7 +625,8 @@ public record Email /// /// 邮箱用途，可通过[【枚举常量介绍】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)邮箱用途（email_usage）枚举定义获得 - /// 默认：emergency_contact + /// - 请勿填写 work 枚举，工作邮箱在雇佣信息中操作 + /// - 默认：emergency_contact /// public record Enum { diff --git a/src/Corehr/PatchCorehrV2PersonsByPersonIdResponseDto.cs b/src/Corehr/PatchCorehrV2PersonsByPersonIdResponseDto.cs index eb8221f6..3048e4d3 100644 --- a/src/Corehr/PatchCorehrV2PersonsByPersonIdResponseDto.cs +++ b/src/Corehr/PatchCorehrV2PersonsByPersonIdResponseDto.cs @@ -132,7 +132,7 @@ public record Enum /// /// 枚举值 /// 必填：是 - /// 示例值：phone_type + /// 示例值：legal_name /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; @@ -344,7 +344,7 @@ public record Enum /// /// 枚举值 /// 必填：是 - /// 示例值：phone_type + /// 示例值：male /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; @@ -444,7 +444,7 @@ public record Enum /// /// 枚举值 /// 必填：是 - /// 示例值：phone_type + /// 示例值：86_china /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; @@ -731,21 +731,21 @@ public record Address public string? PostalCode { get; set; } /// - /// 地址类型，可通过[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)地址类型（address_type）枚举定义获得；请选择一个使用，不支持同时多个类型 + /// 地址类型，可通过[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)地址类型（address_type）枚举定义获得 /// 必填：是 /// [JsonPropertyName("address_type_list")] public Enum[] AddressTypeLists { get; set; } = Array.Empty(); /// - /// 地址类型，可通过[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)地址类型（address_type）枚举定义获得；请选择一个使用，不支持同时多个类型 + /// 地址类型，可通过[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)地址类型（address_type）枚举定义获得 /// public record Enum { /// /// 枚举值 /// 必填：是 - /// 示例值：phone_type + /// 示例值：home_address /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; @@ -914,7 +914,7 @@ public record Enum /// /// 枚举值 /// 必填：是 - /// 示例值：phone_type + /// 示例值：home /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; @@ -1151,7 +1151,7 @@ public record Enum /// /// 枚举值 /// 必填：是 - /// 示例值：phone_type + /// 示例值：phd /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; @@ -1400,7 +1400,7 @@ public record Enum /// /// 枚举值 /// 必填：是 - /// 示例值：phone_type + /// 示例值：payment /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; @@ -1707,7 +1707,7 @@ public record Enum /// /// 枚举值 /// 必填：是 - /// 示例值：phone_type + /// 示例值：legal_name /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; @@ -1915,7 +1915,7 @@ public record Enum /// /// 枚举值 /// 必填：是 - /// 示例值：phone_type + /// 示例值：parent /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; @@ -2248,7 +2248,7 @@ public record Enum /// /// 枚举值 /// 必填：是 - /// 示例值：phone_type + /// 示例值：86_china /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; @@ -2549,7 +2549,7 @@ public record Enum /// /// 枚举值 /// 必填：是 - /// 示例值：phone_type + /// 示例值：home_address /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; @@ -2760,7 +2760,7 @@ public record Enum /// /// 枚举值 /// 必填：是 - /// 示例值：phone_type + /// 示例值：legal_name /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; @@ -2968,7 +2968,7 @@ public record Enum /// /// 枚举值 /// 必填：是 - /// 示例值：phone_type + /// 示例值：parent /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; @@ -3034,7 +3034,7 @@ public record Enum /// /// 枚举值 /// 必填：是 - /// 示例值：phone_type + /// 示例值：86_china /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; @@ -3283,7 +3283,7 @@ public record Enum /// /// 枚举值 /// 必填：是 - /// 示例值：phone_type + /// 示例值：example /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; @@ -3532,21 +3532,25 @@ 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" + /// 居民身份，枚举值 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" /// 必填：否 /// [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" + /// 居民身份，枚举值 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" /// public record Enum { /// - /// 枚举值 + /// example /// 必填：是 - /// 示例值：phone_type + /// 示例值：example /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; diff --git a/src/Corehr/PostCorehrV2ContractsSearchBodyDto.cs b/src/Corehr/PostCorehrV2ContractsSearchBodyDto.cs index 8f51e0bf..d57a5492 100644 --- a/src/Corehr/PostCorehrV2ContractsSearchBodyDto.cs +++ b/src/Corehr/PostCorehrV2ContractsSearchBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Corehr; /// /// 搜索合同 请求体 -/// 搜索合同信息 +/// 该接口可用于搜索合同信息，包括合同开始时间、合同预计结束时间、合同实际结束时间、合同公司主体等信息 /// 接口ID：7248868628551303172 /// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/contract/search /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fcontract%2fsearch @@ -22,14 +22,15 @@ namespace FeishuNetSdk.Corehr; public record PostCorehrV2ContractsSearchBodyDto { /// - /// 雇佣 ID 列表 + /// 雇佣 ID 列表，雇佣ID可通过[【查询员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)接口查询；最多支持传入20个ID。 /// 必填：否 /// [JsonPropertyName("employment_id_list")] public string[]? EmploymentIdList { get; set; } /// - /// 合同ID列表 + /// 合同 ID 列表，该ID可以通过[【批量查询合同】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/contract/list)接口获取；最多支持传入20个ID。 + /// 注意：以上两个筛选条件如果都填写，则是 「与」 的关系；如果都不填写，默认返回所有的合同列表信息 /// 必填：否 /// [JsonPropertyName("contract_id_list")] diff --git a/src/Corehr/PostCorehrV2ContractsSearchResponseDto.cs b/src/Corehr/PostCorehrV2ContractsSearchResponseDto.cs index c5522375..6e76aea0 100644 --- a/src/Corehr/PostCorehrV2ContractsSearchResponseDto.cs +++ b/src/Corehr/PostCorehrV2ContractsSearchResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Corehr; /// /// 搜索合同 响应体 -/// 搜索合同信息 +/// 该接口可用于搜索合同信息，包括合同开始时间、合同预计结束时间、合同实际结束时间、合同公司主体等信息 /// 接口ID：7248868628551303172 /// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/contract/search /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fcontract%2fsearch @@ -66,7 +66,7 @@ public record Contract public string? ExpirationTime { get; set; } /// - /// 雇佣 ID + /// 雇佣 ID，详细信息可通过[【查询员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)接口查询 /// 必填：否 /// 示例值：6893014062142064135 /// @@ -88,7 +88,7 @@ public record Enum /// /// 枚举值 /// 必填：是 - /// 示例值：phone_type + /// 示例值：labor_contract /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; @@ -116,7 +116,7 @@ public record I18n /// /// 内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：劳动合同 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -124,7 +124,7 @@ public record I18n } /// - /// 合同主体, 引用 Company 的 ID，枚举值及详细信息可通过【批量查询公司】接口查询获得 + /// 合同主体, 详细信息可通过[【查询公司详情接口】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/get)接口查询获得 /// 必填：否 /// 示例值：7091599096804394540 /// @@ -132,7 +132,7 @@ public record I18n public string? FirstPartyCompanyId { get; set; } /// - /// Person ID，枚举值及详细信息可通过【批量查询个人信息】接口查询获得 + /// 合同签约人员ID，详细信息可通过[【查询个人信息接口】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/person/get)接口查询获得 /// 必填：否 /// 示例值：7088589447189022252 /// diff --git a/src/Corehr/PostCorehrV2EmployeesBatchGetResponseDto.cs b/src/Corehr/PostCorehrV2EmployeesBatchGetResponseDto.cs index dc162023..215ffc5e 100644 --- a/src/Corehr/PostCorehrV2EmployeesBatchGetResponseDto.cs +++ b/src/Corehr/PostCorehrV2EmployeesBatchGetResponseDto.cs @@ -74,7 +74,8 @@ public record Employee public string? EmployeeTypeId { get; set; } /// - /// 部门 ID，详细信息可通过[查询单个部门](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/department/get)接口获得；类型与 department_id_type 一致 + /// 部门 ID，详细信息可通过[查询单个部门](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/department/get)接口获得 + /// - 类型与 department_id_type 一致 /// 必填：否 /// 示例值：6893014062142064135 /// @@ -568,7 +569,8 @@ public record I18n public string? WorkingHoursTypeId { get; set; } /// - /// 部门 + /// 部门 ID，详细信息可通过[查询单个部门](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/department/get)接口获得 + /// - 类型与 department_id_type 一致 /// 必填：是 /// 示例值：4719519211875096301 /// @@ -5044,7 +5046,8 @@ public record CustomName public record BasicDepartment { /// - /// 部门 ID，类型与 department_id_type 一致 + /// 部门 ID，详细信息可通过[查询单个部门](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/department/get)接口获得 + /// - 类型与 department_id_type 一致 /// 必填：否 /// 示例值：4719456877659520852 /// diff --git a/src/Corehr/PostCorehrV2PersonsBodyDto.cs b/src/Corehr/PostCorehrV2PersonsBodyDto.cs index 9f4fa06b..903ab608 100644 --- a/src/Corehr/PostCorehrV2PersonsBodyDto.cs +++ b/src/Corehr/PostCorehrV2PersonsBodyDto.cs @@ -22,7 +22,7 @@ namespace FeishuNetSdk.Corehr; public record PostCorehrV2PersonsBodyDto { /// - /// 姓名列表，当不为离职重聘员工时，该字段必填 + /// 姓名列表，当用于[【创建雇佣】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/employment/create) 的离职重聘时，该字段必填 /// 字段权限要求： /// 读写法定姓名信息(corehr:person.legal_name:write) /// 必填：否 @@ -31,7 +31,7 @@ public record PostCorehrV2PersonsBodyDto public PersonName[]? NameLists { get; set; } /// - /// 姓名列表，当不为离职重聘员工时，该字段必填 + /// 姓名列表，当用于[【创建雇佣】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/employment/create) 的离职重聘时，该字段必填 /// 字段权限要求： /// 读写法定姓名信息(corehr:person.legal_name:write) /// @@ -632,7 +632,8 @@ public record Email /// /// 邮箱用途，可通过[【枚举常量介绍】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)邮箱用途（email_usage）枚举定义获得 - /// 默认emergency_contact + /// - 请勿填写 work 枚举，工作邮箱在雇佣信息中操作 + /// - 默认：emergency_contact /// 必填：否 /// [JsonPropertyName("email_usage")] @@ -640,14 +641,15 @@ public record Email /// /// 邮箱用途，可通过[【枚举常量介绍】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)邮箱用途（email_usage）枚举定义获得 - /// 默认emergency_contact + /// - 请勿填写 work 枚举，工作邮箱在雇佣信息中操作 + /// - 默认：emergency_contact /// public record Enum { /// /// 枚举值 /// 必填：是 - /// 示例值：home + /// 示例值：emergency_contact /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; diff --git a/src/Corehr/PostCorehrV2PersonsResponseDto.cs b/src/Corehr/PostCorehrV2PersonsResponseDto.cs index 46c5303b..6113f097 100644 --- a/src/Corehr/PostCorehrV2PersonsResponseDto.cs +++ b/src/Corehr/PostCorehrV2PersonsResponseDto.cs @@ -1398,7 +1398,7 @@ public record Enum /// /// 枚举值 /// 必填：是 - /// 示例值：phone_type + /// 示例值：checking /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; @@ -2242,7 +2242,7 @@ public record Enum /// /// 枚举值 /// 必填：是 - /// 示例值：phone_type + /// 示例值：86_china /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; diff --git a/src/Corehr/PutCorehrV2ProcessesByProcessIdApproversByApproverIdBodyDto.cs b/src/Corehr/PutCorehrV2ProcessesByProcessIdApproversByApproverIdBodyDto.cs new file mode 100644 index 00000000..7a6719e9 --- /dev/null +++ b/src/Corehr/PutCorehrV2ProcessesByProcessIdApproversByApproverIdBodyDto.cs @@ -0,0 +1,419 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-07-24 +// +// Last Modified By : yxr +// Last Modified On : 2024-07-24 +// ************************************************************************ +// +// MIT +// +// 通过/拒绝审批任务 请求体 +// ************************************************************************ +namespace FeishuNetSdk.Corehr; +/// +/// 通过/拒绝审批任务 请求体 +/// 对于单个审批任务进行通过（提交）或拒绝操作。对于多人或签节点，一个审批任务通过则整个节点通过；对于多人会签节点，所有审批任务通过则节点通过。在通过（提交）时，若表单中有必填字段，支持写入表单字段。 +/// 接口ID：7340625370520797187 +/// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/process-approver/update +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fprocess-approver%2fupdate +/// +public record PutCorehrV2ProcessesByProcessIdApproversByApproverIdBodyDto +{ + /// + /// 将审批任务修改为同意/拒绝 + /// 必填：是 + /// 示例值：2 + /// 最大值：100 + /// 最小值：0 + /// 可选值： + /// 2：拒绝 + /// 3：通过 + /// + /// + [JsonPropertyName("status")] + public int Status { get; set; } + + /// + /// 用户id，按user_id_type类型传递。如果system_approval为false，则必填；为true时非必填。 + /// 必填：否 + /// 示例值：ou_91791271921729102012 + /// + [JsonPropertyName("user_id")] + public string? UserId { get; set; } + + /// + /// 是否为系统身份审批。 + /// true - 使用系统身份审批；false - 按照所传的人员身份审批 + /// 必填：否 + /// 示例值：true + /// 默认值：false + /// + [JsonPropertyName("system_approval")] + public bool? SystemApproval { get; set; } + + /// + /// 通过原因，长度限制为500 + /// **默认值**："" + /// 必填：否 + /// 示例值：原因自定义字符串 + /// 最大长度：500 + /// + [JsonPropertyName("reason")] + public string? Reason { get; set; } + + /// + /// 表单数据 + /// 必填：否 + /// 最大长度：100000 + /// 最小长度：0 + /// + [JsonPropertyName("field_values_v2")] + public ProcessFormVariableV2[]? FieldValuesV2s { get; set; } + + /// + /// 表单数据 + /// + public record ProcessFormVariableV2 + { + /// + /// 变量唯一标识，可通过[获取流程表单数据](https://open.larkoffice.com/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/process-form_variable_data/get)查询变量 + /// 必填：否 + /// 示例值：custom123 + /// + [JsonPropertyName("variable_api_name")] + public string? VariableApiName { get; set; } + + /// + /// 变量值 + /// 必填：否 + /// + [JsonPropertyName("variable_value")] + public FieldVariableValueToForReview? VariableValue { get; set; } + + /// + /// 变量值 + /// + public record FieldVariableValueToForReview + { + /// + /// 文本值 + /// 必填：否 + /// 示例值：测试测试 + /// + [JsonPropertyName("text_value")] + public string? TextValue { get; set; } + + /// + /// 布尔值 + /// 必填：否 + /// 示例值：true + /// + [JsonPropertyName("bool_value")] + public bool? BoolValue { get; set; } + + /// + /// 数字值 + /// 必填：否 + /// 示例值：100 + /// + [JsonPropertyName("number_value")] + public string? NumberValue { get; set; } + + /// + /// 枚举值，这里是枚举的id + /// 必填：否 + /// 示例值：home_address + /// + [JsonPropertyName("enum_value")] + public string? EnumValue { get; set; } + + /// + /// 从 1970 开始的天数 + /// 必填：否 + /// 示例值：19838 + /// + [JsonPropertyName("date_value")] + public string? DateValue { get; set; } + + /// + /// 时间戳，毫秒 + /// 必填：否 + /// 示例值：1714013877512 + /// + [JsonPropertyName("date_time_value")] + public string? DateTimeValue { get; set; } + + /// + /// 多语字段值 + /// 必填：否 + /// 示例值：ou_c57053dad6eea0aea4696c48433d8562 + /// + [JsonPropertyName("i18n_value")] + public FieldVariableValueI18n? I18nValue { get; set; } + + /// + /// 多语字段值 + /// + public record FieldVariableValueI18n + { + /// + /// 中文值 + /// 必填：否 + /// 示例值：北京 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 英文值 + /// 必填：否 + /// 示例值：Beijing + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 对象值 + /// 必填：否 + /// 示例值：od-a761814f6bc3f14bd3b00905ec1d7c6f + /// + [JsonPropertyName("object_value")] + public FieldVariableValueToObject? ObjectValue { get; set; } + + /// + /// 对象值 + /// + public record FieldVariableValueToObject + { + /// + /// 飞书人事主数据对象唯一标识。 + /// 例如： + /// wk_api_name为"job"时，wk_id代表职务ID。详请可参考[查询单个职务（V2）](https://open.larkoffice.com/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/get) + /// wk_api_name为"job_level"时，wk_id代表职级ID。详情可参考[查询单个职级](https://open.larkoffice.com/document/server-docs/corehr-v1/job-management/job_level/get) + /// 必填：否 + /// 示例值：6863326263210149383 + /// + [JsonPropertyName("wk_id")] + public string? WkId { get; set; } + + /// + /// 飞书人事元数据对象的唯一标识。 + /// 例如： + /// 职务的wk_api_name为"job"；职级的wk_api_name为"job_level"； + /// 如需获取更多对象信息，可查询[获取飞书人事对象列表](https://open.larkoffice.com/document/server-docs/corehr-v1/basic-infomation/custom_field/list_object_api_name)接口 + /// 必填：否 + /// 示例值：country_region_subdivision + /// + [JsonPropertyName("wk_api_name")] + public string? WkApiName { get; set; } + } + + /// + /// 部门id，根据查询参数department_id_type类型选择对应的部门id。 + /// 可通过[搜索部门信息](https://open.larkoffice.com/document/server-docs/corehr-v1/organization-management/department/search) 或 [批量查询部门（ V2）](https://open.larkoffice.com/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get)接口查询详情。 + /// 必填：否 + /// 示例值：od-a761814f6bc3f14bd3b00905ec1d7c6f + /// + [JsonPropertyName("department_value")] + public string? DepartmentValue { get; set; } + + /// + /// 员工类型字段值，为用户id，根据入参选择的user_id_type类型返回的用户id。 + /// 可通过[搜索员工信息](https://open.larkoffice.com/document/server-docs/corehr-v1/employee/search) 或 [批量查询员工信息](https://open.larkoffice.com/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)接口查询详情。 + /// 必填：否 + /// 示例值：ou_c57053dad6eea0aea4696c48433d8562 + /// + [JsonPropertyName("employment_value")] + public string? EmploymentValue { get; set; } + + /// + /// 数组类型值，里面包含多个值，每个元素都对应sub_values中的key + /// 必填：否 + /// 最大长度：10000 + /// 最小长度：0 + /// + [JsonPropertyName("list_values")] + public string[]? ListValues { get; set; } + } + + /// + /// 在list_values和record_values中引用的变量 + /// 必填：否 + /// 最大长度：100000 + /// 最小长度：0 + /// + [JsonPropertyName("sub_values")] + public FieldVariableSubVlaueForReview[]? SubValues { get; set; } + + /// + /// 在list_values和record_values中引用的变量 + /// + public record FieldVariableSubVlaueForReview + { + /// + /// 用于关联list_values和record_values类型变量值中的key + /// 必填：否 + /// 示例值：key1 + /// + [JsonPropertyName("key")] + public string? Key { get; set; } + + /// + /// 变量值 + /// 必填：否 + /// + [JsonPropertyName("value")] + public FieldVariableValueToForReview? Value { get; set; } + + /// + /// 变量值 + /// + public record FieldVariableValueToForReview + { + /// + /// 文本值 + /// 必填：否 + /// 示例值：测试测试 + /// + [JsonPropertyName("text_value")] + public string? TextValue { get; set; } + + /// + /// 布尔值 + /// 必填：否 + /// 示例值：true + /// + [JsonPropertyName("bool_value")] + public bool? BoolValue { get; set; } + + /// + /// 数字值 + /// 必填：否 + /// 示例值：100 + /// + [JsonPropertyName("number_value")] + public string? NumberValue { get; set; } + + /// + /// 枚举值，这里是枚举的id + /// 必填：否 + /// 示例值：home_address + /// + [JsonPropertyName("enum_value")] + public string? EnumValue { get; set; } + + /// + /// 从 1970 开始的天数 + /// 必填：否 + /// 示例值：19838 + /// + [JsonPropertyName("date_value")] + public string? DateValue { get; set; } + + /// + /// 时间戳，毫秒 + /// 必填：否 + /// 示例值：1714013877512 + /// + [JsonPropertyName("date_time_value")] + public string? DateTimeValue { get; set; } + + /// + /// 多语字段值 + /// 必填：否 + /// 示例值：ou_c57053dad6eea0aea4696c48433d8562 + /// + [JsonPropertyName("i18n_value")] + public FieldVariableValueI18n? I18nValue { get; set; } + + /// + /// 多语字段值 + /// + public record FieldVariableValueI18n + { + /// + /// 中文值 + /// 必填：否 + /// 示例值：北京 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 英文值 + /// 必填：否 + /// 示例值：Beijing + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 对象值，包括对象id和对象类型 + /// 必填：否 + /// 示例值：od-a761814f6bc3f14bd3b00905ec1d7c6f + /// + [JsonPropertyName("object_value")] + public FieldVariableValueToObject? ObjectValue { get; set; } + + /// + /// 对象值，包括对象id和对象类型 + /// + public record FieldVariableValueToObject + { + /// + /// 飞书人事主数据对象唯一标识。 + /// 例如： + /// wk_api_name为"job"时，wk_id代表职务ID。详请可参考[查询单个职务（V2）](https://open.larkoffice.com/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/get) + /// wk_api_name为"job_level"时，wk_id代表职级ID。详情可参考[查询单个职级](https://open.larkoffice.com/document/server-docs/corehr-v1/job-management/job_level/get) + /// 必填：否 + /// 示例值：6863326263210149383 + /// + [JsonPropertyName("wk_id")] + public string? WkId { get; set; } + + /// + /// 飞书人事元数据对象的唯一标识。 + /// 例如： + /// 职务的wk_api_name为"job"；职级的wk_api_name为"job_level"； + /// 如需获取更多对象信息，可查询[获取飞书人事对象列表](https://open.larkoffice.com/document/server-docs/corehr-v1/basic-infomation/custom_field/list_object_api_name)接口 + /// 必填：否 + /// 示例值：country_region_subdivision + /// + [JsonPropertyName("wk_api_name")] + public string? WkApiName { get; set; } + } + + /// + /// 部门id，根据查询参数department_id_type类型选择对应的部门id。 + /// 可通过[搜索部门信息](https://open.larkoffice.com/document/server-docs/corehr-v1/organization-management/department/search) 或 [批量查询部门（ V2）](https://open.larkoffice.com/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get)接口查询详情。 + /// 必填：否 + /// 示例值：od-a761814f6bc3f14bd3b00905ec1d7c6f + /// + [JsonPropertyName("department_value")] + public string? DepartmentValue { get; set; } + + /// + /// 员工类型字段值，为用户id，根据入参选择的user_id_type类型返回的用户id。 + /// 可通过[搜索员工信息](https://open.larkoffice.com/document/server-docs/corehr-v1/employee/search) 或 [批量查询员工信息](https://open.larkoffice.com/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)接口查询详情。 + /// 必填：否 + /// 示例值：ou_c57053dad6eea0aea4696c48433d8562 + /// + [JsonPropertyName("employment_value")] + public string? EmploymentValue { get; set; } + + /// + /// 数组类型值，里面包含多个值，每个元素都对应sub_values中的key + /// 必填：否 + /// 最大长度：10000 + /// 最小长度：0 + /// + [JsonPropertyName("list_values")] + public string[]? ListValues { get; set; } + } + } + } +} diff --git a/src/Corehr/PutCorehrV2ProcessesByProcessIdApproversByApproverIdResponseDto.cs b/src/Corehr/PutCorehrV2ProcessesByProcessIdApproversByApproverIdResponseDto.cs new file mode 100644 index 00000000..5e587465 --- /dev/null +++ b/src/Corehr/PutCorehrV2ProcessesByProcessIdApproversByApproverIdResponseDto.cs @@ -0,0 +1,39 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-07-24 +// +// Last Modified By : yxr +// Last Modified On : 2024-07-24 +// ************************************************************************ +// +// MIT +// +// 通过/拒绝审批任务 响应体 +// ************************************************************************ +namespace FeishuNetSdk.Corehr; +/// +/// 通过/拒绝审批任务 响应体 +/// 对于单个审批任务进行通过（提交）或拒绝操作。对于多人或签节点，一个审批任务通过则整个节点通过；对于多人会签节点，所有审批任务通过则节点通过。在通过（提交）时，若表单中有必填字段，支持写入表单字段。 +/// 接口ID：7340625370520797187 +/// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/process-approver/update +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fprocess-approver%2fupdate +/// +public record PutCorehrV2ProcessesByProcessIdApproversByApproverIdResponseDto +{ + /// + /// 错误码，非 0 表示失败 + /// 必填：是 + /// 示例值：0 + /// + [JsonPropertyName("code")] + public int Code { get; set; } + + /// + /// 错误描述 + /// 必填：否 + /// 示例值：错误原因 + /// + [JsonPropertyName("msg")] + public string? Msg { get; set; } +} diff --git a/src/FeishuNetSdk.csproj b/src/FeishuNetSdk.csproj index 53d60f51..19dbf98f 100644 --- a/src/FeishuNetSdk.csproj +++ b/src/FeishuNetSdk.csproj @@ -16,7 +16,7 @@ MIT 适用于飞书开放平台的.Net开发包 LICENSE - 2.3.8 + 2.3.9 diff --git a/src/FeishuPeople/GetCorehrV1ContractsByContractIdResponseDto.cs b/src/FeishuPeople/GetCorehrV1ContractsByContractIdResponseDto.cs index 18048d2a..8546d627 100644 --- a/src/FeishuPeople/GetCorehrV1ContractsByContractIdResponseDto.cs +++ b/src/FeishuPeople/GetCorehrV1ContractsByContractIdResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.FeishuPeople; /// /// 查询单个合同 响应体 -/// 根据 ID 查询单个合同。 +/// 该接口用于根据合同 ID 查询单个合同详细信息，包括合同开始日期、结束日期、公司主体等信息 /// 接口ID：7017694651621883908 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/contract/get /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fcorehr-v1%2fcontract%2fget @@ -58,7 +58,7 @@ public record GetCorehrV1ContractsByContractIdResponseDtoContract public string? ExpirationTime { get; set; } /// - /// 雇员 ID，枚举值及详细信息可通过【批量查询雇佣信息】接口查询获得 + /// 雇佣 ID，详细信息可通过[【查询员工信息接口】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search)获取 /// 必填：是 /// 示例值：6893013238632416776 /// @@ -80,7 +80,7 @@ public record Enum /// /// 枚举值 /// 必填：是 - /// 示例值：type_1 + /// 示例值：internship_agreement /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; @@ -108,7 +108,7 @@ public record I18n /// /// 名称信息的内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：实习协议 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -116,7 +116,7 @@ public record I18n } /// - /// 甲方, 引用Company的ID，枚举值及详细信息可通过【批量查询公司】接口查询获得 + /// 合同主体ID, 详细信息可通过[【查询公司详情接口】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/get)接口查询获得 /// 必填：是 /// 示例值：6892686614112241165 /// @@ -124,7 +124,7 @@ public record I18n public string FirstPartyCompanyId { get; set; } = string.Empty; /// - /// Person ID，枚举值及详细信息可通过【批量查询个人信息】接口查询获得 + /// Person ID，详细信息可通过接口文档[【查询个人信息接口】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/person/get)接口查询获得 /// 必填：否 /// 示例值：151515151 /// @@ -154,7 +154,7 @@ public record ObjectFieldData /// /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", [\"id1\",\"id2\"], "2006-01-02 15:04:05") /// 必填：是 - /// 示例值：\"Sandy\" + /// 示例值：Sandy /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; diff --git a/src/FeishuPeople/GetCorehrV1ContractsResponseDto.cs b/src/FeishuPeople/GetCorehrV1ContractsResponseDto.cs index 299801e6..b8ede2af 100644 --- a/src/FeishuPeople/GetCorehrV1ContractsResponseDto.cs +++ b/src/FeishuPeople/GetCorehrV1ContractsResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.FeishuPeople; /// /// 批量查询合同 响应体 -/// 批量查询合同。 +/// 通过接口可以批量查询合同列表信息，目前暂不支持其他筛选条件且一次查询最多支持50条数据。 /// 接口ID：7017707615191121923 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/contract/list /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fcorehr-v1%2fcontract%2flist @@ -58,7 +58,7 @@ public record Contract public string? ExpirationTime { get; set; } /// - /// 雇员 ID，枚举值及详细信息可通过【批量查询雇佣信息】接口查询获得 + /// 雇佣 ID，详细信息可通过[【查询员工信息接口】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search)获取 /// 必填：是 /// 示例值：6893013238632416776 /// @@ -80,7 +80,7 @@ public record Enum /// /// 枚举值 /// 必填：是 - /// 示例值：type_1 + /// 示例值：labor_contract /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; @@ -108,7 +108,7 @@ public record I18n /// /// 名称信息的内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：劳动合同 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -116,7 +116,7 @@ public record I18n } /// - /// 甲方, 引用Company的ID，枚举值及详细信息可通过【批量查询公司】接口查询获得 + /// 合同主体ID, 详细信息可通过[【查询公司详情接口】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/get)接口查询获得 /// 必填：是 /// 示例值：6892686614112241165 /// @@ -124,7 +124,7 @@ public record I18n public string FirstPartyCompanyId { get; set; } = string.Empty; /// - /// Person ID，枚举值及详细信息可通过【批量查询个人信息】接口查询获得 + /// Person ID，详细信息可通过接口文档[【查询个人信息接口】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/person/get)接口查询获得 /// 必填：否 /// 示例值：151515151 /// @@ -154,7 +154,7 @@ public record ObjectFieldData /// /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", [\"id1\",\"id2\"], "2006-01-02 15:04:05") /// 必填：是 - /// 示例值：\"Sandy\" + /// 示例值：Sandy /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -192,14 +192,14 @@ public record ObjectFieldData public Enum? SigningType { get; set; } /// - /// 合同协议状态，枚举值可通过文档【飞书人事枚举常量】合同协议状态（contract_status）枚举定义部分获得 + /// 合同协议状态，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)合同协议状态（contract_status）枚举定义部分获得 /// 必填：否 /// [JsonPropertyName("contract_status")] public Enum? ContractStatus { get; set; } /// - /// 续签状态，枚举值可通过文档【飞书人事枚举常量】续签状态（renewal_status）枚举定义部分获得 + /// 续签状态，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)续签状态（renewal_status）枚举定义部分获得 /// 必填：否 /// [JsonPropertyName("renewal_status")] diff --git a/src/FeishuPeople/GetCorehrV1LeavesLeaveRequestHistoryResponseDto.cs b/src/FeishuPeople/GetCorehrV1LeavesLeaveRequestHistoryResponseDto.cs index 3132393e..79fe3197 100644 --- a/src/FeishuPeople/GetCorehrV1LeavesLeaveRequestHistoryResponseDto.cs +++ b/src/FeishuPeople/GetCorehrV1LeavesLeaveRequestHistoryResponseDto.cs @@ -303,7 +303,7 @@ public record LeaveRequestDetail public int? DataSource { get; set; } /// - /// 请假申请流程ID + /// 请假申请流程ID。注意：导入的请假不会返回leave_process_id /// 必填：否 /// [JsonPropertyName("leave_process_id")] diff --git a/src/FeishuPeople/PatchCorehrV1ContractsByContractIdBodyDto.cs b/src/FeishuPeople/PatchCorehrV1ContractsByContractIdBodyDto.cs index a8bca54b..b149fdf7 100644 --- a/src/FeishuPeople/PatchCorehrV1ContractsByContractIdBodyDto.cs +++ b/src/FeishuPeople/PatchCorehrV1ContractsByContractIdBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.FeishuPeople; /// /// 更新合同 请求体 -/// 更新合同。 +/// 通过该接口可以更新员工合同相关信息，没有修改的参数会保留原值 /// 接口ID：7072977430599892994 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/contract/patch /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fcorehr-v1%2fcontract%2fpatch @@ -24,21 +24,21 @@ public record PatchCorehrV1ContractsByContractIdBodyDto /// /// 合同开始日期 /// 必填：否 - /// 示例值：2050-01-0100:00:00 + /// 示例值：2050-01-01 00:00:00 /// [JsonPropertyName("effective_time")] public string? EffectiveTime { get; set; } /// - /// 实际结束日期 + /// 合同实际结束日期，合同实际结束日期小于等于合同结束日期 /// 必填：否 - /// 示例值：9999-12-3123:59:59 + /// 示例值：9999-12-31 23:59:59 /// [JsonPropertyName("expiration_time")] public string? ExpirationTime { get; set; } /// - /// 雇员 ID，枚举值及详细信息可通过【批量查询雇佣信息】接口查询获得 + /// 雇员 ID，详细信息可通过[【搜索员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search)接口查询获得 /// 必填：否 /// 示例值：6893013238632416776 /// @@ -60,14 +60,15 @@ public record Enum /// /// 枚举值 /// 必填：是 - /// 示例值：type_1 + /// 示例值：labor_contract /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; } /// - /// 甲方, 引用Company的ID，枚举值及详细信息可通过【批量查询公司】接口查询获得 + /// 甲方, 引用Company的ID，详细信息可通过[【查询单个公司】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/get) + /// 接口查询获得 /// 必填：否 /// 示例值：6892686614112241165 /// @@ -75,7 +76,7 @@ public record Enum public string? FirstPartyCompanyId { get; set; } /// - /// Person ID，枚举值及详细信息可通过【批量查询个人信息】接口查询获得 + /// Person ID，详细信息可通过[【搜索员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search)接口查询获得 /// 必填：否 /// 示例值：151515151 /// @@ -105,7 +106,7 @@ public record ObjectFieldData /// /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", [\"id1\",\"id2\"], "2006-01-02 15:04:05") /// 必填：是 - /// 示例值：\"Sandy\" + /// 示例值：Sandy /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -120,7 +121,7 @@ public record ObjectFieldData public Enum? DurationType { get; set; } /// - /// 合同结束日期 + /// 合同预计的结束日期 /// 必填：否 /// 示例值：2006-01-02 /// diff --git a/src/FeishuPeople/PatchCorehrV1ContractsByContractIdResponseDto.cs b/src/FeishuPeople/PatchCorehrV1ContractsByContractIdResponseDto.cs index 05d81306..72648f62 100644 --- a/src/FeishuPeople/PatchCorehrV1ContractsByContractIdResponseDto.cs +++ b/src/FeishuPeople/PatchCorehrV1ContractsByContractIdResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.FeishuPeople; /// /// 更新合同 响应体 -/// 更新合同。 +/// 通过该接口可以更新员工合同相关信息，没有修改的参数会保留原值 /// 接口ID：7072977430599892994 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/contract/patch /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fcorehr-v1%2fcontract%2fpatch @@ -44,7 +44,7 @@ public record PatchCorehrV1ContractsByContractIdResponseDtoContract /// /// 合同开始日期 /// 必填：是 - /// 示例值：2050-01-0100:00:00 + /// 示例值：2050-01-01 00:00:00 /// [JsonPropertyName("effective_time")] public string EffectiveTime { get; set; } = string.Empty; @@ -52,13 +52,14 @@ public record PatchCorehrV1ContractsByContractIdResponseDtoContract /// /// 实际结束日期 /// 必填：否 - /// 示例值：9999-12-3123:59:59 + /// 示例值：9999-12-31 23:59:59 /// [JsonPropertyName("expiration_time")] public string? ExpirationTime { get; set; } /// - /// 雇员 ID，枚举值及详细信息可通过【批量查询雇佣信息】接口查询获得 + /// 雇员 ID，详细信息可通过[【批量查询员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get) + /// 接口查询获得 /// 必填：是 /// 示例值：6893013238632416776 /// @@ -80,7 +81,7 @@ public record Enum /// /// 枚举值 /// 必填：是 - /// 示例值：type_1 + /// 示例值：labor_contract /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; @@ -108,7 +109,7 @@ public record I18n /// /// 名称信息的内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：劳动合同 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -116,7 +117,7 @@ public record I18n } /// - /// 甲方, 引用Company的ID，枚举值及详细信息可通过【批量查询公司】接口查询获得 + /// 合同主体, 详细信息可通过[【查询公司详情接口】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/get)接口查询获得 /// 必填：是 /// 示例值：6892686614112241165 /// @@ -124,7 +125,7 @@ public record I18n public string FirstPartyCompanyId { get; set; } = string.Empty; /// - /// Person ID，枚举值及详细信息可通过【批量查询个人信息】接口查询获得 + /// Person ID，详细信息可通过接口文档[【查询个人信息接口】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/person/get)接口查询获得 /// 必填：否 /// 示例值：151515151 /// @@ -154,7 +155,7 @@ public record ObjectFieldData /// /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", [\"id1\",\"id2\"], "2006-01-02 15:04:05") /// 必填：是 - /// 示例值：\"Sandy\" + /// 示例值：Sandy /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; diff --git a/src/FeishuPeople/PostCorehrV1ContractsBodyDto.cs b/src/FeishuPeople/PostCorehrV1ContractsBodyDto.cs index 615d6b8e..60e2cb15 100644 --- a/src/FeishuPeople/PostCorehrV1ContractsBodyDto.cs +++ b/src/FeishuPeople/PostCorehrV1ContractsBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.FeishuPeople; /// /// 创建合同 请求体 -/// 创建合同。 +/// 通过本接口可以为员工创建合同 /// 接口ID：7017707615190876163 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/contract/create /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fcorehr-v1%2fcontract%2fcreate @@ -22,17 +22,17 @@ namespace FeishuNetSdk.FeishuPeople; public record PostCorehrV1ContractsBodyDto { /// - /// 合同开始日期 + /// 合同开始日期，格式："YYYY-MM-DD HH-mm-ss" /// 必填：是 - /// 示例值：2050-01-0100:00:00 + /// 示例值：2050-01-01 00:00:00 /// [JsonPropertyName("effective_time")] public string EffectiveTime { get; set; } = string.Empty; /// - /// 实际结束日期 + /// 实际结束日期,格式："YYYY-MM-DD HH-mm-ss" /// 必填：否 - /// 示例值：9999-12-3123:59:59 + /// 示例值：9999-12-31 23:59:59 /// [JsonPropertyName("expiration_time")] public string? ExpirationTime { get; set; } @@ -46,32 +46,28 @@ public record PostCorehrV1ContractsBodyDto public string EmploymentId { get; set; } = string.Empty; /// - /// 合同类型，枚举值 api_name 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： - /// - object_api_name = "contract" - /// - custom_api_name = "contract_type" + /// 合同类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)合同类型（contract_type）枚举定义部分获得 /// 必填：是 /// [JsonPropertyName("contract_type")] public Enum ContractType { get; set; } = new(); /// - /// 合同类型，枚举值 api_name 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： - /// - object_api_name = "contract" - /// - custom_api_name = "contract_type" + /// 合同类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)合同类型（contract_type）枚举定义部分获得 /// public record Enum { /// /// 枚举值 /// 必填：是 - /// 示例值：type_1 + /// 示例值：labor_contract /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; } /// - /// 甲方, 引用Company的ID，详细信息可通过[【查询单个公司】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/get)接口查询获得 + /// 合同签约公司, 引用的公司ID，详细信息可通过[【查询单个公司】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/get)接口查询获得 /// 必填：是 /// 示例值：6892686614112241165 /// @@ -79,7 +75,7 @@ public record Enum public string FirstPartyCompanyId { get; set; } = string.Empty; /// - /// Person ID，详细信息可通过[【查询单个个人信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/person/get)接口查询获得 + /// 合同签约人ID，详细信息可通过[【查询单个个人信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/person/get)接口查询获得 /// 必填：否 /// 示例值：151515151 /// @@ -109,16 +105,14 @@ public record ObjectFieldData /// /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", [\"id1\",\"id2\"], "2006-01-02 15:04:05") /// 必填：是 - /// 示例值：\"Sandy\" + /// 示例值：Sandy /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; } /// - /// 期限类型，枚举值 api_name 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： - /// - object_api_name = "contract" - /// - custom_api_name = "duration_type" + /// 期限类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)合同期限类型（duration_type）枚举定义部分获得 /// 必填：否 /// 示例值：fixed_term /// @@ -126,7 +120,7 @@ public record ObjectFieldData public Enum? DurationType { get; set; } /// - /// 合同结束日期 + /// 合同结束日期，格式："YYYY-MM-DD" /// 必填：否 /// 示例值：2006-01-02 /// @@ -142,9 +136,7 @@ public record ObjectFieldData public string? ContractNumber { get; set; } /// - /// 签订类型，枚举值 api_name 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： - /// - object_api_name = "contract" - /// - custom_api_name = "signing_type" + /// 签订类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)签订类型（signing_type）枚举定义部分获得 /// 必填：否 /// [JsonPropertyName("signing_type")] diff --git a/src/FeishuPeople/PostCorehrV1ContractsResponseDto.cs b/src/FeishuPeople/PostCorehrV1ContractsResponseDto.cs index 36c71efe..af67c0cc 100644 --- a/src/FeishuPeople/PostCorehrV1ContractsResponseDto.cs +++ b/src/FeishuPeople/PostCorehrV1ContractsResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.FeishuPeople; /// /// 创建合同 响应体 -/// 创建合同。 +/// 通过本接口可以为员工创建合同 /// 接口ID：7017707615190876163 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/contract/create /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fcorehr-v1%2fcontract%2fcreate @@ -44,7 +44,7 @@ public record PostCorehrV1ContractsResponseDtoContract /// /// 合同开始日期 /// 必填：是 - /// 示例值：2050-01-0100:00:00 + /// 示例值：2050-01-01 00:00:00 /// [JsonPropertyName("effective_time")] public string EffectiveTime { get; set; } = string.Empty; @@ -52,7 +52,7 @@ public record PostCorehrV1ContractsResponseDtoContract /// /// 实际结束日期 /// 必填：否 - /// 示例值：9999-12-3123:59:59 + /// 示例值：9999-12-31 23:59:59 /// [JsonPropertyName("expiration_time")] public string? ExpirationTime { get; set; } @@ -66,25 +66,21 @@ public record PostCorehrV1ContractsResponseDtoContract public string EmploymentId { get; set; } = string.Empty; /// - /// 合同类型，枚举值 api_name 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： - /// - object_api_name = "contract" - /// - custom_api_name = "contract_type" + /// 合同类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)合同类型（contract_type）枚举定义部分获得 /// 必填：是 /// [JsonPropertyName("contract_type")] public Enum ContractType { get; set; } = new(); /// - /// 合同类型，枚举值 api_name 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： - /// - object_api_name = "contract" - /// - custom_api_name = "contract_type" + /// 合同类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)合同类型（contract_type）枚举定义部分获得 /// public record Enum { /// /// 枚举值 /// 必填：是 - /// 示例值：type_1 + /// 示例值：labor_contract /// [JsonPropertyName("enum_name")] public string EnumName { get; set; } = string.Empty; @@ -112,7 +108,7 @@ public record I18n /// /// 名称信息的内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：劳动合同 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -120,7 +116,7 @@ public record I18n } /// - /// 甲方, 引用Company的ID，详细信息可通过[【查询单个公司】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/get)接口查询获得 + /// 合同签订的公司主体, 引用Company的ID，详细信息可通过[【查询单个公司】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/get)接口查询获得 /// 必填：是 /// 示例值：6892686614112241165 /// @@ -158,16 +154,14 @@ public record ObjectFieldData /// /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", [\"id1\",\"id2\"], "2006-01-02 15:04:05") /// 必填：是 - /// 示例值：\"Sandy\" + /// 示例值：Sandy /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; } /// - /// 期限类型，枚举值 api_name 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： - /// - object_api_name = "contract" - /// - custom_api_name = "duration_type" + /// 期限类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)合同期限类型（duration_type）枚举定义部分获得 /// 必填：否 /// 示例值：fixed_term /// @@ -191,9 +185,7 @@ public record ObjectFieldData public string? ContractNumber { get; set; } /// - /// 签订类型，枚举值 api_name 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： - /// - object_api_name = "contract" - /// - custom_api_name = "signing_type" + /// 签订类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)签订类型（signing_type）枚举定义部分获得 /// 必填：否 /// [JsonPropertyName("signing_type")] diff --git a/src/Hire/GetHireV1TalentsByTalentIdResponseDto.cs b/src/Hire/GetHireV1TalentsByTalentIdResponseDto.cs index f1b07348..6b854ec4 100644 --- a/src/Hire/GetHireV1TalentsByTalentIdResponseDto.cs +++ b/src/Hire/GetHireV1TalentsByTalentIdResponseDto.cs @@ -4,7 +4,7 @@ // Created : 2024-06-26 // // Last Modified By : yxr -// Last Modified On : 2024-06-26 +// Last Modified On : 2024-07-24 // ************************************************************************ // // MIT @@ -265,7 +265,7 @@ public record TalentCityInfo /// 示例值：1687872017 /// [JsonPropertyName("birthday")] - public int? Birthday { get; set; } + public long? Birthday { get; set; } /// /// 创建人 @@ -303,253 +303,253 @@ public record TalentCityInfo public TalentCustomizedDataChild[]? CustomizedDataLists { get; set; } /// - /// 修改时间 - /// 必填：否 - /// 示例值：1634801678103 - /// - [JsonPropertyName("modify_time")] - public string? ModifyTime { get; set; } - - /// - /// 户口所在地 - /// 必填：否 - /// 示例值：CN_1 - /// - [JsonPropertyName("hukou_location_code")] - public string? HukouLocationCode { get; set; } - } - - /// - /// 自定义字段 - /// - public record TalentCustomizedDataChild - { - /// - /// 自定义字段 ID - /// 必填：否 - /// 示例值：xxxx - /// - [JsonPropertyName("object_id")] - public string? ObjectId { get; set; } - - /// - /// 字段名称 - /// 必填：否 - /// - [JsonPropertyName("name")] - public I18n? Name { get; set; } - - /// - /// 字段名称 + /// 自定义字段 /// - public record I18n + public record TalentCustomizedDataChild { /// - /// 中文 + /// 自定义字段 ID /// 必填：否 - /// 示例值：测试 + /// 示例值：xxxx /// - [JsonPropertyName("zh_cn")] - public string? ZhCn { get; set; } + [JsonPropertyName("object_id")] + public string? ObjectId { get; set; } /// - /// 英文 + /// 字段名称 /// 必填：否 - /// 示例值：test /// - [JsonPropertyName("en_us")] - public string? EnUs { get; set; } - } + [JsonPropertyName("name")] + public I18n? Name { get; set; } - /// - /// 字段类型 - /// 必填：否 - /// 示例值：1 - /// 可选值： - /// 1：单行文本 - /// 2：多行文本 - /// 3：单选 - /// 4：多选 - /// 5：日期 - /// 6：月份选择 - /// 7：年份选择 - /// 8：时间段 - /// 9：数字 - /// 10：默认字段 - /// 11：模块 - /// 13：附件 - /// - /// - [JsonPropertyName("object_type")] - public int? ObjectType { get; set; } + /// + /// 字段名称 + /// + public record I18n + { + /// + /// 中文 + /// 必填：否 + /// 示例值：测试 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } - /// - /// 自定义字段值 - /// 必填：否 - /// - [JsonPropertyName("value")] - public TalentCustomizedValue? Value { get; set; } + /// + /// 英文 + /// 必填：否 + /// 示例值：test + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } - /// - /// 自定义字段值 - /// - public record TalentCustomizedValue - { /// - /// 当字段类型为单行文本、多行文本、模块、默认字段时，从此字段取值 + /// 字段类型 /// 必填：否 - /// 示例值：text + /// 示例值：1 + /// 可选值： + /// 1：单行文本 + /// 2：多行文本 + /// 3：单选 + /// 4：多选 + /// 5：日期 + /// 6：月份选择 + /// 7：年份选择 + /// 8：时间段 + /// 9：数字 + /// 10：默认字段 + /// 11：模块 + /// 13：附件 + /// /// - [JsonPropertyName("content")] - public string? Content { get; set; } + [JsonPropertyName("object_type")] + public int? ObjectType { get; set; } /// - /// 当字段类型为单选时，从此字段取值 + /// 自定义字段值 /// 必填：否 /// - [JsonPropertyName("option")] - public TalentCustomizedOption? Option { get; set; } + [JsonPropertyName("value")] + public TalentCustomizedValue? Value { get; set; } /// - /// 当字段类型为单选时，从此字段取值 + /// 自定义字段值 /// - public record TalentCustomizedOption + public record TalentCustomizedValue { /// - /// 选项 ID + /// 当字段类型为单行文本、多行文本、模块、默认字段时，从此字段取值 /// 必填：否 - /// 示例值：AA + /// 示例值：text /// - [JsonPropertyName("key")] - public string? Key { get; set; } + [JsonPropertyName("content")] + public string? Content { get; set; } /// - /// 选项名称 + /// 当字段类型为单选时，从此字段取值 /// 必填：否 /// - [JsonPropertyName("name")] - public I18n? Name { get; set; } + [JsonPropertyName("option")] + public TalentCustomizedOption? Option { get; set; } /// - /// 选项名称 + /// 当字段类型为单选时，从此字段取值 /// - public record I18n + public record TalentCustomizedOption { /// - /// 中文 + /// 选项 ID /// 必填：否 - /// 示例值：测试 + /// 示例值：AA /// - [JsonPropertyName("zh_cn")] - public string? ZhCn { get; set; } + [JsonPropertyName("key")] + public string? Key { get; set; } /// - /// 英文 + /// 选项名称 /// 必填：否 - /// 示例值：test /// - [JsonPropertyName("en_us")] - public string? EnUs { get; set; } - } - } - - /// - /// 当字段类型为多选时，从此字段取值 - /// 必填：否 - /// - [JsonPropertyName("option_list")] - public TalentCustomizedOption[]? OptionLists { get; set; } + [JsonPropertyName("name")] + public I18n? Name { get; set; } - /// - /// 当字段类型为时间段时，从此字段取值 - /// 必填：否 - /// - [JsonPropertyName("time_range")] - public TalentCustomizedTimeRange? TimeRange { get; set; } + /// + /// 选项名称 + /// + public record I18n + { + /// + /// 中文 + /// 必填：否 + /// 示例值：测试 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 英文 + /// 必填：否 + /// 示例值：test + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + } - /// - /// 当字段类型为时间段时，从此字段取值 - /// - public record TalentCustomizedTimeRange - { /// - /// 开始时间 + /// 当字段类型为多选时，从此字段取值 /// 必填：否 - /// 示例值：1625456721 /// - [JsonPropertyName("start_time")] - public string? StartTime { get; set; } + [JsonPropertyName("option_list")] + public TalentCustomizedOption[]? OptionLists { get; set; } /// - /// 结束时间，当值为至今时，返回「-」 + /// 当字段类型为时间段时，从此字段取值 /// 必填：否 - /// 示例值：1625656721 /// - [JsonPropertyName("end_time")] - public string? EndTime { get; set; } - } + [JsonPropertyName("time_range")] + public TalentCustomizedTimeRange? TimeRange { get; set; } - /// - /// 当字段类型为日期选择、月份选择、年份选择时，从此字段取值，该字段是秒级时间戳 - /// 必填：否 - /// 示例值：1625456721 - /// - [JsonPropertyName("time")] - public string? Time { get; set; } - - /// - /// 当字段类型为数字时，从此字段取值 - /// 必填：否 - /// 示例值：111 - /// - [JsonPropertyName("number")] - public string? Number { get; set; } + /// + /// 当字段类型为时间段时，从此字段取值 + /// + public record TalentCustomizedTimeRange + { + /// + /// 开始时间 + /// 必填：否 + /// 示例值：1625456721 + /// + [JsonPropertyName("start_time")] + public string? StartTime { get; set; } - /// - /// 当字段类型为附件时，从此字段取值 - /// 必填：否 - /// - [JsonPropertyName("customized_attachment")] - public TalentCustomizedAttachment[]? CustomizedAttachments { get; set; } + /// + /// 结束时间，当值为至今时，返回「-」 + /// 必填：否 + /// 示例值：1625656721 + /// + [JsonPropertyName("end_time")] + public string? EndTime { get; set; } + } - /// - /// 当字段类型为附件时，从此字段取值 - /// - public record TalentCustomizedAttachment - { /// - /// 附件 ID + /// 当字段类型为日期选择、月份选择、年份选择时，从此字段取值，该字段是秒级时间戳 /// 必填：否 - /// 示例值：7140517838785481004 + /// 示例值：1625456721 /// - [JsonPropertyName("file_id")] - public string? FileId { get; set; } + [JsonPropertyName("time")] + public string? Time { get; set; } /// - /// 附件名称 + /// 当字段类型为数字时，从此字段取值 /// 必填：否 - /// 示例值：1.13测试1的面试记录.pdf + /// 示例值：111 /// - [JsonPropertyName("name")] - public string? Name { get; set; } + [JsonPropertyName("number")] + public string? Number { get; set; } /// - /// 附件类型 + /// 当字段类型为附件时，从此字段取值 /// 必填：否 - /// 示例值：application/pdf /// - [JsonPropertyName("content_type")] - public string? ContentType { get; set; } + [JsonPropertyName("customized_attachment")] + public TalentCustomizedAttachment[]? CustomizedAttachments { get; set; } /// - /// 附件大小 - /// 必填：否 - /// 示例值：16615 + /// 当字段类型为附件时，从此字段取值 /// - [JsonPropertyName("file_size")] - public int? FileSize { get; set; } + public record TalentCustomizedAttachment + { + /// + /// 附件 ID + /// 必填：否 + /// 示例值：7140517838785481004 + /// + [JsonPropertyName("file_id")] + public string? FileId { get; set; } + + /// + /// 附件名称 + /// 必填：否 + /// 示例值：1.13测试1的面试记录.pdf + /// + [JsonPropertyName("name")] + public string? Name { get; set; } + + /// + /// 附件类型 + /// 必填：否 + /// 示例值：application/pdf + /// + [JsonPropertyName("content_type")] + public string? ContentType { get; set; } + + /// + /// 附件大小 + /// 必填：否 + /// 示例值：16615 + /// + [JsonPropertyName("file_size")] + public int? FileSize { get; set; } + } } } + + /// + /// 修改时间 + /// 必填：否 + /// 示例值：1634801678103 + /// + [JsonPropertyName("modify_time")] + public string? ModifyTime { get; set; } + + /// + /// 户口所在地 + /// 必填：否 + /// 示例值：CN_1 + /// + [JsonPropertyName("hukou_location_code")] + public string? HukouLocationCode { get; set; } } /// @@ -675,88 +675,321 @@ public record TalentEducationInfo /// [JsonPropertyName("customized_data_list")] public TalentCustomizedDataChild[]? CustomizedDataLists { get; set; } - } - - /// - /// 工作经历 - /// 必填：否 - /// - [JsonPropertyName("career_list")] - public TalentCareerInfo[]? CareerLists { get; set; } - /// - /// 工作经历 - /// - public record TalentCareerInfo - { /// - /// ID - /// 必填：否 - /// 示例值：6891560630172518670 + /// 自定义字段 /// - [JsonPropertyName("id")] - public string? Id { get; set; } + public record TalentCustomizedDataChild + { + /// + /// 自定义字段 ID + /// 必填：否 + /// 示例值：xxxx + /// + [JsonPropertyName("object_id")] + public string? ObjectId { get; set; } - /// - /// 公司名称 - /// 必填：否 - /// 示例值：测试公司 - /// - [JsonPropertyName("company")] - public string? Company { get; set; } + /// + /// 字段名称 + /// 必填：否 + /// + [JsonPropertyName("name")] + public I18n? Name { get; set; } - /// - /// 职位名称 - /// 必填：否 - /// 示例值：高级工程师 - /// - [JsonPropertyName("title")] - public string? Title { get; set; } + /// + /// 字段名称 + /// + public record I18n + { + /// + /// 中文 + /// 必填：否 + /// 示例值：测试 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } - /// - /// 描述 - /// 必填：否 - /// 示例值：测试 - /// - [JsonPropertyName("desc")] - public string? Desc { get; set; } + /// + /// 英文 + /// 必填：否 + /// 示例值：test + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } - /// - /// 开始时间 - /// 必填：否 - /// 示例值：1990-01 - /// - [JsonPropertyName("start_time")] - public string? StartTime { get; set; } + /// + /// 字段类型 + /// 必填：否 + /// 示例值：1 + /// 可选值： + /// 1：单行文本 + /// 2：多行文本 + /// 3：单选 + /// 4：多选 + /// 5：日期 + /// 6：月份选择 + /// 7：年份选择 + /// 8：时间段 + /// 9：数字 + /// 10：默认字段 + /// 11：模块 + /// 13：附件 + /// + /// + [JsonPropertyName("object_type")] + public int? ObjectType { get; set; } - /// - /// 结束时间 - /// 必填：否 - /// 示例值：1994-01 - /// - [JsonPropertyName("end_time")] - public string? EndTime { get; set; } + /// + /// 自定义字段值 + /// 必填：否 + /// + [JsonPropertyName("value")] + public TalentCustomizedValue? Value { get; set; } - /// - /// 经历类型 - /// 必填：否 - /// 示例值：1 - /// 可选值： - /// 1：实习经历 - /// 2：工作经历 - /// 3：兼职经历 - /// 4：其他经历 - /// - /// - [JsonPropertyName("career_type")] - public int? CareerType { get; set; } + /// + /// 自定义字段值 + /// + public record TalentCustomizedValue + { + /// + /// 当字段类型为单行文本、多行文本、模块、默认字段时，从此字段取值 + /// 必填：否 + /// 示例值：text + /// + [JsonPropertyName("content")] + public string? Content { get; set; } - /// - /// 工作经历标签 - /// 必填：否 - /// - [JsonPropertyName("tag_list")] - public int[]? TagList { get; set; } + /// + /// 当字段类型为单选时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("option")] + public TalentCustomizedOption? Option { get; set; } + + /// + /// 当字段类型为单选时，从此字段取值 + /// + public record TalentCustomizedOption + { + /// + /// 选项 ID + /// 必填：否 + /// 示例值：AA + /// + [JsonPropertyName("key")] + public string? Key { get; set; } + + /// + /// 选项名称 + /// 必填：否 + /// + [JsonPropertyName("name")] + public I18n? Name { get; set; } + + /// + /// 选项名称 + /// + public record I18n + { + /// + /// 中文 + /// 必填：否 + /// 示例值：测试 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 英文 + /// 必填：否 + /// 示例值：test + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + } + + /// + /// 当字段类型为多选时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("option_list")] + public TalentCustomizedOption[]? OptionLists { get; set; } + + /// + /// 当字段类型为时间段时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("time_range")] + public TalentCustomizedTimeRange? TimeRange { get; set; } + + /// + /// 当字段类型为时间段时，从此字段取值 + /// + public record TalentCustomizedTimeRange + { + /// + /// 开始时间 + /// 必填：否 + /// 示例值：1625456721 + /// + [JsonPropertyName("start_time")] + public string? StartTime { get; set; } + + /// + /// 结束时间，当值为至今时，返回「-」 + /// 必填：否 + /// 示例值：1625656721 + /// + [JsonPropertyName("end_time")] + public string? EndTime { get; set; } + } + + /// + /// 当字段类型为日期选择、月份选择、年份选择时，从此字段取值，该字段是秒级时间戳 + /// 必填：否 + /// 示例值：1625456721 + /// + [JsonPropertyName("time")] + public string? Time { get; set; } + + /// + /// 当字段类型为数字时，从此字段取值 + /// 必填：否 + /// 示例值：111 + /// + [JsonPropertyName("number")] + public string? Number { get; set; } + + /// + /// 当字段类型为附件时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("customized_attachment")] + public TalentCustomizedAttachment[]? CustomizedAttachments { get; set; } + + /// + /// 当字段类型为附件时，从此字段取值 + /// + public record TalentCustomizedAttachment + { + /// + /// 附件 ID + /// 必填：否 + /// 示例值：7140517838785481004 + /// + [JsonPropertyName("file_id")] + public string? FileId { get; set; } + + /// + /// 附件名称 + /// 必填：否 + /// 示例值：1.13测试1的面试记录.pdf + /// + [JsonPropertyName("name")] + public string? Name { get; set; } + + /// + /// 附件类型 + /// 必填：否 + /// 示例值：application/pdf + /// + [JsonPropertyName("content_type")] + public string? ContentType { get; set; } + + /// + /// 附件大小 + /// 必填：否 + /// 示例值：16615 + /// + [JsonPropertyName("file_size")] + public int? FileSize { get; set; } + } + } + } + } + + /// + /// 工作经历 + /// 必填：否 + /// + [JsonPropertyName("career_list")] + public TalentCareerInfo[]? CareerLists { get; set; } + + /// + /// 工作经历 + /// + public record TalentCareerInfo + { + /// + /// ID + /// 必填：否 + /// 示例值：6891560630172518670 + /// + [JsonPropertyName("id")] + public string? Id { get; set; } + + /// + /// 公司名称 + /// 必填：否 + /// 示例值：测试公司 + /// + [JsonPropertyName("company")] + public string? Company { get; set; } + + /// + /// 职位名称 + /// 必填：否 + /// 示例值：高级工程师 + /// + [JsonPropertyName("title")] + public string? Title { get; set; } + + /// + /// 描述 + /// 必填：否 + /// 示例值：测试 + /// + [JsonPropertyName("desc")] + public string? Desc { get; set; } + + /// + /// 开始时间 + /// 必填：否 + /// 示例值：1990-01 + /// + [JsonPropertyName("start_time")] + public string? StartTime { get; set; } + + /// + /// 结束时间 + /// 必填：否 + /// 示例值：1994-01 + /// + [JsonPropertyName("end_time")] + public string? EndTime { get; set; } + + /// + /// 经历类型 + /// 必填：否 + /// 示例值：1 + /// 可选值： + /// 1：实习经历 + /// 2：工作经历 + /// 3：兼职经历 + /// 4：其他经历 + /// + /// + [JsonPropertyName("career_type")] + public int? CareerType { get; set; } + + /// + /// 工作经历标签 + /// 必填：否 + /// + [JsonPropertyName("tag_list")] + public int[]? TagList { get; set; } /// /// 自定义字段 @@ -764,6 +997,239 @@ public record TalentCareerInfo /// [JsonPropertyName("customized_data_list")] public TalentCustomizedDataChild[]? CustomizedDataLists { get; set; } + + /// + /// 自定义字段 + /// + public record TalentCustomizedDataChild + { + /// + /// 自定义字段 ID + /// 必填：否 + /// 示例值：xxxx + /// + [JsonPropertyName("object_id")] + public string? ObjectId { get; set; } + + /// + /// 字段名称 + /// 必填：否 + /// + [JsonPropertyName("name")] + public I18n? Name { get; set; } + + /// + /// 字段名称 + /// + public record I18n + { + /// + /// 中文 + /// 必填：否 + /// 示例值：测试 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 英文 + /// 必填：否 + /// 示例值：test + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 字段类型 + /// 必填：否 + /// 示例值：1 + /// 可选值： + /// 1：单行文本 + /// 2：多行文本 + /// 3：单选 + /// 4：多选 + /// 5：日期 + /// 6：月份选择 + /// 7：年份选择 + /// 8：时间段 + /// 9：数字 + /// 10：默认字段 + /// 11：模块 + /// 13：附件 + /// + /// + [JsonPropertyName("object_type")] + public int? ObjectType { get; set; } + + /// + /// 自定义字段值 + /// 必填：否 + /// + [JsonPropertyName("value")] + public TalentCustomizedValue? Value { get; set; } + + /// + /// 自定义字段值 + /// + public record TalentCustomizedValue + { + /// + /// 当字段类型为单行文本、多行文本、模块、默认字段时，从此字段取值 + /// 必填：否 + /// 示例值：text + /// + [JsonPropertyName("content")] + public string? Content { get; set; } + + /// + /// 当字段类型为单选时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("option")] + public TalentCustomizedOption? Option { get; set; } + + /// + /// 当字段类型为单选时，从此字段取值 + /// + public record TalentCustomizedOption + { + /// + /// 选项 ID + /// 必填：否 + /// 示例值：AA + /// + [JsonPropertyName("key")] + public string? Key { get; set; } + + /// + /// 选项名称 + /// 必填：否 + /// + [JsonPropertyName("name")] + public I18n? Name { get; set; } + + /// + /// 选项名称 + /// + public record I18n + { + /// + /// 中文 + /// 必填：否 + /// 示例值：测试 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 英文 + /// 必填：否 + /// 示例值：test + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + } + + /// + /// 当字段类型为多选时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("option_list")] + public TalentCustomizedOption[]? OptionLists { get; set; } + + /// + /// 当字段类型为时间段时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("time_range")] + public TalentCustomizedTimeRange? TimeRange { get; set; } + + /// + /// 当字段类型为时间段时，从此字段取值 + /// + public record TalentCustomizedTimeRange + { + /// + /// 开始时间 + /// 必填：否 + /// 示例值：1625456721 + /// + [JsonPropertyName("start_time")] + public string? StartTime { get; set; } + + /// + /// 结束时间，当值为至今时，返回「-」 + /// 必填：否 + /// 示例值：1625656721 + /// + [JsonPropertyName("end_time")] + public string? EndTime { get; set; } + } + + /// + /// 当字段类型为日期选择、月份选择、年份选择时，从此字段取值，该字段是秒级时间戳 + /// 必填：否 + /// 示例值：1625456721 + /// + [JsonPropertyName("time")] + public string? Time { get; set; } + + /// + /// 当字段类型为数字时，从此字段取值 + /// 必填：否 + /// 示例值：111 + /// + [JsonPropertyName("number")] + public string? Number { get; set; } + + /// + /// 当字段类型为附件时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("customized_attachment")] + public TalentCustomizedAttachment[]? CustomizedAttachments { get; set; } + + /// + /// 当字段类型为附件时，从此字段取值 + /// + public record TalentCustomizedAttachment + { + /// + /// 附件 ID + /// 必填：否 + /// 示例值：7140517838785481004 + /// + [JsonPropertyName("file_id")] + public string? FileId { get; set; } + + /// + /// 附件名称 + /// 必填：否 + /// 示例值：1.13测试1的面试记录.pdf + /// + [JsonPropertyName("name")] + public string? Name { get; set; } + + /// + /// 附件类型 + /// 必填：否 + /// 示例值：application/pdf + /// + [JsonPropertyName("content_type")] + public string? ContentType { get; set; } + + /// + /// 附件大小 + /// 必填：否 + /// 示例值：16615 + /// + [JsonPropertyName("file_size")] + public int? FileSize { get; set; } + } + } + } } /// @@ -840,6 +1306,239 @@ public record TalentProjectInfo /// [JsonPropertyName("customized_data_list")] public TalentCustomizedDataChild[]? CustomizedDataLists { get; set; } + + /// + /// 自定义字段 + /// + public record TalentCustomizedDataChild + { + /// + /// 自定义字段 ID + /// 必填：否 + /// 示例值：xxxx + /// + [JsonPropertyName("object_id")] + public string? ObjectId { get; set; } + + /// + /// 字段名称 + /// 必填：否 + /// + [JsonPropertyName("name")] + public I18n? Name { get; set; } + + /// + /// 字段名称 + /// + public record I18n + { + /// + /// 中文 + /// 必填：否 + /// 示例值：测试 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 英文 + /// 必填：否 + /// 示例值：test + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 字段类型 + /// 必填：否 + /// 示例值：1 + /// 可选值： + /// 1：单行文本 + /// 2：多行文本 + /// 3：单选 + /// 4：多选 + /// 5：日期 + /// 6：月份选择 + /// 7：年份选择 + /// 8：时间段 + /// 9：数字 + /// 10：默认字段 + /// 11：模块 + /// 13：附件 + /// + /// + [JsonPropertyName("object_type")] + public int? ObjectType { get; set; } + + /// + /// 自定义字段值 + /// 必填：否 + /// + [JsonPropertyName("value")] + public TalentCustomizedValue? Value { get; set; } + + /// + /// 自定义字段值 + /// + public record TalentCustomizedValue + { + /// + /// 当字段类型为单行文本、多行文本、模块、默认字段时，从此字段取值 + /// 必填：否 + /// 示例值：text + /// + [JsonPropertyName("content")] + public string? Content { get; set; } + + /// + /// 当字段类型为单选时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("option")] + public TalentCustomizedOption? Option { get; set; } + + /// + /// 当字段类型为单选时，从此字段取值 + /// + public record TalentCustomizedOption + { + /// + /// 选项 ID + /// 必填：否 + /// 示例值：AA + /// + [JsonPropertyName("key")] + public string? Key { get; set; } + + /// + /// 选项名称 + /// 必填：否 + /// + [JsonPropertyName("name")] + public I18n? Name { get; set; } + + /// + /// 选项名称 + /// + public record I18n + { + /// + /// 中文 + /// 必填：否 + /// 示例值：测试 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 英文 + /// 必填：否 + /// 示例值：test + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + } + + /// + /// 当字段类型为多选时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("option_list")] + public TalentCustomizedOption[]? OptionLists { get; set; } + + /// + /// 当字段类型为时间段时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("time_range")] + public TalentCustomizedTimeRange? TimeRange { get; set; } + + /// + /// 当字段类型为时间段时，从此字段取值 + /// + public record TalentCustomizedTimeRange + { + /// + /// 开始时间 + /// 必填：否 + /// 示例值：1625456721 + /// + [JsonPropertyName("start_time")] + public string? StartTime { get; set; } + + /// + /// 结束时间，当值为至今时，返回「-」 + /// 必填：否 + /// 示例值：1625656721 + /// + [JsonPropertyName("end_time")] + public string? EndTime { get; set; } + } + + /// + /// 当字段类型为日期选择、月份选择、年份选择时，从此字段取值，该字段是秒级时间戳 + /// 必填：否 + /// 示例值：1625456721 + /// + [JsonPropertyName("time")] + public string? Time { get; set; } + + /// + /// 当字段类型为数字时，从此字段取值 + /// 必填：否 + /// 示例值：111 + /// + [JsonPropertyName("number")] + public string? Number { get; set; } + + /// + /// 当字段类型为附件时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("customized_attachment")] + public TalentCustomizedAttachment[]? CustomizedAttachments { get; set; } + + /// + /// 当字段类型为附件时，从此字段取值 + /// + public record TalentCustomizedAttachment + { + /// + /// 附件 ID + /// 必填：否 + /// 示例值：7140517838785481004 + /// + [JsonPropertyName("file_id")] + public string? FileId { get; set; } + + /// + /// 附件名称 + /// 必填：否 + /// 示例值：1.13测试1的面试记录.pdf + /// + [JsonPropertyName("name")] + public string? Name { get; set; } + + /// + /// 附件类型 + /// 必填：否 + /// 示例值：application/pdf + /// + [JsonPropertyName("content_type")] + public string? ContentType { get; set; } + + /// + /// 附件大小 + /// 必填：否 + /// 示例值：16615 + /// + [JsonPropertyName("file_size")] + public int? FileSize { get; set; } + } + } + } } /// @@ -886,12 +1585,245 @@ public record TalentWorksInfo [JsonPropertyName("name")] public string? Name { get; set; } - /// - /// 自定义字段 - /// 必填：否 - /// - [JsonPropertyName("customized_data_list")] - public TalentCustomizedDataChild[]? CustomizedDataLists { get; set; } + /// + /// 自定义字段 + /// 必填：否 + /// + [JsonPropertyName("customized_data_list")] + public TalentCustomizedDataChild[]? CustomizedDataLists { get; set; } + + /// + /// 自定义字段 + /// + public record TalentCustomizedDataChild + { + /// + /// 自定义字段 ID + /// 必填：否 + /// 示例值：xxxx + /// + [JsonPropertyName("object_id")] + public string? ObjectId { get; set; } + + /// + /// 字段名称 + /// 必填：否 + /// + [JsonPropertyName("name")] + public I18n? Name { get; set; } + + /// + /// 字段名称 + /// + public record I18n + { + /// + /// 中文 + /// 必填：否 + /// 示例值：测试 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 英文 + /// 必填：否 + /// 示例值：test + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 字段类型 + /// 必填：否 + /// 示例值：1 + /// 可选值： + /// 1：单行文本 + /// 2：多行文本 + /// 3：单选 + /// 4：多选 + /// 5：日期 + /// 6：月份选择 + /// 7：年份选择 + /// 8：时间段 + /// 9：数字 + /// 10：默认字段 + /// 11：模块 + /// 13：附件 + /// + /// + [JsonPropertyName("object_type")] + public int? ObjectType { get; set; } + + /// + /// 自定义字段值 + /// 必填：否 + /// + [JsonPropertyName("value")] + public TalentCustomizedValue? Value { get; set; } + + /// + /// 自定义字段值 + /// + public record TalentCustomizedValue + { + /// + /// 当字段类型为单行文本、多行文本、模块、默认字段时，从此字段取值 + /// 必填：否 + /// 示例值：text + /// + [JsonPropertyName("content")] + public string? Content { get; set; } + + /// + /// 当字段类型为单选时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("option")] + public TalentCustomizedOption? Option { get; set; } + + /// + /// 当字段类型为单选时，从此字段取值 + /// + public record TalentCustomizedOption + { + /// + /// 选项 ID + /// 必填：否 + /// 示例值：AA + /// + [JsonPropertyName("key")] + public string? Key { get; set; } + + /// + /// 选项名称 + /// 必填：否 + /// + [JsonPropertyName("name")] + public I18n? Name { get; set; } + + /// + /// 选项名称 + /// + public record I18n + { + /// + /// 中文 + /// 必填：否 + /// 示例值：测试 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 英文 + /// 必填：否 + /// 示例值：test + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + } + + /// + /// 当字段类型为多选时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("option_list")] + public TalentCustomizedOption[]? OptionLists { get; set; } + + /// + /// 当字段类型为时间段时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("time_range")] + public TalentCustomizedTimeRange? TimeRange { get; set; } + + /// + /// 当字段类型为时间段时，从此字段取值 + /// + public record TalentCustomizedTimeRange + { + /// + /// 开始时间 + /// 必填：否 + /// 示例值：1625456721 + /// + [JsonPropertyName("start_time")] + public string? StartTime { get; set; } + + /// + /// 结束时间，当值为至今时，返回「-」 + /// 必填：否 + /// 示例值：1625656721 + /// + [JsonPropertyName("end_time")] + public string? EndTime { get; set; } + } + + /// + /// 当字段类型为日期选择、月份选择、年份选择时，从此字段取值，该字段是秒级时间戳 + /// 必填：否 + /// 示例值：1625456721 + /// + [JsonPropertyName("time")] + public string? Time { get; set; } + + /// + /// 当字段类型为数字时，从此字段取值 + /// 必填：否 + /// 示例值：111 + /// + [JsonPropertyName("number")] + public string? Number { get; set; } + + /// + /// 当字段类型为附件时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("customized_attachment")] + public TalentCustomizedAttachment[]? CustomizedAttachments { get; set; } + + /// + /// 当字段类型为附件时，从此字段取值 + /// + public record TalentCustomizedAttachment + { + /// + /// 附件 ID + /// 必填：否 + /// 示例值：7140517838785481004 + /// + [JsonPropertyName("file_id")] + public string? FileId { get; set; } + + /// + /// 附件名称 + /// 必填：否 + /// 示例值：1.13测试1的面试记录.pdf + /// + [JsonPropertyName("name")] + public string? Name { get; set; } + + /// + /// 附件类型 + /// 必填：否 + /// 示例值：application/pdf + /// + [JsonPropertyName("content_type")] + public string? ContentType { get; set; } + + /// + /// 附件大小 + /// 必填：否 + /// 示例值：16615 + /// + [JsonPropertyName("file_size")] + public int? FileSize { get; set; } + } + } + } } /// @@ -944,6 +1876,239 @@ public record TalentAwardInfo /// [JsonPropertyName("customized_data_list")] public TalentCustomizedDataChild[]? CustomizedDataLists { get; set; } + + /// + /// 自定义字段 + /// + public record TalentCustomizedDataChild + { + /// + /// 自定义字段 ID + /// 必填：否 + /// 示例值：xxxx + /// + [JsonPropertyName("object_id")] + public string? ObjectId { get; set; } + + /// + /// 字段名称 + /// 必填：否 + /// + [JsonPropertyName("name")] + public I18n? Name { get; set; } + + /// + /// 字段名称 + /// + public record I18n + { + /// + /// 中文 + /// 必填：否 + /// 示例值：测试 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 英文 + /// 必填：否 + /// 示例值：test + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 字段类型 + /// 必填：否 + /// 示例值：1 + /// 可选值： + /// 1：单行文本 + /// 2：多行文本 + /// 3：单选 + /// 4：多选 + /// 5：日期 + /// 6：月份选择 + /// 7：年份选择 + /// 8：时间段 + /// 9：数字 + /// 10：默认字段 + /// 11：模块 + /// 13：附件 + /// + /// + [JsonPropertyName("object_type")] + public int? ObjectType { get; set; } + + /// + /// 自定义字段值 + /// 必填：否 + /// + [JsonPropertyName("value")] + public TalentCustomizedValue? Value { get; set; } + + /// + /// 自定义字段值 + /// + public record TalentCustomizedValue + { + /// + /// 当字段类型为单行文本、多行文本、模块、默认字段时，从此字段取值 + /// 必填：否 + /// 示例值：text + /// + [JsonPropertyName("content")] + public string? Content { get; set; } + + /// + /// 当字段类型为单选时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("option")] + public TalentCustomizedOption? Option { get; set; } + + /// + /// 当字段类型为单选时，从此字段取值 + /// + public record TalentCustomizedOption + { + /// + /// 选项 ID + /// 必填：否 + /// 示例值：AA + /// + [JsonPropertyName("key")] + public string? Key { get; set; } + + /// + /// 选项名称 + /// 必填：否 + /// + [JsonPropertyName("name")] + public I18n? Name { get; set; } + + /// + /// 选项名称 + /// + public record I18n + { + /// + /// 中文 + /// 必填：否 + /// 示例值：测试 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 英文 + /// 必填：否 + /// 示例值：test + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + } + + /// + /// 当字段类型为多选时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("option_list")] + public TalentCustomizedOption[]? OptionLists { get; set; } + + /// + /// 当字段类型为时间段时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("time_range")] + public TalentCustomizedTimeRange? TimeRange { get; set; } + + /// + /// 当字段类型为时间段时，从此字段取值 + /// + public record TalentCustomizedTimeRange + { + /// + /// 开始时间 + /// 必填：否 + /// 示例值：1625456721 + /// + [JsonPropertyName("start_time")] + public string? StartTime { get; set; } + + /// + /// 结束时间，当值为至今时，返回「-」 + /// 必填：否 + /// 示例值：1625656721 + /// + [JsonPropertyName("end_time")] + public string? EndTime { get; set; } + } + + /// + /// 当字段类型为日期选择、月份选择、年份选择时，从此字段取值，该字段是秒级时间戳 + /// 必填：否 + /// 示例值：1625456721 + /// + [JsonPropertyName("time")] + public string? Time { get; set; } + + /// + /// 当字段类型为数字时，从此字段取值 + /// 必填：否 + /// 示例值：111 + /// + [JsonPropertyName("number")] + public string? Number { get; set; } + + /// + /// 当字段类型为附件时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("customized_attachment")] + public TalentCustomizedAttachment[]? CustomizedAttachments { get; set; } + + /// + /// 当字段类型为附件时，从此字段取值 + /// + public record TalentCustomizedAttachment + { + /// + /// 附件 ID + /// 必填：否 + /// 示例值：7140517838785481004 + /// + [JsonPropertyName("file_id")] + public string? FileId { get; set; } + + /// + /// 附件名称 + /// 必填：否 + /// 示例值：1.13测试1的面试记录.pdf + /// + [JsonPropertyName("name")] + public string? Name { get; set; } + + /// + /// 附件类型 + /// 必填：否 + /// 示例值：application/pdf + /// + [JsonPropertyName("content_type")] + public string? ContentType { get; set; } + + /// + /// 附件大小 + /// 必填：否 + /// 示例值：16615 + /// + [JsonPropertyName("file_size")] + public int? FileSize { get; set; } + } + } + } } /// @@ -1001,27 +2166,260 @@ public record TalentLanguageInfo [JsonPropertyName("language")] public int? Language { get; set; } - /// - /// 精通程度 - /// 必填：否 - /// 示例值：1 - /// 可选值： - /// 1：入门 - /// 2：日常会话 - /// 3：商务会话 - /// 4：无障碍沟通 - /// 5：母语 - /// - /// - [JsonPropertyName("proficiency")] - public int? Proficiency { get; set; } + /// + /// 精通程度 + /// 必填：否 + /// 示例值：1 + /// 可选值： + /// 1：入门 + /// 2：日常会话 + /// 3：商务会话 + /// 4：无障碍沟通 + /// 5：母语 + /// + /// + [JsonPropertyName("proficiency")] + public int? Proficiency { get; set; } + + /// + /// 自定义字段 + /// 必填：否 + /// + [JsonPropertyName("customized_data_list")] + public TalentCustomizedDataChild[]? CustomizedDataLists { get; set; } + + /// + /// 自定义字段 + /// + public record TalentCustomizedDataChild + { + /// + /// 自定义字段 ID + /// 必填：否 + /// 示例值：xxxx + /// + [JsonPropertyName("object_id")] + public string? ObjectId { get; set; } + + /// + /// 字段名称 + /// 必填：否 + /// + [JsonPropertyName("name")] + public I18n? Name { get; set; } + + /// + /// 字段名称 + /// + public record I18n + { + /// + /// 中文 + /// 必填：否 + /// 示例值：测试 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 英文 + /// 必填：否 + /// 示例值：test + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 字段类型 + /// 必填：否 + /// 示例值：1 + /// 可选值： + /// 1：单行文本 + /// 2：多行文本 + /// 3：单选 + /// 4：多选 + /// 5：日期 + /// 6：月份选择 + /// 7：年份选择 + /// 8：时间段 + /// 9：数字 + /// 10：默认字段 + /// 11：模块 + /// 13：附件 + /// + /// + [JsonPropertyName("object_type")] + public int? ObjectType { get; set; } + + /// + /// 自定义字段值 + /// 必填：否 + /// + [JsonPropertyName("value")] + public TalentCustomizedValue? Value { get; set; } + + /// + /// 自定义字段值 + /// + public record TalentCustomizedValue + { + /// + /// 当字段类型为单行文本、多行文本、模块、默认字段时，从此字段取值 + /// 必填：否 + /// 示例值：text + /// + [JsonPropertyName("content")] + public string? Content { get; set; } + + /// + /// 当字段类型为单选时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("option")] + public TalentCustomizedOption? Option { get; set; } + + /// + /// 当字段类型为单选时，从此字段取值 + /// + public record TalentCustomizedOption + { + /// + /// 选项 ID + /// 必填：否 + /// 示例值：AA + /// + [JsonPropertyName("key")] + public string? Key { get; set; } + + /// + /// 选项名称 + /// 必填：否 + /// + [JsonPropertyName("name")] + public I18n? Name { get; set; } + + /// + /// 选项名称 + /// + public record I18n + { + /// + /// 中文 + /// 必填：否 + /// 示例值：测试 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 英文 + /// 必填：否 + /// 示例值：test + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + } + + /// + /// 当字段类型为多选时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("option_list")] + public TalentCustomizedOption[]? OptionLists { get; set; } + + /// + /// 当字段类型为时间段时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("time_range")] + public TalentCustomizedTimeRange? TimeRange { get; set; } + + /// + /// 当字段类型为时间段时，从此字段取值 + /// + public record TalentCustomizedTimeRange + { + /// + /// 开始时间 + /// 必填：否 + /// 示例值：1625456721 + /// + [JsonPropertyName("start_time")] + public string? StartTime { get; set; } + + /// + /// 结束时间，当值为至今时，返回「-」 + /// 必填：否 + /// 示例值：1625656721 + /// + [JsonPropertyName("end_time")] + public string? EndTime { get; set; } + } + + /// + /// 当字段类型为日期选择、月份选择、年份选择时，从此字段取值，该字段是秒级时间戳 + /// 必填：否 + /// 示例值：1625456721 + /// + [JsonPropertyName("time")] + public string? Time { get; set; } + + /// + /// 当字段类型为数字时，从此字段取值 + /// 必填：否 + /// 示例值：111 + /// + [JsonPropertyName("number")] + public string? Number { get; set; } + + /// + /// 当字段类型为附件时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("customized_attachment")] + public TalentCustomizedAttachment[]? CustomizedAttachments { get; set; } + + /// + /// 当字段类型为附件时，从此字段取值 + /// + public record TalentCustomizedAttachment + { + /// + /// 附件 ID + /// 必填：否 + /// 示例值：7140517838785481004 + /// + [JsonPropertyName("file_id")] + public string? FileId { get; set; } + + /// + /// 附件名称 + /// 必填：否 + /// 示例值：1.13测试1的面试记录.pdf + /// + [JsonPropertyName("name")] + public string? Name { get; set; } + + /// + /// 附件类型 + /// 必填：否 + /// 示例值：application/pdf + /// + [JsonPropertyName("content_type")] + public string? ContentType { get; set; } - /// - /// 自定义字段 - /// 必填：否 - /// - [JsonPropertyName("customized_data_list")] - public TalentCustomizedDataChild[]? CustomizedDataLists { get; set; } + /// + /// 附件大小 + /// 必填：否 + /// 示例值：16615 + /// + [JsonPropertyName("file_size")] + public int? FileSize { get; set; } + } + } + } } /// @@ -1079,6 +2477,239 @@ public record TalentSnsInfo /// [JsonPropertyName("customized_data_list")] public TalentCustomizedDataChild[]? CustomizedDataLists { get; set; } + + /// + /// 自定义字段 + /// + public record TalentCustomizedDataChild + { + /// + /// 自定义字段 ID + /// 必填：否 + /// 示例值：xxxx + /// + [JsonPropertyName("object_id")] + public string? ObjectId { get; set; } + + /// + /// 字段名称 + /// 必填：否 + /// + [JsonPropertyName("name")] + public I18n? Name { get; set; } + + /// + /// 字段名称 + /// + public record I18n + { + /// + /// 中文 + /// 必填：否 + /// 示例值：测试 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 英文 + /// 必填：否 + /// 示例值：test + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 字段类型 + /// 必填：否 + /// 示例值：1 + /// 可选值： + /// 1：单行文本 + /// 2：多行文本 + /// 3：单选 + /// 4：多选 + /// 5：日期 + /// 6：月份选择 + /// 7：年份选择 + /// 8：时间段 + /// 9：数字 + /// 10：默认字段 + /// 11：模块 + /// 13：附件 + /// + /// + [JsonPropertyName("object_type")] + public int? ObjectType { get; set; } + + /// + /// 自定义字段值 + /// 必填：否 + /// + [JsonPropertyName("value")] + public TalentCustomizedValue? Value { get; set; } + + /// + /// 自定义字段值 + /// + public record TalentCustomizedValue + { + /// + /// 当字段类型为单行文本、多行文本、模块、默认字段时，从此字段取值 + /// 必填：否 + /// 示例值：text + /// + [JsonPropertyName("content")] + public string? Content { get; set; } + + /// + /// 当字段类型为单选时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("option")] + public TalentCustomizedOption? Option { get; set; } + + /// + /// 当字段类型为单选时，从此字段取值 + /// + public record TalentCustomizedOption + { + /// + /// 选项 ID + /// 必填：否 + /// 示例值：AA + /// + [JsonPropertyName("key")] + public string? Key { get; set; } + + /// + /// 选项名称 + /// 必填：否 + /// + [JsonPropertyName("name")] + public I18n? Name { get; set; } + + /// + /// 选项名称 + /// + public record I18n + { + /// + /// 中文 + /// 必填：否 + /// 示例值：测试 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 英文 + /// 必填：否 + /// 示例值：test + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + } + + /// + /// 当字段类型为多选时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("option_list")] + public TalentCustomizedOption[]? OptionLists { get; set; } + + /// + /// 当字段类型为时间段时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("time_range")] + public TalentCustomizedTimeRange? TimeRange { get; set; } + + /// + /// 当字段类型为时间段时，从此字段取值 + /// + public record TalentCustomizedTimeRange + { + /// + /// 开始时间 + /// 必填：否 + /// 示例值：1625456721 + /// + [JsonPropertyName("start_time")] + public string? StartTime { get; set; } + + /// + /// 结束时间，当值为至今时，返回「-」 + /// 必填：否 + /// 示例值：1625656721 + /// + [JsonPropertyName("end_time")] + public string? EndTime { get; set; } + } + + /// + /// 当字段类型为日期选择、月份选择、年份选择时，从此字段取值，该字段是秒级时间戳 + /// 必填：否 + /// 示例值：1625456721 + /// + [JsonPropertyName("time")] + public string? Time { get; set; } + + /// + /// 当字段类型为数字时，从此字段取值 + /// 必填：否 + /// 示例值：111 + /// + [JsonPropertyName("number")] + public string? Number { get; set; } + + /// + /// 当字段类型为附件时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("customized_attachment")] + public TalentCustomizedAttachment[]? CustomizedAttachments { get; set; } + + /// + /// 当字段类型为附件时，从此字段取值 + /// + public record TalentCustomizedAttachment + { + /// + /// 附件 ID + /// 必填：否 + /// 示例值：7140517838785481004 + /// + [JsonPropertyName("file_id")] + public string? FileId { get; set; } + + /// + /// 附件名称 + /// 必填：否 + /// 示例值：1.13测试1的面试记录.pdf + /// + [JsonPropertyName("name")] + public string? Name { get; set; } + + /// + /// 附件类型 + /// 必填：否 + /// 示例值：application/pdf + /// + [JsonPropertyName("content_type")] + public string? ContentType { get; set; } + + /// + /// 附件大小 + /// 必填：否 + /// 示例值：16615 + /// + [JsonPropertyName("file_size")] + public int? FileSize { get; set; } + } + } + } } /// @@ -1290,6 +2921,239 @@ public record I18n /// [JsonPropertyName("children")] public TalentCustomizedDataChild[]? Childrens { get; set; } + + /// + /// 模块下的字段 + /// + public record TalentCustomizedDataChild + { + /// + /// 自定义字段 ID + /// 必填：否 + /// 示例值：xxxx + /// + [JsonPropertyName("object_id")] + public string? ObjectId { get; set; } + + /// + /// 字段名称 + /// 必填：否 + /// + [JsonPropertyName("name")] + public I18n? Name { get; set; } + + /// + /// 字段名称 + /// + public record I18n + { + /// + /// 中文 + /// 必填：否 + /// 示例值：测试 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 英文 + /// 必填：否 + /// 示例值：test + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 字段类型 + /// 必填：否 + /// 示例值：1 + /// 可选值： + /// 1：单行文本 + /// 2：多行文本 + /// 3：单选 + /// 4：多选 + /// 5：日期 + /// 6：月份选择 + /// 7：年份选择 + /// 8：时间段 + /// 9：数字 + /// 10：默认字段 + /// 11：模块 + /// 13：附件 + /// + /// + [JsonPropertyName("object_type")] + public int? ObjectType { get; set; } + + /// + /// 自定义字段值 + /// 必填：否 + /// + [JsonPropertyName("value")] + public TalentCustomizedValue? Value { get; set; } + + /// + /// 自定义字段值 + /// + public record TalentCustomizedValue + { + /// + /// 当字段类型为单行文本、多行文本、模块、默认字段时，从此字段取值 + /// 必填：否 + /// 示例值：text + /// + [JsonPropertyName("content")] + public string? Content { get; set; } + + /// + /// 当字段类型为单选时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("option")] + public TalentCustomizedOption? Option { get; set; } + + /// + /// 当字段类型为单选时，从此字段取值 + /// + public record TalentCustomizedOption + { + /// + /// 选项 ID + /// 必填：否 + /// 示例值：AA + /// + [JsonPropertyName("key")] + public string? Key { get; set; } + + /// + /// 选项名称 + /// 必填：否 + /// + [JsonPropertyName("name")] + public I18n? Name { get; set; } + + /// + /// 选项名称 + /// + public record I18n + { + /// + /// 中文 + /// 必填：否 + /// 示例值：测试 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 英文 + /// 必填：否 + /// 示例值：test + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + } + + /// + /// 当字段类型为多选时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("option_list")] + public TalentCustomizedOption[]? OptionLists { get; set; } + + /// + /// 当字段类型为时间段时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("time_range")] + public TalentCustomizedTimeRange? TimeRange { get; set; } + + /// + /// 当字段类型为时间段时，从此字段取值 + /// + public record TalentCustomizedTimeRange + { + /// + /// 开始时间 + /// 必填：否 + /// 示例值：1625456721 + /// + [JsonPropertyName("start_time")] + public string? StartTime { get; set; } + + /// + /// 结束时间，当值为至今时，返回「-」 + /// 必填：否 + /// 示例值：1625656721 + /// + [JsonPropertyName("end_time")] + public string? EndTime { get; set; } + } + + /// + /// 当字段类型为日期选择、月份选择、年份选择时，从此字段取值，该字段是秒级时间戳 + /// 必填：否 + /// 示例值：1625456721 + /// + [JsonPropertyName("time")] + public string? Time { get; set; } + + /// + /// 当字段类型为数字时，从此字段取值 + /// 必填：否 + /// 示例值：111 + /// + [JsonPropertyName("number")] + public string? Number { get; set; } + + /// + /// 当字段类型为附件时，从此字段取值 + /// 必填：否 + /// + [JsonPropertyName("customized_attachment")] + public TalentCustomizedAttachment[]? CustomizedAttachments { get; set; } + + /// + /// 当字段类型为附件时，从此字段取值 + /// + public record TalentCustomizedAttachment + { + /// + /// 附件 ID + /// 必填：否 + /// 示例值：7140517838785481004 + /// + [JsonPropertyName("file_id")] + public string? FileId { get; set; } + + /// + /// 附件名称 + /// 必填：否 + /// 示例值：1.13测试1的面试记录.pdf + /// + [JsonPropertyName("name")] + public string? Name { get; set; } + + /// + /// 附件类型 + /// 必填：否 + /// 示例值：application/pdf + /// + [JsonPropertyName("content_type")] + public string? ContentType { get; set; } + + /// + /// 附件大小 + /// 必填：否 + /// 示例值：16615 + /// + [JsonPropertyName("file_size")] + public int? FileSize { get; set; } + } + } + } } /// diff --git a/src/Hire/GetHireV1TalentsResponseDto.cs b/src/Hire/GetHireV1TalentsResponseDto.cs index ce614f30..4f39c0a5 100644 --- a/src/Hire/GetHireV1TalentsResponseDto.cs +++ b/src/Hire/GetHireV1TalentsResponseDto.cs @@ -4,7 +4,7 @@ // Created : 2024-06-26 // // Last Modified By : yxr -// Last Modified On : 2024-06-26 +// Last Modified On : 2024-07-24 // ************************************************************************ // // MIT @@ -281,7 +281,7 @@ public record TalentCityInfo /// 示例值：293016767159 /// [JsonPropertyName("birthday")] - public int? Birthday { get; set; } + public long? Birthday { get; set; } /// /// 创建人 diff --git a/src/Hire/GetHireV1WebsitesByWebsiteIdJobPostsByJobPostIdResponseDto.cs b/src/Hire/GetHireV1WebsitesByWebsiteIdJobPostsByJobPostIdResponseDto.cs index 6d5cdd8f..683981df 100644 --- a/src/Hire/GetHireV1WebsitesByWebsiteIdJobPostsByJobPostIdResponseDto.cs +++ b/src/Hire/GetHireV1WebsitesByWebsiteIdJobPostsByJobPostIdResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Hire; /// /// 获取招聘官网下职位广告详情 响应体 -/// 获取招聘官网下职位广告详情。 +/// 获取招聘官网下的职位广告详情，包含职位广告 ID、名称、关联职位 ID、关联职位编码等信息。 /// 接口ID：6990661791098650627 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/get-candidates/website/get /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2fwebsite-job_post%2fget @@ -36,15 +36,15 @@ public record WebsiteJobPost /// /// 职位广告 ID /// 必填：否 - /// 示例值：1213213123123 + /// 示例值：7392894182636144946 /// [JsonPropertyName("id")] public string? Id { get; set; } /// - /// 标题 + /// 职位广告标题 /// 必填：否 - /// 示例值：测试 + /// 示例值：高级工程师职位-官网广告 /// [JsonPropertyName("title")] public string? Title { get; set; } @@ -52,7 +52,7 @@ public record WebsiteJobPost /// /// 职位 ID /// 必填：否 - /// 示例值：xxx + /// 示例值：7392894182636030258 /// [JsonPropertyName("job_id")] public string? JobId { get; set; } @@ -60,15 +60,15 @@ public record WebsiteJobPost /// /// 职位编码 /// 必填：否 - /// 示例值：007 + /// 示例值：A168688 /// [JsonPropertyName("job_code")] public string? JobCode { get; set; } /// - /// 职位过期时间，「null」代表「长期有效」 + /// 职位过期时间，毫秒时间戳，「null」代表「长期有效」 /// 必填：否 - /// 示例值：1111 + /// 示例值：1701226882718 /// [JsonPropertyName("job_expire_time")] public string? JobExpireTime { get; set; } @@ -98,49 +98,49 @@ public record WebsiteJobPost public int? JobProcessType { get; set; } /// - /// 职位雇佣类型 + /// 职位雇佣类型，详情请参考：[枚举常量介绍](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/enum)中「职位性质/雇佣类型（recruitment_type）枚举定义」 /// 必填：否 /// [JsonPropertyName("job_recruitment_type")] public IdNameObject? JobRecruitmentType { get; set; } /// - /// 职位雇佣类型 + /// 职位雇佣类型，详情请参考：[枚举常量介绍](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/enum)中「职位性质/雇佣类型（recruitment_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 + /// 示例值：Full-time /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -155,7 +155,7 @@ public record I18n public IdNameObject? JobDepartment { get; set; } /// - /// 职位类型 + /// 职位类型，详情请参考：[获取职位类别列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_type/list) /// 必填：否 /// [JsonPropertyName("job_type")] @@ -176,19 +176,19 @@ public record I18n public IdNameObject? MaxJobLevel { get; set; } /// - /// 职位地址 + /// 职位地址列表，详情请参考：[获取地址列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/list) /// 必填：否 /// [JsonPropertyName("address")] public CommonAddress? Address { get; set; } /// - /// 职位地址 + /// 职位地址列表，详情请参考：[获取地址列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/list) /// public record CommonAddress { /// - /// ID + /// 职位地址 ID /// 必填：否 /// 示例值：6583482347283472832 /// @@ -196,78 +196,78 @@ 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 + /// 示例值：Anqing /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } } /// - /// 区域信息 + /// 区信息 /// 必填：否 /// [JsonPropertyName("district")] public CodeNameObject? District { get; set; } /// - /// 区域信息 + /// 区信息 /// public record CodeNameObject { /// - /// 编码 + /// 区编码 /// 必填：否 - /// 示例值：1111 + /// 示例值：MDCA00009061 /// [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; } @@ -297,17 +297,17 @@ public record I18n } /// - /// 月薪范围-最低薪资 + /// 月薪范围-最低薪资，单位：千 /// 必填：否 - /// 示例值：5000 + /// 示例值：5 /// [JsonPropertyName("min_salary")] public string? MinSalary { get; set; } /// - /// 月薪范围-最高薪资 + /// 月薪范围-最高薪资，单位：千 /// 必填：否 - /// 示例值：10000 + /// 示例值：10 /// [JsonPropertyName("max_salary")] public string? MaxSalary { get; set; } @@ -358,7 +358,7 @@ public record I18n public int? Headcount { get; set; } /// - /// 职位亮点 + /// 职位亮点，详情请参考：[枚举常量介绍](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/enum)中「职位亮枚举定义」 /// 必填：否 /// [JsonPropertyName("high_light_list")] @@ -388,17 +388,17 @@ public record I18n public IdNameObject? Creator { get; set; } /// - /// 创建时间 + /// 创建时间，毫秒级时间戳 /// 必填：否 - /// 示例值：1111 + /// 示例值：1715867075246 /// [JsonPropertyName("create_time")] public string? CreateTime { get; set; } /// - /// 修改时间 + /// 修改时间，毫秒级时间戳 /// 必填：否 - /// 示例值：222 + /// 示例值：1715867075246 /// [JsonPropertyName("modify_time")] public string? ModifyTime { get; set; } @@ -416,9 +416,9 @@ public record I18n public record WebsiteJobPostCustomizedData { /// - /// 自定义字段 ID + /// 自定义字段 ID，详情请参考：[获取职位模板](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_schema/list) /// 必填：否 - /// 示例值：xxxx + /// 示例值：6949805467799537964 /// [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 + /// 示例值：collectivize /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -525,17 +525,17 @@ public record WebsiteJobPostCustomizedOption public record I18n { /// - /// 中文 + /// 选项中文名称 /// 必填：否 - /// 示例值：测试 + /// 示例值：单行文本 /// [JsonPropertyName("zh_cn")] public string? ZhCn { get; set; } /// - /// 英文 + /// 选项英文名称 /// 必填：否 - /// 示例值：test + /// 示例值：single line of text /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -562,7 +562,7 @@ public record I18n public record WebsiteJobPostCustomizedTimeRange { /// - /// 开始时间 + /// 开始时间，毫秒级时间戳 /// 必填：否 /// 示例值：AA /// @@ -570,7 +570,7 @@ public record WebsiteJobPostCustomizedTimeRange public string? StartTime { get; set; } /// - /// 结束时间 + /// 结束时间，毫秒级时间戳 /// 必填：否 /// 示例值：AA /// @@ -597,21 +597,21 @@ public record WebsiteJobPostCustomizedTimeRange } /// - /// 职能分类 + /// 职能分类，详情请参考：[获取职能分类列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_function/list) /// 必填：否 /// [JsonPropertyName("job_function")] public IdNameObject? JobFunction { get; set; } /// - /// 职位项目 + /// 职位项目，详情请参考：[获取项目列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/subject/list) /// 必填：否 /// [JsonPropertyName("subject")] public IdNameObject? Subject { get; set; } /// - /// 职位广告地址列表 + /// 职位地址列表，详情请参考：[获取地址列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/list) /// 必填：否 /// [JsonPropertyName("address_list")] diff --git a/src/Hire/GetHireV2TalentsByTalentIdResponseDto.cs b/src/Hire/GetHireV2TalentsByTalentIdResponseDto.cs index f3546564..8795e4d9 100644 --- a/src/Hire/GetHireV2TalentsByTalentIdResponseDto.cs +++ b/src/Hire/GetHireV2TalentsByTalentIdResponseDto.cs @@ -4,7 +4,7 @@ // Created : 2024-07-22 // // Last Modified By : yxr -// Last Modified On : 2024-07-22 +// Last Modified On : 2024-07-24 // ************************************************************************ // // MIT @@ -172,7 +172,7 @@ public record CompositeTalentBasicInfo /// 示例值：293016767159 /// [JsonPropertyName("birthday")] - public int? Birthday { get; set; } + public long? Birthday { get; set; } /// /// 婚姻状况 diff --git a/src/Hire/PostHireV1ReferralAccountByReferralAccountIdWithdrawBodyDto.cs b/src/Hire/PostHireV1ReferralAccountByReferralAccountIdWithdrawBodyDto.cs index d6062998..ba2493b7 100644 --- a/src/Hire/PostHireV1ReferralAccountByReferralAccountIdWithdrawBodyDto.cs +++ b/src/Hire/PostHireV1ReferralAccountByReferralAccountIdWithdrawBodyDto.cs @@ -9,12 +9,12 @@ // // MIT // -// 全额提取内推账号余额 请求体 +// 全额提取内推账户余额 请求体 // ************************************************************************ namespace FeishuNetSdk.Hire; /// -/// 全额提取内推账号余额 请求体 -/// 支持通过账号 ID 全额提取内推账号下的积分或现金奖励。调用前，请确认已完成[「注册外部系统内推账户」](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/referral_account/create)并获取到账号 ID。提现后，内推人的对应积分或现金余额将变为 0，扣减后对应奖励将在招聘系统同步标记为「已发放」 +/// 全额提取内推账户余额 请求体 +/// 通过账号 ID 全额提取内推账号下的积分。全额提现后，内推人在飞书招聘系统中的积分余额会变为 0，对应的积分奖励状态也会变为「已发放」。 /// 接口ID：7252281835550883842 /// 文档地址：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/referral_account/withdraw /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2freferral_account%2fwithdraw @@ -22,14 +22,14 @@ namespace FeishuNetSdk.Hire; public record PostHireV1ReferralAccountByReferralAccountIdWithdrawBodyDto { /// - /// 请求提现的奖励类型 + /// 提取的奖励类型，当前仅支持积分（1）提取 /// 必填：否 /// [JsonPropertyName("withdraw_bonus_type")] public int[]? WithdrawBonusType { get; set; } /// - /// 提现单ID，请求时由请求方提供，后续关于本次提现操作的交互都以此提现单ID为标识进行，需要保证唯一,用于保证提现的幂等性，传入重复ID会返回对应提现单提取的金额明细 + /// 外部提取单 ID，由请求方提供，用于保证接口的幂等性，需要保证唯一。传入重复 ID 会返回原 ID 对应的提取详情 /// 必填：否 /// 示例值：6942778198054125570 /// diff --git a/src/Hire/PostHireV1ReferralAccountByReferralAccountIdWithdrawResponseDto.cs b/src/Hire/PostHireV1ReferralAccountByReferralAccountIdWithdrawResponseDto.cs index 5c3ab5f8..4ef04a8d 100644 --- a/src/Hire/PostHireV1ReferralAccountByReferralAccountIdWithdrawResponseDto.cs +++ b/src/Hire/PostHireV1ReferralAccountByReferralAccountIdWithdrawResponseDto.cs @@ -9,12 +9,12 @@ // // MIT // -// 全额提取内推账号余额 响应体 +// 全额提取内推账户余额 响应体 // ************************************************************************ namespace FeishuNetSdk.Hire; /// -/// 全额提取内推账号余额 响应体 -/// 支持通过账号 ID 全额提取内推账号下的积分或现金奖励。调用前，请确认已完成[「注册外部系统内推账户」](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/referral_account/create)并获取到账号 ID。提现后，内推人的对应积分或现金余额将变为 0，扣减后对应奖励将在招聘系统同步标记为「已发放」 +/// 全额提取内推账户余额 响应体 +/// 通过账号 ID 全额提取内推账号下的积分。全额提现后，内推人在飞书招聘系统中的积分余额会变为 0，对应的积分奖励状态也会变为「已发放」。 /// 接口ID：7252281835550883842 /// 文档地址：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/referral_account/withdraw /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2freferral_account%2fwithdraw @@ -22,7 +22,7 @@ namespace FeishuNetSdk.Hire; public record PostHireV1ReferralAccountByReferralAccountIdWithdrawResponseDto { /// - /// 请求时传入的提现单ID + /// 提取单 ID /// 必填：否 /// 示例值：6942778198054125570 /// @@ -30,7 +30,7 @@ public record PostHireV1ReferralAccountByReferralAccountIdWithdrawResponseDto public string? ExternalOrderId { get; set; } /// - /// 交易时间戳，需要保存，用于统一交易时间，方便对账 + /// 交易时间，毫秒时间戳 /// 必填：否 /// 示例值：1683634459543 /// @@ -38,19 +38,19 @@ public record PostHireV1ReferralAccountByReferralAccountIdWithdrawResponseDto public string? TransTime { get; set; } /// - /// 本次提现金额明细 + /// 提取详情 /// 必填：否 /// [JsonPropertyName("withdrawal_details")] public BonusAmount? WithdrawalDetails { get; set; } /// - /// 本次提现金额明细 + /// 提取详情 /// public record BonusAmount { /// - /// 积分奖励 + /// 提取的积分数量 /// 必填：否 /// 示例值：100 /// diff --git a/src/Hire/PostHireV1ReferralAccountReconciliationBodyDto.cs b/src/Hire/PostHireV1ReferralAccountReconciliationBodyDto.cs index 6a1aefa0..49292f6a 100644 --- a/src/Hire/PostHireV1ReferralAccountReconciliationBodyDto.cs +++ b/src/Hire/PostHireV1ReferralAccountReconciliationBodyDto.cs @@ -9,12 +9,12 @@ // // MIT // -// 内推账号提现对账接口 请求体 +// 内推账户提现数据对账 请求体 // ************************************************************************ namespace FeishuNetSdk.Hire; /// -/// 内推账号提现对账接口 请求体 -/// 定时将时间段内的账户充值信息同步到招聘，与招聘实际提取金额做对比，保证系统异常或其他意外情况发生时，双方系统可及时监控到充值异常等错误 +/// 内推账户提现数据对账 请求体 +/// 对一段时间内的内推账户积分提现数据进行对账，调用方需传入调用方系统的内推账户积分变动信息。 /// 接口ID：7252281835550900226 /// 文档地址：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/referral_account/reconciliation /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2freferral_account%2freconciliation @@ -22,7 +22,7 @@ namespace FeishuNetSdk.Hire; public record PostHireV1ReferralAccountReconciliationBodyDto { /// - /// 按时间范围进行对账时 时间段的起始交易时间 + /// 对账时段的起始交易时间，毫秒时间戳 /// 必填：否 /// 示例值：1685416831621 /// @@ -30,7 +30,7 @@ public record PostHireV1ReferralAccountReconciliationBodyDto public string? StartTransTime { get; set; } /// - /// 按时间范围进行对账时 时间段的截止交易时间 + /// 对账时段的截止交易时间，毫秒时间戳 /// 必填：否 /// 示例值：1685416831622 /// @@ -38,19 +38,19 @@ public record PostHireV1ReferralAccountReconciliationBodyDto public string? EndTransTime { get; set; } /// - /// 交易信息 + /// 账户积分变动信息 /// 必填：否 /// [JsonPropertyName("trade_details")] public TradeDetail[]? TradeDetails { get; set; } /// - /// 交易信息 + /// 账户积分变动信息 /// public record TradeDetail { /// - /// 账户ID + /// 内推账户ID，通过[注册内推账户](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/referral_account/create)生成 /// 必填：是 /// 示例值：6930815272790114324 /// @@ -58,19 +58,19 @@ public record TradeDetail public string AccountId { get; set; } = string.Empty; /// - /// 时间段内该账户在积分商城的实际充值金额 + /// 时段内该账户发生在调用方系统的积分之和 /// 必填：否 /// [JsonPropertyName("total_recharge_reward_info")] public BonusAmount? TotalRechargeRewardInfo { get; set; } /// - /// 时间段内该账户在积分商城的实际充值金额 + /// 时段内该账户发生在调用方系统的积分之和 /// public record BonusAmount { /// - /// 积分奖励 + /// 变动的积分数量 /// 必填：否 /// 示例值：100 /// diff --git a/src/Hire/PostHireV1ReferralAccountReconciliationResponseDto.cs b/src/Hire/PostHireV1ReferralAccountReconciliationResponseDto.cs index a4664a1c..19e445e6 100644 --- a/src/Hire/PostHireV1ReferralAccountReconciliationResponseDto.cs +++ b/src/Hire/PostHireV1ReferralAccountReconciliationResponseDto.cs @@ -9,12 +9,12 @@ // // MIT // -// 内推账号提现对账接口 响应体 +// 内推账户提现数据对账 响应体 // ************************************************************************ namespace FeishuNetSdk.Hire; /// -/// 内推账号提现对账接口 响应体 -/// 定时将时间段内的账户充值信息同步到招聘，与招聘实际提取金额做对比，保证系统异常或其他意外情况发生时，双方系统可及时监控到充值异常等错误 +/// 内推账户提现数据对账 响应体 +/// 对一段时间内的内推账户积分提现数据进行对账，调用方需传入调用方系统的内推账户积分变动信息。 /// 接口ID：7252281835550900226 /// 文档地址：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/referral_account/reconciliation /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fuMzM1YjLzMTN24yMzUjN%2fhire-v1%2freferral_account%2freconciliation @@ -34,7 +34,7 @@ public record PostHireV1ReferralAccountReconciliationResponseDto public record CheckFailedAccountInfo { /// - /// 账户ID + /// 内推账户ID /// 必填：否 /// 示例值：6930815272790114324 /// @@ -42,19 +42,19 @@ public record CheckFailedAccountInfo public string? AccountId { get; set; } /// - /// 招聘系统内的提取金额 + /// 飞书招聘系统内的账户积分提取数量 /// 必填：否 /// [JsonPropertyName("total_withdraw_reward_info")] public BonusAmount? TotalWithdrawRewardInfo { get; set; } /// - /// 招聘系统内的提取金额 + /// 飞书招聘系统内的账户积分提取数量 /// public record BonusAmount { /// - /// 积分奖励 + /// 积分数量 /// 必填：否 /// 示例值：100 /// @@ -63,7 +63,7 @@ public record BonusAmount } /// - /// 商城实际充值金额 + /// 调用方系统的积分变动数量 /// 必填：否 /// [JsonPropertyName("total_recharge_reward_info")] diff --git a/src/Hire/PostHireV1TalentsCombinedCreateBodyDto.cs b/src/Hire/PostHireV1TalentsCombinedCreateBodyDto.cs index 922e26c4..6d01e08a 100644 --- a/src/Hire/PostHireV1TalentsCombinedCreateBodyDto.cs +++ b/src/Hire/PostHireV1TalentsCombinedCreateBodyDto.cs @@ -105,7 +105,7 @@ public record TalentCombinedBasicInfo public string? Mobile { get; set; } /// - /// 手机国家代码，通过[「查询地点列表」](https://open.larkoffice.com/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query)接口获得 + /// 手机国家代码，可通过[查询地点列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query)接口获取 /// 必填：否 /// 示例值：CN_1 /// @@ -159,7 +159,7 @@ public record TalentIdentificationInfo } /// - /// 开始工作时间戳（单位：毫秒） + /// 开始工作时间，毫秒时间戳 /// 必填：否 /// 示例值：1686832459000 /// @@ -167,7 +167,7 @@ public record TalentIdentificationInfo public string? StartWorkTime { get; set; } /// - /// 出生日期时间戳（单位：毫秒） + /// 出生日期时间，毫秒时间戳 /// 必填：否 /// 示例值：1293016767159 /// @@ -188,7 +188,7 @@ public record TalentIdentificationInfo public int? Gender { get; set; } /// - /// 国籍编码，通过[「查询地点列表」](https://open.larkoffice.com/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query)接口获得 + /// 国籍编码，可通过[查询地点列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query)获取 /// 必填：否 /// 示例值：CN_112 /// @@ -196,7 +196,7 @@ public record TalentIdentificationInfo public string? NationalityId { get; set; } /// - /// 所在地点编码，通过[「查询地点列表」](https://open.larkoffice.com/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query)接口获得 + /// 所在地点编码，可通过[查询地点列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query)获取 /// 必填：否 /// 示例值：CT_159 /// @@ -204,7 +204,7 @@ public record TalentIdentificationInfo public string? CurrentCityCode { get; set; } /// - /// 家乡编码，通过[「查询地点列表」](https://open.larkoffice.com/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query)接口获得 + /// 家乡编码，可通过[查询地点列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query)获取 /// 必填：否 /// 示例值：CT_159 /// @@ -286,7 +286,7 @@ public record TalentCombinedEducationInfo public string? Id { get; set; } /// - /// 教育经历学历 + /// 学历 /// 必填：否 /// 示例值：1 /// 可选值： @@ -321,7 +321,7 @@ public record TalentCombinedEducationInfo public string? FieldOfStudy { get; set; } /// - /// 教育经历开始时间戳（单位：毫秒） + /// 教育经历开始时间，毫秒时间戳 /// 必填：否 /// 示例值：1655644087000 /// @@ -329,7 +329,7 @@ public record TalentCombinedEducationInfo public string? StartTime { get; set; } /// - /// 教育经历结束时间戳（单位：毫秒） + /// 教育经历结束时间，毫秒时间戳 /// 必填：否 /// 示例值：1687180087000 /// @@ -466,7 +466,7 @@ public record TalentCombinedCareerInfo public string? Desc { get; set; } /// - /// 工作经历开始时间戳（单位：毫秒） + /// 工作经历开始时间，毫秒时间戳 /// 必填：否 /// 示例值：1655644087000 /// @@ -474,7 +474,7 @@ public record TalentCombinedCareerInfo public string? StartTime { get; set; } /// - /// 工作经历结束时间戳（单位：毫秒） + /// 工作经历结束时间，毫秒时间戳 /// 必填：否 /// 示例值：1687180087000 /// @@ -600,7 +600,7 @@ public record TalentCombinedProjectInfo public string? Desc { get; set; } /// - /// 项目开始时间戳（单位：毫秒） + /// 项目开始时间，毫秒时间戳 /// 必填：否 /// 示例值：1655644087000 /// @@ -608,7 +608,7 @@ public record TalentCombinedProjectInfo public string? StartTime { get; set; } /// - /// 项目结束时间戳（单位：毫秒） + /// 项目结束时间，毫秒时间戳 /// 必填：否 /// 示例值：1687180087000 /// @@ -796,7 +796,7 @@ public record TalentCombinedAwardInfo public string? Title { get; set; } /// - /// 获奖时间戳（单位：毫秒） + /// 获奖时间，毫秒时间戳 /// 必填：否 /// 示例值：1687180087000 /// diff --git a/src/Hire/PostHireV1WebsitesByWebsiteIdDeliveriesCreateByResumeBodyDto.cs b/src/Hire/PostHireV1WebsitesByWebsiteIdDeliveriesCreateByResumeBodyDto.cs index 378c0992..1f306626 100644 --- a/src/Hire/PostHireV1WebsitesByWebsiteIdDeliveriesCreateByResumeBodyDto.cs +++ b/src/Hire/PostHireV1WebsitesByWebsiteIdDeliveriesCreateByResumeBodyDto.cs @@ -4,7 +4,7 @@ // Created : 2024-07-22 // // Last Modified By : yxr -// Last Modified On : 2024-07-22 +// Last Modified On : 2024-07-24 // ************************************************************************ // // MIT @@ -22,7 +22,7 @@ namespace FeishuNetSdk.Hire; public record PostHireV1WebsitesByWebsiteIdDeliveriesCreateByResumeBodyDto { /// - /// 职位广告 ID + /// 职位广告 ID，可通过[搜索招聘官网下的职位广告列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/website-job_post/search)或者[获取招聘官网下的职位广告列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/website-job_post/list)获取 /// 必填：是 /// 示例值：6960663240925956636 /// @@ -54,15 +54,15 @@ public record WebsiteDeliveryResume public record WebsiteDeliveryInternship { /// - /// 描述 + /// 实习经历描述 /// 必填：否 - /// 示例值：这是一家创业公司，非常不错 + /// 示例值：在抖音工作实习3个月，表现优秀 /// [JsonPropertyName("desc")] public string? Desc { get; set; } /// - /// 结束时间, 如果是至今传值 -1 + /// 结束时间，毫秒时间戳，如果是「至今」可传值 -1 /// 必填：否 /// 示例值：1618500278667 /// @@ -70,7 +70,7 @@ public record WebsiteDeliveryInternship public long? EndTime { get; set; } /// - /// 开始时间 + /// 开始时间，毫秒时间戳 /// 必填：否 /// 示例值：1609430400000 /// @@ -86,9 +86,9 @@ public record WebsiteDeliveryInternship public string? Title { get; set; } /// - /// 公司 + /// 公司名称 /// 必填：否 - /// 示例值：字节跳动 + /// 示例值：抖音公司 /// [JsonPropertyName("company")] public string? Company { get; set; } @@ -106,7 +106,7 @@ public record WebsiteDeliveryInternship public record WebsiteDeliveryCustomizedData { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query)获取 /// 必填：否 /// 示例值：6960663240925956649 /// @@ -114,7 +114,7 @@ public record WebsiteDeliveryCustomizedData public string? ObjectId { get; set; } /// - /// 自定义字段 value，格式见接口说明 + /// 自定义字段值，请参考本文「自定义字段数据格式说明」 /// 必填：否 /// 示例值：AA /// @@ -136,20 +136,20 @@ public record WebsiteDeliveryCustomizedData public record WebsiteDeliveryBasicInfo { /// - /// 国籍，可从「获取地址码」查询 + /// 国家码，可通过[查询地点列表](https://open.larkoffice.com/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query)获取 /// 必填：否 - /// 示例值：CN_112 + /// 示例值：CN_1 /// [JsonPropertyName("nationality_id")] public string? NationalityId { get; set; } /// - /// 起始工作时间 + /// 起始工作时间，毫秒时间戳 /// 必填：否 - /// 示例值：1625648596 + /// 示例值：1609430400000 /// [JsonPropertyName("start_work_time")] - public int? StartWorkTime { get; set; } + public long? StartWorkTime { get; set; } /// /// 家庭住址 @@ -160,7 +160,7 @@ public record WebsiteDeliveryBasicInfo public string? CurrentHomeAddress { get; set; } /// - /// 家乡，可从「获取地址码」查询 + /// 家乡，可通过[查询地点列表](https://open.larkoffice.com/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query)获取 /// 必填：否 /// 示例值：CT_159 /// @@ -168,7 +168,7 @@ public record WebsiteDeliveryBasicInfo public string? HometownCityCode { get; set; } /// - /// 电话国际区号，可从「获取地址码」查询 + /// 手机国家代码，可通过[查询地点列表](https://open.larkoffice.com/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query)获取 /// 必填：否 /// 示例值：CN_1 /// @@ -234,7 +234,7 @@ public record WebsiteDeliveryIdentification public string? Mobile { get; set; } /// - /// 所在城市，可从「获取地址码」查询 + /// 所在城市，可通过[查询地点列表](https://open.larkoffice.com/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query)获取 /// 必填：否 /// 示例值：CT_11 /// @@ -254,21 +254,21 @@ public record WebsiteDeliveryIdentification /// 必填：否 /// 示例值：1 /// 可选值： - /// 1：Male - /// 2：Female - /// 3：Other + /// 1：男 + /// 2：女 + /// 3：其他 /// /// [JsonPropertyName("gender")] public int? Gender { get; set; } /// - /// 出生日期 + /// 出生日期，毫秒时间戳 /// 必填：否 /// 示例值：1609430400000 /// [JsonPropertyName("birthday")] - public int? Birthday { get; set; } + public long? Birthday { get; set; } /// /// 姓名 @@ -279,7 +279,7 @@ public record WebsiteDeliveryIdentification public string Name { get; set; } = string.Empty; /// - /// 意向城市，可从「获取地址码」查询 + /// 意向城市列表，可通过[查询地点列表](https://open.larkoffice.com/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query)获取 /// 必填：否 /// 示例值：意向城市 /// @@ -287,7 +287,7 @@ public record WebsiteDeliveryIdentification public string[]? PreferredCityCodeList { get; set; } /// - /// 简历来源，可从「获取简历来源列表」查询 + /// 简历来源，可通过[获取简历来源列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/resume_source/list)获取 /// 必填：否 /// 示例值：6982104077248219436 /// @@ -315,7 +315,7 @@ public record WebsiteDeliveryIdentification public record WebsiteDeliveryCustomizedData { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query)获取 /// 必填：否 /// 示例值：6960663240925956649 /// @@ -323,7 +323,7 @@ public record WebsiteDeliveryCustomizedData public string? ObjectId { get; set; } /// - /// 自定义字段 value，格式见接口说明 + /// 自定义字段值，请参考本文「自定义字段数据格式说明」。 /// 必填：否 /// 示例值：AA /// @@ -368,8 +368,8 @@ public record WebsiteDeliveryEducation public int? EducationType { get; set; } /// - /// 结束时间 ,如果是至今传值 -1 - /// 传输「至今」，投递进入系统后可正常查看字段，但进入编辑态后需要修改为一个具体时间 + /// 结束时间 ，毫秒时间戳，如果是「至今」可传值 -1。请注意：若传值-1 + /// 投递创建成功后在系统中可正常查看，但若编辑则需要填一个具体时间 /// 必填：否 /// 示例值：1618500278663 /// @@ -377,13 +377,13 @@ public record WebsiteDeliveryEducation public long? EndTime { get; set; } /// - /// 结束时间-新，无「至今」传值。 + /// 结束时间（新），毫秒时间戳，无「至今」传值。 /// 建议使用此字段，避免模糊的毕业时间影响候选人筛选 /// 必填：否 /// 示例值：1618500278663 /// [JsonPropertyName("end_time_v2")] - public int? EndTimeV2 { get; set; } + public long? EndTimeV2 { get; set; } /// /// 专业 @@ -402,7 +402,7 @@ public record WebsiteDeliveryEducation public string? School { get; set; } /// - /// 开始时间 + /// 开始时间，毫秒时间戳 /// 必填：否 /// 示例值：1609430400000 /// @@ -438,7 +438,7 @@ public record WebsiteDeliveryEducation public record WebsiteDeliveryCustomizedData { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query)获取 /// 必填：否 /// 示例值：6960663240925956649 /// @@ -446,7 +446,7 @@ public record WebsiteDeliveryCustomizedData public string? ObjectId { get; set; } /// - /// 自定义字段 value，格式见接口说明 + /// 自定义字段值，请参考本文「自定义字段数据格式说明」 /// 必填：否 /// 示例值：AA /// @@ -487,7 +487,7 @@ public record WebsiteDeliveryCustomizedData public record WebsiteDeliverySelfEvaluation { /// - /// 内容 + /// 评价内容 /// 必填：否 /// 示例值：自我评价：平常心 /// @@ -507,7 +507,7 @@ public record WebsiteDeliverySelfEvaluation public record WebsiteDeliveryCustomizedData { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query)获取 /// 必填：否 /// 示例值：6960663240925956649 /// @@ -515,7 +515,7 @@ public record WebsiteDeliveryCustomizedData public string? ObjectId { get; set; } /// - /// 自定义字段 value，格式见接口说明 + /// 自定义字段值，请参考本文「自定义字段数据格式说明」 /// 必填：否 /// 示例值：AA /// @@ -537,15 +537,15 @@ public record WebsiteDeliveryCustomizedData public record WebsiteDeliveryCareer { /// - /// 描述 + /// 工作经历描述 /// 必填：否 - /// 示例值：这是一家创业公司，非常不错 + /// 示例值：在抖音公司工作了5年，表现优秀 /// [JsonPropertyName("desc")] public string? Desc { get; set; } /// - /// 结束时间, 如果是至今传值 -1 + /// 结束时间, 毫秒时间戳，如果是「至今」可传值 -1 /// 必填：否 /// 示例值：1618500278667 /// @@ -553,7 +553,7 @@ public record WebsiteDeliveryCareer public long? EndTime { get; set; } /// - /// 开始时间 + /// 开始时间，毫秒时间戳 /// 必填：否 /// 示例值：1609430400000 /// @@ -563,7 +563,7 @@ public record WebsiteDeliveryCareer /// /// 职位名称 /// 必填：否 - /// 示例值：后端研发实习生 + /// 示例值：后端研发工程师 /// [JsonPropertyName("title")] public string? Title { get; set; } @@ -571,7 +571,7 @@ public record WebsiteDeliveryCareer /// /// 公司 /// 必填：否 - /// 示例值：字节跳动 + /// 示例值：抖音公司 /// [JsonPropertyName("company")] public string? Company { get; set; } @@ -589,7 +589,7 @@ public record WebsiteDeliveryCareer public record WebsiteDeliveryCustomizedData { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query)获取 /// 必填：否 /// 示例值：6960663240925956649 /// @@ -597,7 +597,7 @@ public record WebsiteDeliveryCustomizedData public string? ObjectId { get; set; } /// - /// 自定义字段 value，格式见接口说明 + /// 自定义字段值，请参考本文「自定义字段数据格式说明」 /// 必填：否 /// 示例值：AA /// @@ -619,7 +619,7 @@ public record WebsiteDeliveryCustomizedData public record WebsiteDeliveryCustomizedDataParent { /// - /// 自定义字段 ID + /// 自定义模块ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query)获取 /// 必填：否 /// 示例值：6960663240925956651 /// @@ -627,19 +627,19 @@ public record WebsiteDeliveryCustomizedDataParent public string? ObjectId { get; set; } /// - /// 模块下的字段 + /// 字段列表 /// 必填：否 /// [JsonPropertyName("children")] public WebsiteDeliveryCustomizedData[]? Childrens { get; set; } /// - /// 模块下的字段 + /// 字段列表 /// public record WebsiteDeliveryCustomizedData { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query)获取 /// 必填：否 /// 示例值：6960663240925956649 /// @@ -647,7 +647,7 @@ public record WebsiteDeliveryCustomizedData public string? ObjectId { get; set; } /// - /// 自定义字段 value，格式见接口说明 + /// 自定义字段值，请参考本文「自定义字段数据格式说明」 /// 必填：否 /// 示例值：AA /// @@ -657,7 +657,7 @@ public record WebsiteDeliveryCustomizedData } /// - /// 简历附件ID，使用「创建附件」生成 + /// 简历附件ID，需通过[创建附件](https://open.feishu.cn/document/ukTMukTMukTM/uIDN1YjLyQTN24iM0UjN/create_attachment)生成 /// 必填：否 /// 示例值：6960663240925956654 /// @@ -710,7 +710,7 @@ public record WebsiteDeliverySns public record WebsiteDeliveryCustomizedData { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query)获取 /// 必填：否 /// 示例值：6960663240925956649 /// @@ -718,7 +718,7 @@ public record WebsiteDeliveryCustomizedData public string? ObjectId { get; set; } /// - /// 自定义字段 value，格式见接口说明 + /// 自定义字段值，请参考本文「自定义字段数据格式说明」 /// 必填：否 /// 示例值：AA /// @@ -727,9 +727,9 @@ public record WebsiteDeliveryCustomizedData } /// - /// 链接 + /// 社交账号链接 /// 必填：否 - /// 示例值：toutiao.com + /// 示例值：www.toutiao.com /// [JsonPropertyName("link")] public string? Link { get; set; } @@ -750,7 +750,7 @@ public record WebsiteDeliveryWorks /// /// 作品描述 /// 必填：否 - /// 示例值：作品描述：xxxx + /// 示例值：作品描述：研究生阶段发表了顶刊论文 /// [JsonPropertyName("desc")] public string? Desc { get; set; } @@ -776,7 +776,7 @@ public record WebsiteDeliveryWorks public record WebsiteDeliveryWorksAttachment { /// - /// 文件ID，使用「创建附件」生成 + /// 文件ID，需通过[创建附件](https://open.feishu.cn/document/ukTMukTMukTM/uIDN1YjLyQTN24iM0UjN/create_attachment)生成 /// 必填：否 /// 示例值：6982104077248219436 /// @@ -797,7 +797,7 @@ public record WebsiteDeliveryWorksAttachment public record WebsiteDeliveryCustomizedData { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query)获取 /// 必填：否 /// 示例值：6960663240925956649 /// @@ -805,7 +805,7 @@ public record WebsiteDeliveryCustomizedData public string? ObjectId { get; set; } /// - /// 自定义字段 value，格式见接口说明 + /// 自定义字段值，请参考本文「自定义字段数据格式说明」 /// 必填：否 /// 示例值：AA /// @@ -839,7 +839,7 @@ public record WebsiteDeliveryAward public record WebsiteDeliveryCustomizedData { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query)获取 /// 必填：否 /// 示例值：6960663240925956649 /// @@ -847,7 +847,7 @@ public record WebsiteDeliveryCustomizedData public string? ObjectId { get; set; } /// - /// 自定义字段 value，格式见接口说明 + /// 自定义字段值，请参考本文「自定义字段数据格式说明」 /// 必填：否 /// 示例值：AA /// @@ -856,7 +856,7 @@ public record WebsiteDeliveryCustomizedData } /// - /// 描述 + /// 获奖描述 /// 必填：否 /// 示例值：ACM国际大学生程序设计竞赛 /// @@ -872,12 +872,12 @@ public record WebsiteDeliveryCustomizedData public string? Title { get; set; } /// - /// 获奖时间 + /// 获奖时间，毫秒时间戳 /// 必填：否 /// 示例值：1609430400000 /// [JsonPropertyName("award_time")] - public int? AwardTime { get; set; } + public long? AwardTime { get; set; } } /// @@ -905,7 +905,7 @@ public record WebsiteDeliveryProject public record WebsiteDeliveryCustomizedData { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query)获取 /// 必填：否 /// 示例值：6960663240925956649 /// @@ -913,7 +913,7 @@ public record WebsiteDeliveryCustomizedData public string? ObjectId { get; set; } /// - /// 自定义字段 value，格式见接口说明 + /// 自定义字段值，请参考本文「自定义字段数据格式说明」 /// 必填：否 /// 示例值：AA /// @@ -922,15 +922,15 @@ public record WebsiteDeliveryCustomizedData } /// - /// 描述 + /// 项目描述 /// 必填：否 - /// 示例值：项目描述：xxxx + /// 示例值：项目描述：课程管理系统 /// [JsonPropertyName("desc")] public string? Desc { get; set; } /// - /// 结束时间, 如果是至今传值-1 + /// 结束时间，毫秒时间戳，如果是「至今」可传值-1 /// 必填：否 /// 示例值：1618500278669 /// @@ -948,21 +948,21 @@ public record WebsiteDeliveryCustomizedData /// /// 项目名称 /// 必填：否 - /// 示例值：XXX项目重构 + /// 示例值：大学生课程设计 /// [JsonPropertyName("name")] public string? Name { get; set; } /// - /// 角色 + /// 项目角色 /// 必填：否 - /// 示例值：项目经理 + /// 示例值：核心开发 /// [JsonPropertyName("role")] public string? Role { get; set; } /// - /// 开始时间 + /// 开始时间，毫秒时间戳 /// 必填：否 /// 示例值：1609430400000 /// @@ -995,7 +995,7 @@ public record WebsiteDeliveryLanguage public record WebsiteDeliveryCustomizedData { /// - /// 自定义字段 ID + /// 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query)获取 /// 必填：否 /// 示例值：6960663240925956649 /// @@ -1003,7 +1003,7 @@ public record WebsiteDeliveryCustomizedData public string? ObjectId { get; set; } /// - /// 自定义字段 value，格式见接口说明 + /// 自定义字段值，请参考本文「自定义字段数据格式说明」 /// 必填：否 /// 示例值：AA /// @@ -1064,7 +1064,7 @@ public record WebsiteDeliveryCustomizedData } /// - /// 官网用户 ID + /// 官网用户 ID，需通过[新建招聘官网用户](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/website-site_user/create)生成 /// 必填：是 /// 示例值：6960663240925956634 /// @@ -1072,7 +1072,7 @@ public record WebsiteDeliveryCustomizedData public string UserId { get; set; } = string.Empty; /// - /// 意向投递城市列表，可从「获取职位信息」返回的工作地点列表获取 + /// 意向投递城市列表，可通过[查询地点列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query)获取 /// 必填：否 /// 示例值：CT_11 /// @@ -1080,7 +1080,7 @@ public record WebsiteDeliveryCustomizedData public string[]? ApplicationPreferredCityCodeList { get; set; } /// - /// 官网推广渠道 ID + /// 官网推广渠道 ID，可通过[获取招聘官网推广渠道列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/website-channel/list)获取 /// 必填：否 /// 示例值：6891560630172518670 /// diff --git a/src/Hire/PostHireV1WebsitesByWebsiteIdDeliveriesCreateByResumeResponseDto.cs b/src/Hire/PostHireV1WebsitesByWebsiteIdDeliveriesCreateByResumeResponseDto.cs index 74526fde..5250a630 100644 --- a/src/Hire/PostHireV1WebsitesByWebsiteIdDeliveriesCreateByResumeResponseDto.cs +++ b/src/Hire/PostHireV1WebsitesByWebsiteIdDeliveriesCreateByResumeResponseDto.cs @@ -34,7 +34,7 @@ public record PostHireV1WebsitesByWebsiteIdDeliveriesCreateByResumeResponseDto public record WebsiteDeliveryDto { /// - /// 投递 ID + /// 招聘投递 ID，可通过[获取投递信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/get)获取详细信息 /// 必填：否 /// 示例值：6960663240925956657 /// @@ -42,7 +42,7 @@ public record WebsiteDeliveryDto public string? ApplicationId { get; set; } /// - /// ID + /// 官网投递ID /// 必填：否 /// 示例值：6960663240925956655 /// @@ -66,7 +66,7 @@ public record WebsiteDeliveryDto public string? JobPostId { get; set; } /// - /// 官网简历 ID + /// 简历 ID /// 必填：否 /// 示例值：6960663240925956660 /// @@ -82,7 +82,7 @@ public record WebsiteDeliveryDto public string? UserId { get; set; } /// - /// 人才 ID + /// 人才 ID，详情可参考[获取人才信息 ](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/hire-v2/talent/get) /// 必填：否 /// 示例值：7095600054216542508 /// diff --git a/src/Hire/PostHireV1WebsitesByWebsiteIdJobPostsSearchBodyDto.cs b/src/Hire/PostHireV1WebsitesByWebsiteIdJobPostsSearchBodyDto.cs index a8a75834..bc59963f 100644 --- a/src/Hire/PostHireV1WebsitesByWebsiteIdJobPostsSearchBodyDto.cs +++ b/src/Hire/PostHireV1WebsitesByWebsiteIdJobPostsSearchBodyDto.cs @@ -31,7 +31,7 @@ public record PostHireV1WebsitesByWebsiteIdJobPostsSearchBodyDto public string[]? JobTypeIdList { get; set; } /// - /// 职位城市列表，详情请参考：[查询地点列表](https://open.larkoffice.com/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query) + /// 职位城市列表，详情请参考：[查询地点列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query) /// 必填：否 /// 示例值：CT_1 /// 最大长度：100 diff --git a/src/Hire/PostHireV1WebsitesByWebsiteIdJobPostsSearchResponseDto.cs b/src/Hire/PostHireV1WebsitesByWebsiteIdJobPostsSearchResponseDto.cs index 3bca43fe..216ac93e 100644 --- a/src/Hire/PostHireV1WebsitesByWebsiteIdJobPostsSearchResponseDto.cs +++ b/src/Hire/PostHireV1WebsitesByWebsiteIdJobPostsSearchResponseDto.cs @@ -36,7 +36,7 @@ public record WebsiteJobPost /// /// 职位广告 ID /// 必填：否 - /// 示例值：1213213123123 + /// 示例值：7392894182636144946 /// [JsonPropertyName("id")] public string? Id { get; set; } @@ -112,7 +112,7 @@ public record IdNameObject /// /// 职位雇佣类型 ID /// 必填：否 - /// 示例值：1213213123123 + /// 示例值：101 /// [JsonPropertyName("id")] public string? Id { get; set; } @@ -176,14 +176,14 @@ public record I18n public IdNameObject? MaxJobLevel { get; set; } /// - /// 职位地址，详情请参考：[获取地址列表](https://open.larkoffice.com/document/server-docs/hire-v1/recruitment-related-configuration/location/list) + /// 职位地址，详情请参考：[获取地址列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/list) /// 必填：否 /// [JsonPropertyName("address")] public CommonAddress? Address { get; set; } /// - /// 职位地址，详情请参考：[获取地址列表](https://open.larkoffice.com/document/server-docs/hire-v1/recruitment-related-configuration/location/list) + /// 职位地址，详情请参考：[获取地址列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/list) /// public record CommonAddress { @@ -239,7 +239,7 @@ public record CodeNameObject /// /// 区域编码 /// 必填：否 - /// 示例值：1111 + /// 示例值：MDCA00009061 /// [JsonPropertyName("code")] public string? Code { get; set; } @@ -299,7 +299,7 @@ public record I18n /// /// 月薪范围-最低薪资，单位：千 /// 必填：否 - /// 示例值：5000 + /// 示例值：5 /// [JsonPropertyName("min_salary")] public string? MinSalary { get; set; } @@ -307,7 +307,7 @@ public record I18n /// /// 月薪范围-最高薪资，单位：千 /// 必填：否 - /// 示例值：10000 + /// 示例值：10 /// [JsonPropertyName("max_salary")] public string? MaxSalary { get; set; } @@ -416,9 +416,9 @@ public record I18n public record WebsiteJobPostCustomizedData { /// - /// 自定义字段 ID，详情请参考：[获取职位模版](https://open.larkoffice.com/document/server-docs/hire-v1/recruitment-related-configuration/job/list) + /// 自定义字段 ID，详情请参考：[获取职位模板](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_schema/list) /// 必填：否 - /// 示例值：xxxx + /// 示例值：6949805467799537964 /// [JsonPropertyName("object_id")] public string? ObjectId { get; set; } @@ -446,7 +446,7 @@ public record I18n /// /// 字段英文名称 /// 必填：否 - /// 示例值：集团化 + /// 示例值：collectivize /// [JsonPropertyName("en_us")] public string? EnUs { get; set; } @@ -611,7 +611,7 @@ public record WebsiteJobPostCustomizedTimeRange public IdNameObject? Subject { get; set; } /// - /// 职位地址列表，详情请参考：[获取地址列表](https://open.larkoffice.com/document/server-docs/hire-v1/recruitment-related-configuration/location/list) + /// 职位地址列表，详情请参考：[获取地址列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/list) /// 必填：否 /// [JsonPropertyName("address_list")] diff --git a/src/IFeishuTenantApi.cs b/src/IFeishuTenantApi.cs index 0a72c122..3ad614d6 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-07-22 +// Last Modified On : 2024-07-24 // ************************************************************************ // // MIT @@ -14107,7 +14107,7 @@ System.Threading.Tasks.Task PatchApplicationV6ApplicationsByAppI /// 接口ID：6990661791098650627 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/website-job_post/get /// Authorization：tenant_access_token - /// 获取招聘官网下职位广告详情。 + /// 获取招聘官网下的职位广告详情，包含职位广告 ID、名称、关联职位 ID、关联职位编码等信息。 /// 权限要求： /// hire:site_job_post:readonly /// @@ -14118,14 +14118,14 @@ System.Threading.Tasks.Task PatchApplicationV6ApplicationsByAppI /// /// 路径参数 /// 必填：是 - /// 官网 ID - /// 示例值：111 + /// 官网 ID，可通过[获取招聘官网列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/website/list)获取 + /// 示例值：7047318856652261676 /// /// /// 路径参数 /// 必填：是 - /// 职位广告 ID - /// 示例值：111 + /// 职位广告 ID，可通过[获取招聘官网下的职位广告列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/website-job_post/list)或[搜索招聘官网下的职位广告列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/website-job_post/search)获取 + /// 示例值：7392894182636144946 /// /// /// 必填：否 @@ -14151,7 +14151,7 @@ System.Threading.Tasks.Task PatchApplicationV6ApplicationsByAppI /// /// 必填：否 /// 此次调用中使用的「职级 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)接口获取 @@ -14348,7 +14348,7 @@ System.Threading.Tasks.Task PatchApplicationV6ApplicationsByAppI /// /// 路径参数 /// 必填：是 - /// 官网 ID + /// 官网 ID，可通过[获取招聘官网列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/website/list)获取 /// 示例值：1618209327096 /// /// @@ -16296,7 +16296,7 @@ System.Threading.Tasks.Task DeleteCorehrV1PersonsByPersonIdAsync /// 接口ID：7017694651621883908 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/contract/get /// Authorization：tenant_access_token - /// 根据 ID 查询单个合同。 + /// 该接口用于根据合同 ID 查询单个合同详细信息，包括合同开始日期、结束日期、公司主体等信息 /// 权限要求： /// corehr:corehr /// corehr:corehr:readonly @@ -16305,8 +16305,8 @@ System.Threading.Tasks.Task DeleteCorehrV1PersonsByPersonIdAsync /// /// 路径参数 /// 必填：是 - /// 合同ID - /// 示例值：151515 + /// 合同ID，该ID可以通过[【批量查询合同】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/contract/list)接口获取 + /// 示例值：7091849027838838316 /// [HttpGet("/open-apis/corehr/v1/contracts/{contract_id}")] System.Threading.Tasks.Task> GetCorehrV1ContractsByContractIdAsync( @@ -16768,7 +16768,7 @@ System.Threading.Tasks.Task DeleteCorehrV1PreHiresByPreHireIdAsy /// 接口ID：7017707615190859779 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/contract/delete /// Authorization：tenant_access_token - /// 删除合同。 + /// 通过本接口可以删除合同数据，删除后即无法查询到。 /// 权限要求： /// corehr:corehr /// @@ -16776,8 +16776,8 @@ System.Threading.Tasks.Task DeleteCorehrV1PreHiresByPreHireIdAsy /// /// 路径参数 /// 必填：是 - /// 需要删除的合同 ID - /// 示例值：4137834332 + /// 需要删除的合同 ID，该ID可以通过[【批量查询合同】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/contract/list)接口获取 + /// 示例值：7091849027838838316 /// [HttpDelete("/open-apis/corehr/v1/contracts/{contract_id}")] System.Threading.Tasks.Task DeleteCorehrV1ContractsByContractIdAsync( @@ -16788,15 +16788,15 @@ System.Threading.Tasks.Task DeleteCorehrV1ContractsByContractIdA /// 接口ID：7017707615190876163 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/contract/create /// Authorization：tenant_access_token - /// 创建合同。 + /// 通过本接口可以为员工创建合同 /// 权限要求： /// corehr:corehr /// /// /// /// 必填：否 - /// 根据client_token是否一致来判断是否为同一请求 - /// 示例值：12454646 + /// 自定义值，根据client_token是否一致来判断是否为同一请求 + /// 示例值：22ff85f7-5938-4579-9b57-d52cfeb05d52 /// 默认值：null /// /// 请求体 @@ -17307,7 +17307,7 @@ System.Threading.Tasks.Task DeleteCorehrV1ContractsByContractIdA /// 接口ID：7017707615191121923 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/contract/list /// Authorization：tenant_access_token - /// 批量查询合同。 + /// 通过接口可以批量查询合同列表信息，目前暂不支持其他筛选条件且一次查询最多支持50条数据。 /// 权限要求： /// corehr:corehr /// corehr:corehr:readonly @@ -17316,13 +17316,13 @@ System.Threading.Tasks.Task DeleteCorehrV1ContractsByContractIdA /// /// 必填：否 /// 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果 - /// 示例值：1231231987 + /// 示例值：10 /// 默认值：null /// /// /// 必填：是 - /// 分页大小 - /// 示例值：100 + /// 分页大小；范围：0～50 + /// 示例值：10 /// 默认值：10 /// [HttpGet("/open-apis/corehr/v1/contracts")] @@ -17536,7 +17536,7 @@ System.Threading.Tasks.Task DeleteMailV1PublicMailboxesByPublicM /// /// 路径参数 /// 必填：是 - /// 官网 ID，通过[「获取招聘官网列表」](https://open.larkoffice.com/document/server-docs/hire-v1/get-candidates/website/list)接口获得 + /// 官网 ID，可通过[获取招聘官网列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/website/list)获取 /// 示例值：7098921721789513756 /// /// @@ -17918,7 +17918,9 @@ System.Threading.Tasks.Task DeleteImV1BatchMessagesByBatchMessag /// /// 路径参数 /// 必填：是 - /// 知识空间id + /// 知识空间 ID。可通过以下两种方式获取。了解更多，参考[知识库概述](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-overview)。 + /// - 调用 [获取知识空间列表](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space/list)获取 + /// - 如果你是知识库管理员，可以进入知识库设置页面，复制地址栏的数字部分：https://sample.feishu.cn/wiki/settings/==6870403571079249922== /// 示例值：1565676577122621 /// /// @@ -18833,6 +18835,39 @@ System.Threading.Tasks.Task DeleteMailV1UserMailboxesByUserMailb [JsonContent] Application.PostApplicationV6ApplicationsByAppIdAppUsageDepartmentOverviewBodyDto dto, [PathQuery] string? department_id_type = "open_department_id"); + /// + /// 【应用信息】获取消息推送概览 + /// 接口ID：7036626399368953884 + /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/application-app_usage/message_push_overview + /// Authorization：tenant_access_token + /// 目标：查看应用在某一天/某一周/某一个月的机器人消息推送数据，可以根据部门做筛选 + /// 权限要求： + /// application:application.app_message_stats.overview:readonly + /// + /// + /// + /// 路径参数 + /// 必填：是 + /// 目标应用ID，支持自建应用 + /// 示例值：cli_9f115af860f7901b + /// + /// + /// 必填：否 + /// 调用中使用的部门ID的类型 + /// 示例值：open_department_id + /// + /// department_id：以自定义department_id来标识部门 + /// open_department_id：以open_department_id来标识部门 + /// + /// 默认值：open_department_id + /// + /// 请求体 + [HttpPost("/open-apis/application/v6/applications/{app_id}/app_usage/message_push_overview")] + System.Threading.Tasks.Task> PostApplicationV6ApplicationsByAppIdAppUsageMessagePushOverviewAsync( + [PathQuery] string app_id, + [JsonContent] Application.PostApplicationV6ApplicationsByAppIdAppUsageMessagePushOverviewBodyDto dto, + [PathQuery] string? department_id_type = "open_department_id"); + /// /// 【招聘】获取终止投递原因 /// 接口ID：7036934321795039234 @@ -19223,7 +19258,7 @@ System.Threading.Tasks.Task PostImV1ChatsByChatIdTopNoticeDelete /// 接口ID：7044467124773388289 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_daily_shift/batch_create /// Authorization：tenant_access_token - /// 班表是用来描述考勤组内人员每天按哪个班次进行上班。目前班表支持按一个整月对一位或多位人员进行排班。当用户的排班数据不存在时会进行创建，当用户的排班数据存在时会按照入参信息进行修改。注意：每人每天只能在一个考勤组中。 + /// 排班表是用来描述考勤组内人员每天按哪个班次进行上班。目前排班表支持按一个整月对一位或多位人员进行排班。当用户的排班数据不存在时会进行创建，当用户的排班数据存在时会按照入参信息进行修改。注意：每人每天只能在一个考勤组中。 /// 权限要求： /// attendance:rule /// @@ -19810,7 +19845,7 @@ System.Threading.Tasks.Task DeleteAttendanceV1ShiftsByShiftIdAsy /// 接口ID：7044467124773814273 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_stats_field/query /// Authorization：tenant_access_token - /// 查询考勤统计支持的日度统计或月度统计的统计表头。 + /// 查询考勤统计支持的日度统计或月度统计的统计表头。报表的表头信息可以在考勤统计-[报表](https://example.feishu.cn/people/workforce-management/manage/statistics/report)中查询到具体的报表信息，此接口专门用于查询表头数据 /// 权限要求： /// attendance:task /// attendance:task:readonly @@ -19818,11 +19853,11 @@ System.Threading.Tasks.Task DeleteAttendanceV1ShiftsByShiftIdAsy /// /// /// 必填：是 - /// 响应体中的 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) > 组织架构 > 成员与部门 > 成员详情中的工号 /// /// /// 请求体 @@ -19836,7 +19871,7 @@ System.Threading.Tasks.Task DeleteAttendanceV1ShiftsByShiftIdAsy /// 接口ID：7044467124773830657 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_stats_view/query /// Authorization：tenant_access_token - /// 查询开发者定制的日度统计或月度统计的统计报表表头设置信息。 + /// 查询考勤统计支持的日度统计或月度统计的统计表头。报表的表头信息可以在考勤统计-[报表](https://example.feishu.cn/people/workforce-management/manage/statistics/report)中查询到具体的报表信息，此接口专门用于查询表头数据。注意此接口和[查询统计表头](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_stats_field/query)基本相同，区别点在于在兼容历史统计视图模型（历史统计数据模型可以按用户ID设置，后续统计升级为仅支持租户维度） /// 权限要求： /// attendance:task /// attendance:task:readonly @@ -19844,11 +19879,11 @@ System.Threading.Tasks.Task DeleteAttendanceV1ShiftsByShiftIdAsy /// /// /// 必填：是 - /// 响应体中的 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) > 组织架构 > 成员与部门 > 成员详情中的工号 /// /// /// 请求体 @@ -21391,27 +21426,25 @@ System.Threading.Tasks.Task PatchApplicationV6ApplicationsByAppI /// 路径参数 /// 必填：是 /// 目标应用 ID（本租户创建的所有应用） - /// **示例值**："cli_9f115af860f7901b" + /// 示例值：cli_9f115af860f7901b /// /// /// 必填：否 /// 查询的起始日期，格式为yyyy-mm-dd。不填则默认为当前日期减去180天。 - /// **示例值**："2022-01-30" + /// 示例值：2022-01-30 /// 默认值：null /// /// /// 必填：否 /// 查询的结束日期，格式为yyyy-mm-dd。不填默认为当前日期。 /// 只能查询 180 天内的数据。 - /// **示例值**："2022-01-30" + /// 示例值：2022-01-30 /// 默认值：null /// /// /// 必填：否 /// 反馈类型，不填写则表示查询所有反馈类型。 - /// **示例值**：1 - /// **可选值有**： - /// 1:故障反馈,2:产品建议 + /// 示例值：1 /// /// 1：故障反馈 /// 2：产品建议 @@ -21421,9 +21454,7 @@ System.Threading.Tasks.Task PatchApplicationV6ApplicationsByAppI /// /// 必填：否 /// 反馈处理状态，不填写则表示查询所有处理类型。 - /// **示例值**：0 - /// **可选值有**： - /// 0:反馈未处理,1:反馈已处理,2:反馈处理中,3:反馈已关闭 + /// 示例值：0 /// /// 0：反馈未处理 /// 1：反馈已处理 @@ -21435,36 +21466,28 @@ System.Threading.Tasks.Task PatchApplicationV6ApplicationsByAppI /// /// 必填：否 /// 用户 ID 类型 - /// **示例值**："open_id" - /// **可选值有**： - /// open_id:标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。[了解更多：如何获取 Open ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid),union_id:标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。[了解更多：如何获取 Union ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-union-id),user_id:标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。[了解更多：如何获取 User ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-user-id) - /// **默认值**：`open_id` - /// **当值为 `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 不同。[了解更多：如何获取 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：标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。[了解更多：如何获取 Open ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid) + /// union_id：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。[了解更多：如何获取 Union ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-union-id) + /// user_id：标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。[了解更多：如何获取 User ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-user-id) /// /// 默认值：open_id /// /// /// 必填：否 - /// 分页拉取反馈列表起始位置标示，不填表示从头开始 - /// **示例值**：""7064688334618378259"" + /// 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果 + /// 示例值："7064688334618378259" /// 默认值：null /// /// /// 必填：否 /// 本次拉取反馈列表最大个数 - /// **示例值**：100 - /// **默认值**：`100` - /// **数据校验规则**： - /// - 取值范围：`1` ～ `100` - /// 默认值：10 + /// 示例值：100 + /// 默认值：100 /// [HttpGet("/open-apis/application/v6/applications/{app_id}/feedbacks")] - System.Threading.Tasks.Task> GetApplicationV6ApplicationsByAppIdFeedbacksAsync( + System.Threading.Tasks.Task> GetApplicationV6ApplicationsByAppIdFeedbacksAsync( [PathQuery] string app_id, [PathQuery] string? from_date = null, [PathQuery] string? to_date = null, @@ -21472,7 +21495,7 @@ System.Threading.Tasks.Task PatchApplicationV6ApplicationsByAppI [PathQuery] int? status = null, [PathQuery] string? user_id_type = "open_id", [PathQuery] string? page_token = null, - [PathQuery] int? page_size = 10); + [PathQuery] int? page_size = 100); /// /// 【飞书人事】更新职级 @@ -21572,7 +21595,7 @@ System.Threading.Tasks.Task DeleteCorehrV1CompaniesByCompanyIdAs /// 接口ID：7072977430599892994 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/contract/patch /// Authorization：tenant_access_token - /// 更新合同。 + /// 通过该接口可以更新员工合同相关信息，没有修改的参数会保留原值 /// 权限要求： /// corehr:corehr /// @@ -21580,13 +21603,13 @@ System.Threading.Tasks.Task DeleteCorehrV1CompaniesByCompanyIdAs /// /// 路径参数 /// 必填：是 - /// 合同ID - /// 示例值：1616161616 + /// 合同ID，该ID可以通过[【批量查询合同】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/contract/list)接口获取 + /// 示例值：7091849027838838316 /// /// /// 必填：否 - /// 根据client_token是否一致来判断是否为同一请求 - /// 示例值：12454646 + /// 自定义值，根据client_token是否一致来判断是否为同一请求 + /// 示例值：227988d7-66da-4afb-9943-32e73d5cda8b /// 默认值：null /// /// 请求体 @@ -26160,7 +26183,7 @@ System.Threading.Tasks.Task PostMdmV1UserAuthDataRelationsUnbind [PathQuery] string? user_id_type = "open_id"); /// - /// 【云文档】获取协作者列表（新版） + /// 【云文档】获取协作者列表 /// 接口ID：7121656165336367106 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-member/list /// Authorization：tenant_access_token、user_access_token @@ -29985,7 +30008,7 @@ System.Threading.Tasks.Task PatchVcV1ReserveConfigsByReserveConf /// 接口ID：7194805625628065795 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/resource_reservation_list/get /// Authorization：tenant_access_token、user_access_token - /// 查询会议室预定数据，，具体权限要求请参考「资源介绍」。 + /// 查询会议室预定数据，具体权限要求请参考「资源介绍」。 /// 权限要求： /// vc:room:readonly /// @@ -30013,7 +30036,7 @@ System.Threading.Tasks.Task PatchVcV1ReserveConfigsByReserveConf /// /// /// 必填：是 - /// 待筛选的会议室id列表 + /// 待筛选的会议室ID列表；如需要传递多个会议室ID，需要通过room_ids=aaaa&room_ids=bbbb&room_ids=cccc的形式传递 /// 示例值：["omm_12443435556"] /// /// @@ -32254,7 +32277,9 @@ System.Threading.Tasks.Task GetCorehrV1FilesByIdAsync( /// /// 路径参数 /// 必填：是 - /// 个人信息 ID。该 ID 在创建个人信息时可从响应体中获取（person_id），此外你也可以调用[搜索员工信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search)接口，获取指定员工的 person_id。 + /// 个人信息 ID + /// - 该 ID 在创建个人信息时可从响应体中获取（person_id） + /// - 此外你也可以调用[【搜索员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search)接口，获取指定员工的 person_id。 /// 示例值：12454646 /// /// @@ -33066,7 +33091,7 @@ System.Threading.Tasks.Task PostHireV1TalentsByTalentIdOnboardSt /// 接口ID：7248868628551303172 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/contract/search /// Authorization：tenant_access_token - /// 搜索合同信息 + /// 该接口可用于搜索合同信息，包括合同开始时间、合同预计结束时间、合同实际结束时间、合同公司主体等信息 /// 权限要求： /// corehr:contract:read /// corehr:contract:write @@ -33088,7 +33113,7 @@ System.Threading.Tasks.Task PostHireV1TalentsByTalentIdOnboardSt /// /// 必填：否 /// 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果 - /// 示例值：6891251722631890445 + /// 示例值：10 /// 默认值：null /// /// @@ -33797,11 +33822,11 @@ System.Threading.Tasks.Task GetLingoV1FilesByFileTokenDownl [PathQuery] string referral_account_id); /// - /// 【招聘】全额提取内推账号余额 + /// 【招聘】全额提取内推账户余额 /// 接口ID：7252281835550883842 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/referral_account/withdraw /// Authorization：tenant_access_token - /// 支持通过账号 ID 全额提取内推账号下的积分或现金奖励。调用前，请确认已完成[「注册外部系统内推账户」](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/referral_account/create)并获取到账号 ID。提现后，内推人的对应积分或现金余额将变为 0，扣减后对应奖励将在招聘系统同步标记为「已发放」 + /// 通过账号 ID 全额提取内推账号下的积分。全额提现后，内推人在飞书招聘系统中的积分余额会变为 0，对应的积分奖励状态也会变为「已发放」。 /// 权限要求： /// hire:referral_account /// @@ -33809,7 +33834,7 @@ System.Threading.Tasks.Task GetLingoV1FilesByFileTokenDownl /// /// 路径参数 /// 必填：是 - /// 账户ID + /// 账户 ID，通过[注册内推账户](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/referral_account/create)生成 /// 示例值：6942778198054125570 /// /// 请求体 @@ -33819,11 +33844,11 @@ System.Threading.Tasks.Task GetLingoV1FilesByFileTokenDownl [JsonContent] Hire.PostHireV1ReferralAccountByReferralAccountIdWithdrawBodyDto dto); /// - /// 【招聘】内推账号提现对账接口 + /// 【招聘】内推账户提现数据对账 /// 接口ID：7252281835550900226 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/referral_account/reconciliation /// Authorization：tenant_access_token - /// 定时将时间段内的账户充值信息同步到招聘，与招聘实际提取金额做对比，保证系统异常或其他意外情况发生时，双方系统可及时监控到充值异常等错误 + /// 对一段时间内的内推账户积分提现数据进行对账，调用方需传入调用方系统的内推账户积分变动信息。 /// 权限要求： /// hire:referral_account /// @@ -39025,6 +39050,66 @@ System.Threading.Tasks.Task PutApplicationV6ApplicationsByAppIdM [PathQuery] string? feishu_user_id_type = "open_id", [PathQuery] string? feishu_department_id_type = "open_department_id"); + /// + /// 【飞书人事（企业版）】通过/拒绝审批任务 + /// 接口ID：7340625370520797187 + /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/process-approver/update + /// Authorization：tenant_access_token + /// 对于单个审批任务进行通过（提交）或拒绝操作。对于多人或签节点，一个审批任务通过则整个节点通过；对于多人会签节点，所有审批任务通过则节点通过。在通过（提交）时，若表单中有必填字段，支持写入表单字段。 + /// 权限要求： + /// corehr:process.instance:write + /// + /// 字段权限要求： + /// contact:user.employee_id:readonly + /// + /// + /// + /// 路径参数 + /// 必填：是 + /// 流程实例id，是一个流程的唯一标识。 + /// 可通过[查询流程实例列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/process/list)接口返回的 process_ids 字段获取 + /// 示例值：7328345170959681068 + /// + /// + /// 路径参数 + /// 必填：是 + /// 标识流程中一个审批节点的一个审批人的审批任务。 + /// 同一个审批节点如果有多个审批人，不同审批人的 approver_id 不同。 + /// 可通过 [获取单个流程详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/process/get)接口获取流程中各审批任务的 approver_id。 + /// 示例值：7381468648050787884 + /// + /// + /// 必填：否 + /// 用户 ID 类型 + /// 示例值：open_id + /// + /// open_id：标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。[了解更多：如何获取 Open ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid) + /// union_id：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。[了解更多：如何获取 Union ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-union-id) + /// user_id：标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。[了解更多：如何获取 User ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-user-id) + /// people_corehr_id：以飞书人事的 ID 来识别用户 + /// + /// 默认值：open_id + /// + /// + /// 必填：否 + /// 此次调用中使用的部门 ID 类型 + /// 示例值：open_department_id + /// + /// open_department_id：以 open_department_id 来标识部门 + /// department_id：以 department_id 来标识部门 + /// people_corehr_department_id：以 people_corehr_department_id 来标识部门 + /// + /// 默认值：open_department_id + /// + /// 请求体 + [HttpPut("/open-apis/corehr/v2/processes/{process_id}/approvers/{approver_id}")] + System.Threading.Tasks.Task> PutCorehrV2ProcessesByProcessIdApproversByApproverIdAsync( + [PathQuery] string process_id, + [PathQuery] string approver_id, + [JsonContent] Corehr.PutCorehrV2ProcessesByProcessIdApproversByApproverIdBodyDto dto, + [PathQuery] string? user_id_type = "open_id", + [PathQuery] string? department_id_type = "open_department_id"); + /// /// 【AI 能力】识别文件中的简历信息 /// 接口ID：7340987945434742812 @@ -39794,6 +39879,56 @@ System.Threading.Tasks.Task DeleteCorehrV2PreHiresByPreHireIdAsy [PathQuery] int page_size = 10, [PathQuery] string? page_token = null); + /// + /// 【考勤打卡】查询归档报表表头 + /// 接口ID：7368679915980898306 + /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/archive_rule/user_stats_fields_query + /// Authorization：tenant_access_token、user_access_token + /// 查询归档报表表头，对应后台假勤管理-考勤统计-报表-[归档报表](https://example.feishu.cn/people/workforce-management/manage/statistics/report)中一个归档报表的表头信息。归档报表支持引用系统报表，可设置归档时间和数据归档周期，并且支持根据部门/人员、国家/地区、人员类型、工作地点、职级、序列、职务进行人员圈选。 + /// 权限要求： + /// attendance:task + /// + /// + /// + /// 必填：是 + /// 响应体中的 user_id 的员工ID类型。如果没有后台管理权限，可使用[通过手机号或邮箱获取用户 ID](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/batch_get_id) + /// * `员工 employee ID`即[飞书管理后台](https://example.feishu.cn/admin/contacts/departmentanduser) > 组织架构 > 成员与部门 > 成员详情中的用户 ID + /// * `员工工号`即[飞书管理后台](https://example.feishu.cn/admin/contacts/departmentanduser) > 组织架构 > 成员与部门 > 成员详情中的工号 + /// 示例值：employee_id + /// + /// 请求体 + [HttpPost("/open-apis/attendance/v1/archive_rule/user_stats_fields_query")] + System.Threading.Tasks.Task> PostAttendanceV1ArchiveRuleUserStatsFieldsQueryAsync( + [PathQuery] string employee_type, + [JsonContent] Attendance.PostAttendanceV1ArchiveRuleUserStatsFieldsQueryBodyDto dto); + + /// + /// 【考勤打卡】查询所有归档规则 + /// 接口ID：7368679915980947458 + /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/archive_rule/list + /// Authorization：tenant_access_token、user_access_token + /// 查询所有归档规则，对应后台假勤管理-考勤统计-报表-[归档报表](https://example.feishu.cn/people/workforce-management/manage/statistics/report)功能 + /// 权限要求： + /// attendance:task:readonly + /// + /// + /// + /// 必填：否 + /// 分页大小，必填参数 + /// 示例值：10 + /// 默认值：10 + /// + /// + /// 必填：否 + /// 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果 + /// 示例值：xxx + /// 默认值：null + /// + [HttpGet("/open-apis/attendance/v1/archive_rule")] + System.Threading.Tasks.Task> GetAttendanceV1ArchiveRuleAsync( + [PathQuery] int? page_size = 10, + [PathQuery] string? page_token = null); + /// /// 【绩效】批量删除补充信息 /// 接口ID：7371009404255600644 diff --git a/src/IFeishuUserApi.cs b/src/IFeishuUserApi.cs index ec57d675..55ffd4ba 100644 --- a/src/IFeishuUserApi.cs +++ b/src/IFeishuUserApi.cs @@ -4,7 +4,7 @@ // Created : 2024-06-24 // // Last Modified By : yxr -// Last Modified On : 2024-07-22 +// Last Modified On : 2024-07-24 // ************************************************************************ // // MIT @@ -9519,7 +9519,9 @@ System.Threading.Tasks.Task DeleteTaskV1TasksByTaskIdCommentsByC /// /// 路径参数 /// 必填：是 - /// 知识空间id + /// 知识空间 ID。可通过以下两种方式获取。了解更多，参考[知识库概述](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-overview)。 + /// - 调用 [获取知识空间列表](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space/list)获取 + /// - 如果你是知识库管理员，可以进入知识库设置页面，复制地址栏的数字部分：https://sample.feishu.cn/wiki/settings/==6870403571079249922== /// 示例值：1565676577122621 /// /// @@ -12300,7 +12302,7 @@ System.Threading.Tasks.Task PatchSheetsV3SpreadsheetsBySpreadshe [PathQuery] string spreadsheet_token); /// - /// 【云文档】获取协作者列表（新版） + /// 【云文档】获取协作者列表 /// 接口ID：7121656165336367106 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-member/list /// Authorization：tenant_access_token、user_access_token @@ -13756,7 +13758,7 @@ System.Threading.Tasks.Task PostDriveV1PermissionsByTokenMembers /// 接口ID：7194805625628065795 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/resource_reservation_list/get /// Authorization：tenant_access_token、user_access_token - /// 查询会议室预定数据，，具体权限要求请参考「资源介绍」。 + /// 查询会议室预定数据，具体权限要求请参考「资源介绍」。 /// 权限要求： /// vc:room:readonly /// @@ -13784,7 +13786,7 @@ System.Threading.Tasks.Task PostDriveV1PermissionsByTokenMembers /// /// /// 必填：是 - /// 待筛选的会议室id列表 + /// 待筛选的会议室ID列表；如需要传递多个会议室ID，需要通过room_ids=aaaa&room_ids=bbbb&room_ids=cccc的形式传递 /// 示例值：["omm_12443435556"] /// /// @@ -18268,6 +18270,60 @@ System.Threading.Tasks.Task DeleteAilyV1SessionsByAilySessionIdA UserAccessToken access_token, [JsonContent] Aily.PostAilyV1SessionsBodyDto dto); + /// + /// 【考勤打卡】查询归档报表表头 + /// 接口ID：7368679915980898306 + /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/archive_rule/user_stats_fields_query + /// Authorization：tenant_access_token、user_access_token + /// 查询归档报表表头，对应后台假勤管理-考勤统计-报表-[归档报表](https://example.feishu.cn/people/workforce-management/manage/statistics/report)中一个归档报表的表头信息。归档报表支持引用系统报表，可设置归档时间和数据归档周期，并且支持根据部门/人员、国家/地区、人员类型、工作地点、职级、序列、职务进行人员圈选。 + /// 权限要求： + /// attendance:task + /// + /// + /// + /// 必填：是 + /// 响应体中的 user_id 的员工ID类型。如果没有后台管理权限，可使用[通过手机号或邮箱获取用户 ID](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/batch_get_id) + /// * `员工 employee ID`即[飞书管理后台](https://example.feishu.cn/admin/contacts/departmentanduser) > 组织架构 > 成员与部门 > 成员详情中的用户 ID + /// * `员工工号`即[飞书管理后台](https://example.feishu.cn/admin/contacts/departmentanduser) > 组织架构 > 成员与部门 > 成员详情中的工号 + /// 示例值：employee_id + /// + /// 请求体 + /// 用户凭证 + [HttpPost("/open-apis/attendance/v1/archive_rule/user_stats_fields_query")] + System.Threading.Tasks.Task> PostAttendanceV1ArchiveRuleUserStatsFieldsQueryAsync( + UserAccessToken access_token, + [PathQuery] string employee_type, + [JsonContent] Attendance.PostAttendanceV1ArchiveRuleUserStatsFieldsQueryBodyDto dto); + + /// + /// 【考勤打卡】查询所有归档规则 + /// 接口ID：7368679915980947458 + /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/archive_rule/list + /// Authorization：tenant_access_token、user_access_token + /// 查询所有归档规则，对应后台假勤管理-考勤统计-报表-[归档报表](https://example.feishu.cn/people/workforce-management/manage/statistics/report)功能 + /// 权限要求： + /// attendance:task:readonly + /// + /// + /// + /// 必填：否 + /// 分页大小，必填参数 + /// 示例值：10 + /// 默认值：10 + /// + /// + /// 必填：否 + /// 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果 + /// 示例值：xxx + /// 默认值：null + /// + /// 用户凭证 + [HttpGet("/open-apis/attendance/v1/archive_rule")] + System.Threading.Tasks.Task> GetAttendanceV1ArchiveRuleAsync( + UserAccessToken access_token, + [PathQuery] int? page_size = 10, + [PathQuery] string? page_token = null); + /// /// 【绩效】获取指标库信息 /// 接口ID：7380276358332661761 diff --git a/src/Vc/GetVcV1ResourceReservationListResponseDto.cs b/src/Vc/GetVcV1ResourceReservationListResponseDto.cs index e762da33..c9a51108 100644 --- a/src/Vc/GetVcV1ResourceReservationListResponseDto.cs +++ b/src/Vc/GetVcV1ResourceReservationListResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Vc; /// /// 查询会议室预定数据 响应体 -/// 查询会议室预定数据，，具体权限要求请参考「资源介绍」。 +/// 查询会议室预定数据，具体权限要求请参考「资源介绍」。 /// 接口ID：7194805625628065795 /// 文档地址：https://open.feishu.cn/document/server-docs/vc-v1/meeting-room-data/get-4 /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fvc-v1%2fresource_reservation_list%2fget