diff --git a/TenantAccessList.md b/TenantAccessList.md index 1677bc20..1724bb9f 100644 --- a/TenantAccessList.md +++ b/TenantAccessList.md @@ -81,7 +81,7 @@ PostDriveV1MetasBatchQuery 412024-12-03✓云文档[不推荐] 新建文件 PostDriveExplorerV2FileByFolderToken -422024-10-10✓云文档复制文件 +422024-12-12✓云文档复制文件 PostDriveV1FilesByFileTokenCopy 432024-09-20✓云文档移动文件或文件夹 PostDriveV1FilesByFileTokenMove @@ -121,7 +121,7 @@ PostDriveV1FilesUploadPrepare 612024-05-29✓云文档分片上传文件-上传分片 PostDriveV1FilesUploadPart -622024-11-28✓云文档分片上传文件-完成上传 +622024-12-10✓云文档分片上传文件-完成上传 PostDriveV1FilesUploadFinish 632024-09-05✓云文档下载文件 GetDriveV1FilesByFileTokenDownload @@ -399,7 +399,7 @@ PutBitableV1AppsByAppTokenTablesByTableIdRecordsByRecordId 2002024-11-18✓多维表格删除记录 DeleteBitableV1AppsByAppTokenTablesByTableIdRecordsByRecordId -2012024-11-28✓多维表格新增多条记录 +2012024-12-11✓多维表格新增多条记录 PostBitableV1AppsByAppTokenTablesByTableIdRecordsBatchCreate 2022024-07-05✓通讯录获取单个部门信息 GetContactV3DepartmentsByDepartmentId @@ -1213,9 +1213,9 @@ PostDocumentAiV1BankCardRecognize 6072024-11-13✓AI 能力识别文件中的行驶证 PostDocumentAiV1VehicleLicenseRecognize -6082024-11-13✓AI 能力识别文件中的火车票 +6082024-12-11✓AI 能力识别文件中的火车票 PostDocumentAiV1TrainInvoiceRecognize -6092024-11-13✓AI 能力识别文件中的出租车发票 +6092024-12-11✓AI 能力识别文件中的出租车发票 PostDocumentAiV1TaxiInvoiceRecognize 6102024-11-13✓AI 能力识别文件中的身份证 PostDocumentAiV1IdCardRecognize @@ -1227,7 +1227,7 @@ GetContactV3JobTitles 6142024-11-13✓AI 能力识别文件中的驾驶证 PostDocumentAiV1DrivingLicenseRecognize -6152024-11-13✓AI 能力识别文件中的增值税发票 +6152024-12-11✓AI 能力识别文件中的增值税发票 PostDocumentAiV1VatInvoiceRecognize 6162024-11-13✓AI 能力识别文件中的营业执照 PostDocumentAiV1BusinessLicenseRecognize @@ -1289,7 +1289,7 @@ GetCorehrV1CountryRegionsByCountryRegionId 6452023-07-14✓飞书人事批量查询国家/地区信息 GetCorehrV1CountryRegions -6462024-11-12✓消息与群组发送消息 +6462024-12-11✓消息与群组发送消息 PostImV1Messages 6472023-07-14✓飞书人事查询单条省份/行政区信息 GetCorehrV1SubdivisionsBySubdivisionId @@ -1311,7 +1311,7 @@ GetCorehrV1EmployeeTypes 6562024-09-23✓飞书人事创建国家证件类型 PostCorehrV1NationalIdTypes -6572024-11-19✓消息与群组回复消息 +6572024-12-11✓消息与群组回复消息 PostImV1MessagesByMessageIdReply 6582024-09-23✓飞书人事删除国家证件类型 DeleteCorehrV1NationalIdTypesByNationalIdTypeId @@ -1357,7 +1357,7 @@ DeleteCorehrV1PersonsByPersonId 6792024-07-08✓飞书人事上传文件 PostCorehrV1PersonsUpload -6802024-09-25✓消息与群组撤回消息 +6802024-12-11✓消息与群组撤回消息 DeleteImV1MessagesByMessageId 6812024-02-06✓飞书人事下载文件 GetCorehrV1FilesById @@ -1379,7 +1379,7 @@ PostCorehrV2DepartmentsParents 6902024-11-27✓飞书人事（企业版）搜索部门信息 PostCorehrV2DepartmentsSearch -6912024-09-25✓消息与群组转发消息 +6912024-12-11✓消息与群组转发消息 PostImV1MessagesByMessageIdForward 6922024-09-06✓飞书人事创建部门 PostCorehrV1Departments @@ -1401,7 +1401,7 @@ GetCorehrV1LocationsByLocationId 7012024-12-06✓飞书人事批量分页查询地点信息 GetCorehrV1Locations -7022024-09-25✓消息与群组合并转发消息 +7022024-12-11✓消息与群组合并转发消息 PostImV1MessagesMergeForward 7032024-11-27✓飞书人事（企业版）通过公司 ID 批量获取公司信息 PostCorehrV2CompaniesBatchGet @@ -1445,7 +1445,7 @@ DeleteCorehrV1JobsByJobId 7232024-09-13✓飞书人事更新职务 PatchCorehrV1JobsByJobId -7242024-10-08✓消息与群组获取会话历史消息 +7242024-12-11✓消息与群组获取会话历史消息 GetImV1Messages 7252024-09-13✓飞书人事（企业版）查询单个职务 GetCorehrV2JobsByJobId @@ -1489,7 +1489,7 @@ PatchCorehrV2ProbationAssessmentsByAssessmentId 7452024-02-06✓飞书人事（企业版）删除试用期考核信息 DeleteCorehrV2ProbationAssessmentsByAssessmentId -7462024-09-25✓消息与群组获取指定消息的内容 +7462024-12-11✓消息与群组获取指定消息的内容 GetImV1MessagesByMessageId 7472024-03-07✓飞书人事获取异动原因列表 GetCorehrV1TransferReasonsQuery @@ -1537,7 +1537,7 @@ PatchImV1MessagesByMessageIdUrgentSms 7692024-09-10✓招聘新建职位 PostHireV1JobsCombinedCreate -7702024-01-22✓招聘获取职位信息 +7702024-12-11✓招聘获取职位信息 GetHireV1JobsByJobId 7712024-08-29✓招聘获取职位设置 GetHireV1JobsByJobIdConfig @@ -1551,7 +1551,7 @@ PostHireV1JobRequirements 7762024-11-26✓招聘获取招聘需求信息 PostHireV1JobRequirementsSearch -7772024-11-26✓招聘获取招聘需求列表 +7772024-12-11✓招聘获取招聘需求列表 GetHireV1JobRequirements 7782024-11-26✓招聘更新招聘需求 PutHireV1JobRequirementsByJobRequirementId @@ -1595,15 +1595,15 @@ PostHireV1TalentsBatchGetId 7982024-08-28✓招聘获取人才字段 GetHireV1TalentObjectsQuery -7992024-06-26✓招聘获取人才信息 V1 +7992024-12-11✓招聘获取人才信息 GetHireV1TalentsByTalentId 8002024-08-09✓招聘创建投递 PostHireV1Applications 8012024-07-10✓招聘终止投递 PostHireV1ApplicationsByApplicationIdTerminate -8022024-08-23✓消息与群组批量撤回消息 +8022024-12-11✓消息与群组批量撤回消息 DeleteImV1BatchMessagesByBatchMessageId -8032024-06-26✓招聘获取投递信息 +8032024-12-11✓招聘获取投递信息 GetHireV1ApplicationsByApplicationId 8042024-08-19✓招聘获取投递列表 GetHireV1Applications @@ -1617,13 +1617,13 @@ PostHireV1Offers 8092024-12-03✓招聘更新 Offer 信息 PutHireV1OffersByOfferId -8102024-12-03✓招聘获取 Offer 信息 +8102024-12-11✓招聘获取 Offer 信息 GetHireV1ApplicationsByApplicationIdOffer 8112024-12-03✓招聘获取 Offer 详情 GetHireV1OffersByOfferId -8122024-07-11✓招聘获取 Offer 列表 +8122024-12-11✓招聘获取 Offer 列表 GetHireV1Offers -8132024-08-23✓消息与群组查询批量消息推送和阅读人数 +8132024-12-11✓消息与群组查询批量消息推送和阅读人数 GetImV1BatchMessagesByBatchMessageIdReadUser 8142024-09-05✓招聘更新 Offer 状态 PatchHireV1OffersByOfferIdOfferStatus @@ -1645,7 +1645,7 @@ PatchHireV1NotesByNoteId 8232024-07-12✓招聘获取备注 GetHireV1NotesByNoteId -8242024-08-23✓消息与群组查询批量消息整体进度 +8242024-12-11✓消息与群组查询批量消息整体进度 GetImV1BatchMessagesByBatchMessageIdGetProgress 8252024-07-10✓招聘获取备注列表 GetHireV1Notes @@ -1755,7 +1755,7 @@ PostPerformanceV1ReviewDatasQuery 8782023-10-25✓词典创建草稿 PostLingoV1Drafts -8792024-11-07✓消息与群组更新应用发送的消息卡片 +8792024-12-11✓消息与群组更新应用发送的消息卡片 PatchImV1MessagesByMessageId 8802023-10-25✓词典更新草稿 PutLingoV1DraftsByDraftId @@ -1911,7 +1911,7 @@ PutSheetsV2SpreadsheetsBySpreadsheetTokenProperties 9562022-03-03✓云文档[不推荐] 导入表格 PostSheetsV2Import -9572024-09-25✓消息与群组Pin 消息 +9572024-12-11✓消息与群组Pin 消息 PostImV1Pins 9582023-11-02✓云文档查询导入结果 GetSheetsV2ImportResult @@ -1933,7 +1933,7 @@ PostDrivePermissionMemberTransfer 9672022-07-18✓云文档获取云文档权限设置V2 PostDrivePermissionV2Public -9682024-09-25✓消息与群组移除 Pin 消息 +9682024-12-11✓消息与群组移除 Pin 消息 DeleteImV1PinsByMessageId 9692022-06-02✓招聘获取面试记录列表 GetHireV1ApplicationsByApplicationIdInterviews @@ -1955,7 +1955,7 @@ PostMeetingRoomBuildingCreate 9782022-07-20✓会议室更新建筑物 PostMeetingRoomBuildingUpdate -9792024-09-25✓消息与群组获取群内 Pin 消息 +9792024-12-11✓消息与群组获取群内 Pin 消息 GetImV1Pins 9802022-07-20✓会议室删除建筑物 PostMeetingRoomBuildingDelete @@ -2053,7 +2053,7 @@ GetCalendarV4CalendarsByCalendarIdEventsInstanceView 10272024-08-28✓招聘获取职位列表 GetHireV1Jobs -10282024-11-28✓多维表格查询记录 +10282024-12-11✓多维表格查询记录 PostBitableV1AppsByAppTokenTablesByTableIdRecordsSearch 10292024-01-26✓应用信息启停用应用 PutApplicationV6ApplicationsByAppIdManagement @@ -2115,7 +2115,7 @@ PatchCorehrV1PersonsByPersonId 10582024-05-14✓薪酬管理批量查询定调薪原因 GetCompensationV1ChangeReasons -10592024-08-22✓薪酬管理批量查询员工薪资档案 +10592024-12-10✓薪酬管理批量查询员工薪资档案 PostCompensationV1ArchivesQuery 10602024-05-14✓薪酬管理批量获取薪资项分类信息 GetCompensationV1ItemCategories @@ -2185,13 +2185,13 @@ PostPerformanceV2AdditionalInformationsImport 10932024-11-04✓招聘创建附件 PostHireV1Attachments -10942024-08-27✓招聘获取招聘官网下的职位广告列表 +10942024-12-11✓招聘获取招聘官网下的职位广告列表 GetHireV1WebsitesByWebsiteIdJobPosts 10952024-07-22✓招聘获取项目列表 GetHireV1Subjects 10962024-07-22✓招聘获取职能分类列表 GetHireV1JobFunctions -10972024-08-27✓招聘搜索招聘官网下的职位广告列表 +10972024-12-11✓招聘搜索招聘官网下的职位广告列表 PostHireV1WebsitesByWebsiteIdJobPostsSearch 10982024-08-28✓招聘创建人才 PostHireV1TalentsCombinedCreate @@ -2279,7 +2279,7 @@ PutHireV1TalentsByTalentIdExternalInfo 11402024-08-21✓招聘获取背调信息列表 GetHireV1BackgroundCheckOrders -11412024-08-30✓招聘获取人才面试信息 +11412024-12-11✓招聘获取人才面试信息 GetHireV1InterviewsGetByTalent 11422024-08-29✓招聘获取面试登记表列表 GetHireV1InterviewRegistrationSchemas @@ -2333,7 +2333,7 @@ PostHireV1ReferralsSearch 11672024-11-18✓招聘导入外部内推奖励 PostHireV1ExternalReferralRewards -11682024-08-09✓招聘获取面试评价表列表 +11682024-12-11✓招聘获取面试评价表列表 GetHireV1InterviewFeedbackForms 11692024-09-09✓招聘删除外部内推奖励 DeleteHireV1ExternalReferralRewardsByExternalReferralRewardId @@ -2459,7 +2459,7 @@ GetAilyV1SessionsByAilySessionIdRunsByRunId 12302024-10-18✓智能伙伴创建平台创建会话 PostAilyV1Sessions -12312024-10-18✓招聘获取人才标签信息列表 +12312024-12-11✓招聘获取人才标签信息列表 GetHireV1TalentTags 12322024-10-18✓招聘操作人才标签 PostHireV1TalentsByTalentIdTag @@ -2509,11 +2509,11 @@ GetDocsV1Content 12552024-11-18✓应用信息获取企业安装的应用 GetApplicationV6Applications -12562024-12-02✓飞书人事（企业版）根据流程 ID 查询组织架构调整记录 +12562024-12-11✓飞书人事（企业版）根据流程 ID 查询组织架构调整记录 GetCorehrV2ApprovalGroupsByProcessId -12572024-12-02✓飞书人事（企业版）批量查询部门调整内容 +12572024-12-11✓飞书人事（企业版）批量查询部门调整内容 PostCorehrV2ApprovalGroupsOpenQueryDepartmentChangeListByIds -12582024-12-02✓飞书人事（企业版）批量查询人员调整内容 +12582024-12-11✓飞书人事（企业版）批量查询人员调整内容 PostCorehrV2ApprovalGroupsOpenQueryJobChangeListByIds 12592024-11-21✓考勤打卡查询考勤组下所有成员 GetAttendanceV1GroupsByGroupIdListUser @@ -2525,44 +2525,62 @@ PostCorehrV2OffboardingsRevoke 12632024-11-29✓飞书低代码平台发起流程 PostApaasV1ApplicationsByNamespaceFlowsByFlowIdExecute -12642024-12-03新增招聘批量加入/移除人才库中人才 +12642024-12-03✓招聘批量加入/移除人才库中人才 PostHireV1TalentPoolsByTalentPoolIdBatchChangeTalentPool -12652024-12-04新增招聘获取职位详情 +12652024-12-04✓招聘获取职位详情 GetHireV1JobsByJobIdGetDetail -12662024-12-03新增招聘获取投递详情 +12662024-12-03✓招聘获取投递详情 GetHireV1ApplicationsByApplicationIdGetDetail -12672024-12-03新增招聘查询外部面试列表 +12672024-12-03✓招聘查询外部面试列表 PostHireV1ExternalInterviewsBatchQuery -12682024-12-03新增招聘更新外部背调 +12682024-12-03✓招聘更新外部背调 PutHireV1ExternalBackgroundChecksByExternalBackgroundCheckId -12692024-12-03新增招聘创建外部 Offer +12692024-12-03✓招聘创建外部 Offer PostHireV1ExternalOffers -12702024-12-03新增招聘删除外部面试 +12702024-12-03✓招聘删除外部面试 DeleteHireV1ExternalInterviewsByExternalInterviewId -12712024-12-03新增招聘更新外部面试 +12712024-12-03✓招聘更新外部面试 PutHireV1ExternalInterviewsByExternalInterviewId -12722024-12-03新增招聘查询外部背调列表 +12722024-12-03✓招聘查询外部背调列表 PostHireV1ExternalBackgroundChecksBatchQuery -12732024-12-03新增招聘删除外部背调 +12732024-12-03✓招聘删除外部背调 DeleteHireV1ExternalBackgroundChecksByExternalBackgroundCheckId -12742024-12-03新增招聘查询外部 Offer 列表 +12742024-12-03✓招聘查询外部 Offer 列表 PostHireV1ExternalOffersBatchQuery -12752024-12-03新增招聘删除外部 Offer +12752024-12-03✓招聘删除外部 Offer DeleteHireV1ExternalOffersByExternalOfferId -12762024-12-03新增招聘更新外部 Offer +12762024-12-03✓招聘更新外部 Offer PutHireV1ExternalOffersByExternalOfferId -12772024-12-03新增招聘禁用/取消禁用猎头 +12772024-12-03✓招聘禁用/取消禁用猎头 PostHireV1AgenciesOperateAgencyAccount -12782024-12-03新增招聘查询猎头供应商下猎头列表 +12782024-12-03✓招聘查询猎头供应商下猎头列表 PostHireV1AgenciesGetAgencyAccount -12792024-12-03新增招聘搜索猎头供应商列表 +12792024-12-03✓招聘搜索猎头供应商列表 PostHireV1AgenciesBatchQuery -12802024-12-04新增招聘加入/移除屏蔽名单 +12802024-12-04✓招聘加入/移除屏蔽名单 PostHireV1TalentBlocklistChangeTalentBlock -12812024-12-03新增招聘启用内推账户 +12812024-12-03✓招聘启用内推账户 PostHireV1ReferralAccountEnable -12822024-12-03新增招聘查询内推账户 +12822024-12-03✓招聘查询内推账户 GetHireV1ReferralAccountGetAccountAssets -12832024-12-04新增招聘将人才从指定文件夹移除 +12832024-12-04✓招聘将人才从指定文件夹移除 PostHireV1TalentsRemoveToFolder +12842024-12-11新增招聘获取面试评价详细信息（新版） +GetHireV2InterviewRecordsByInterviewRecordId +12852024-12-11新增招聘批量获取面试评价详细信息（新版） +GetHireV2InterviewRecords +12862024-12-09新增飞书人事（企业版）批量删除填报行 +PostCorehrV2ReportDetailRowBatchDelete +12872024-12-09新增飞书人事（企业版）批量创建/更新填报行 +PostCorehrV2ReportDetailRowBatchSave +12882024-12-09新增飞书人事（企业版）批量删除明细行 +PostCorehrV2WorkforcePlanDetailRowBatchDelete +12892024-12-09新增飞书人事（企业版）批量创建/更新明细行 +PostCorehrV2WorkforcePlanDetailRowBatchSave +12902024-12-10新增考勤打卡创建或修改临时排班 +PostAttendanceV1UserDailyShiftsBatchCreateTemp +12912024-12-11新增多维表格列出自动化流程 +GetBitableV1AppsByAppTokenWorkflows +12922024-12-11新增多维表格更新自动化流程状态 +PutBitableV1AppsByAppTokenWorkflowsByWorkflowId diff --git a/UserAccessList.md b/UserAccessList.md index 244de8be..3fd2f6c2 100644 --- a/UserAccessList.md +++ b/UserAccessList.md @@ -113,7 +113,7 @@ PatchSheetsV3SpreadsheetsBySpreadsheetTokenSheetsBySheetIdFilterViewsByFilterViewId 572024-07-31✓云文档删除筛选视图 DeleteSheetsV3SpreadsheetsBySpreadsheetTokenSheetsBySheetIdFilterViewsByFilterViewId -582024-09-25✓消息与群组撤回消息 +582024-12-11✓消息与群组撤回消息 DeleteImV1MessagesByMessageId 592024-07-31✓云文档获取筛选条件 GetSheetsV3SpreadsheetsBySpreadsheetTokenSheetsBySheetIdFilterViewsByFilterViewIdConditionsByConditionId @@ -135,7 +135,7 @@ DeleteSheetsV2SpreadsheetsBySpreadsheetTokenProtectedRangeBatchDel 682024-08-14✓云文档查询下拉列表设置 GetSheetsV2SpreadsheetsBySpreadsheetTokenDataValidation -692024-11-07✓消息与群组更新应用发送的消息卡片 +692024-12-11✓消息与群组更新应用发送的消息卡片 PatchImV1MessagesByMessageId 702024-08-14✓云文档设置下拉列表 PostSheetsV2SpreadsheetsBySpreadsheetTokenDataValidation @@ -219,13 +219,13 @@ PutBitableV1AppsByAppTokenTablesByTableIdRecordsByRecordId 1102024-11-18✓多维表格删除记录 DeleteBitableV1AppsByAppTokenTablesByTableIdRecordsByRecordId -1112024-11-28✓多维表格新增多条记录 +1112024-12-11✓多维表格新增多条记录 PostBitableV1AppsByAppTokenTablesByTableIdRecordsBatchCreate 1122024-11-28✓多维表格更新多条记录 PostBitableV1AppsByAppTokenTablesByTableIdRecordsBatchUpdate 1132024-09-14✓通讯录获取单个用户信息 GetContactV3UsersByUserId -1142024-09-25✓消息与群组Pin 消息 +1142024-12-11✓消息与群组Pin 消息 PostImV1Pins 1152024-11-18✓多维表格删除多条记录 PostBitableV1AppsByAppTokenTablesByTableIdRecordsBatchDelete @@ -247,7 +247,7 @@ PutBitableV1AppsByAppTokenRolesByRoleId 1242023-07-28✓多维表格批量删除协作者 PostBitableV1AppsByAppTokenRolesByRoleIdMembersBatchDelete -1252024-09-25✓消息与群组移除 Pin 消息 +1252024-12-11✓消息与群组移除 Pin 消息 DeleteImV1PinsByMessageId 1262023-07-28✓多维表格批量新增协作者 PostBitableV1AppsByAppTokenRolesByRoleIdMembersBatchCreate @@ -269,7 +269,7 @@ DeleteWikiV2SpacesBySpaceIdMembersByMemberId 1352024-07-31✓云文档更新知识空间设置 PutWikiV2SpacesBySpaceIdSetting -1362024-09-25✓消息与群组获取群内 Pin 消息 +1362024-12-11✓消息与群组获取群内 Pin 消息 GetImV1Pins 1372024-12-03✓云文档创建知识空间节点 PostWikiV2SpacesBySpaceIdNodes @@ -857,7 +857,7 @@ PostDriveV1MetasBatchQuery 4292024-12-03✓云文档[不推荐] 新建文件 PostDriveExplorerV2FileByFolderToken -4302024-10-10✓云文档复制文件 +4302024-12-12✓云文档复制文件 PostDriveV1FilesByFileTokenCopy 4312024-09-20✓云文档移动文件或文件夹 PostDriveV1FilesByFileTokenMove @@ -899,7 +899,7 @@ PostDriveV1FilesUploadPrepare 4502024-05-29✓云文档分片上传文件-上传分片 PostDriveV1FilesUploadPart -4512024-11-28✓云文档分片上传文件-完成上传 +4512024-12-10✓云文档分片上传文件-完成上传 PostDriveV1FilesUploadFinish 4522024-09-05✓云文档下载文件 GetDriveV1FilesByFileTokenDownload @@ -987,7 +987,7 @@ DeleteAcsV1VisitorsByVisitorId 4942024-07-16✓日历查询日程视图 GetCalendarV4CalendarsByCalendarIdEventsInstanceView -4952024-11-28✓多维表格查询记录 +4952024-12-11✓多维表格查询记录 PostBitableV1AppsByAppTokenTablesByTableIdRecordsSearch 4962024-02-27✓画板获取所有节点 GetBoardV1WhiteboardsByWhiteboardIdNodes @@ -1013,7 +1013,7 @@ GetAilyV1SessionsByAilySessionIdRunsByRunId 5072024-10-18✓智能伙伴创建平台创建会话 PostAilyV1Sessions -5082024-08-22✓薪酬管理批量查询员工薪资档案 +5082024-12-10✓薪酬管理批量查询员工薪资档案 PostCompensationV1ArchivesQuery 5092024-10-09✓飞书人事（企业版）添加人员 PostCorehrV2Employees @@ -1043,7 +1043,7 @@ GetWikiV2SpacesBySpaceIdMembers 5222024-08-02✓画板获取画板缩略图片 GetBoardV1WhiteboardsByWhiteboardIdDownloadAsImage -5232024-12-04✓邮箱发送邮件 +5232024-12-09✓邮箱发送邮件 PostMailV1UserMailboxesByUserMailboxIdMessagesSend 5242024-08-30删除公司圈查询帖子信息 GetMomentsV1PostsByPostId @@ -1075,4 +1075,14 @@ GetDocsV1Content 5382024-11-21✓考勤打卡查询考勤组下所有成员 GetAttendanceV1GroupsByGroupIdListUser +5392024-12-11新增招聘获取面试评价详细信息（新版） +GetHireV2InterviewRecordsByInterviewRecordId +5402024-12-11新增招聘批量获取面试评价详细信息（新版） +GetHireV2InterviewRecords +5412024-12-10新增考勤打卡创建或修改临时排班 +PostAttendanceV1UserDailyShiftsBatchCreateTemp +5422024-12-11新增多维表格列出自动化流程 +GetBitableV1AppsByAppTokenWorkflows +5432024-12-11新增多维表格更新自动化流程状态 +PutBitableV1AppsByAppTokenWorkflowsByWorkflowId diff --git a/src/Ai/PostDocumentAiV1TaxiInvoiceRecognizeResponseDto.cs b/src/Ai/PostDocumentAiV1TaxiInvoiceRecognizeResponseDto.cs index 22f5664d..3842ba3c 100644 --- a/src/Ai/PostDocumentAiV1TaxiInvoiceRecognizeResponseDto.cs +++ b/src/Ai/PostDocumentAiV1TaxiInvoiceRecognizeResponseDto.cs @@ -57,6 +57,16 @@ public record TaxiEntity /// distance：里程 /// start_date：日期 /// total_amount：出租车价格 + /// invoice_code：发票代码 + /// invoice_no：发票号码 + /// price：单价 + /// dispatch_fee：电召费 + /// additional_fee：附加费 + /// is_sealed：是否盖章 + /// seller_name_in_seal：印章内销售方名称 + /// seller_taxpayer_no_in_seal：印章内销售方税号 + /// title_trial：发票名称 + /// invoice_special_seal：印章名称 /// /// [JsonPropertyName("type")] diff --git a/src/Ai/PostDocumentAiV1TrainInvoiceRecognizeResponseDto.cs b/src/Ai/PostDocumentAiV1TrainInvoiceRecognizeResponseDto.cs index 912b1cd8..d6988cb6 100644 --- a/src/Ai/PostDocumentAiV1TrainInvoiceRecognizeResponseDto.cs +++ b/src/Ai/PostDocumentAiV1TrainInvoiceRecognizeResponseDto.cs @@ -59,6 +59,12 @@ public record TrainEntity /// ticket_num：车票编号 /// total_amount：价格 /// time：出发时间 + /// price：金额 + /// seat_num：座位号 + /// seat_cls：座位类型 + /// id_num：身份证号 + /// sale_num：售卖号 + /// sale_station：售卖车站 /// /// [JsonPropertyName("type")] diff --git a/src/Ai/PostDocumentAiV1VatInvoiceRecognizeResponseDto.cs b/src/Ai/PostDocumentAiV1VatInvoiceRecognizeResponseDto.cs index c2b228ae..028318b1 100644 --- a/src/Ai/PostDocumentAiV1VatInvoiceRecognizeResponseDto.cs +++ b/src/Ai/PostDocumentAiV1VatInvoiceRecognizeResponseDto.cs @@ -4,7 +4,7 @@ // Created : 2024-06-24 // // Last Modified By : yxr -// Last Modified On : 2024-06-24 +// Last Modified On : 2024-12-12 // ************************************************************************ // // MIT @@ -69,6 +69,16 @@ public record VatEntity /// seller_address_phone：销售方地址&电话 /// seller_account：销售方开户行&账号 /// payee：收款人 + /// invoice_date：开票日期 + /// password_area：密码区 + /// remarks：备注 + /// reviewer：复核人 + /// drawer：开票人 + /// is_sealed：是否盖章 + /// seller_name_in_seal：印章内销售方名称 + /// seller_taxpayer_no_in_seal：印章内销售方纳税人识别号 + /// invoice_special_seal：印章名称 + /// machine_num：机器编号 /// /// [JsonPropertyName("type")] @@ -81,6 +91,37 @@ public record VatEntity /// [JsonPropertyName("value")] public string? Value { get; set; } + + /// + /// 识别出的票据详细信息 + /// 必填：否 + /// 最大长度：100000 + /// 最小长度：0 + /// + [JsonPropertyName("items")] + public KvEntity[][]? Items { get; set; } + + /// + /// 识别出的票据详细信息 + /// + public record KvEntity + { + /// + /// 识别的实体类型 + /// 必填：否 + /// 示例值：entry_name + /// + [JsonPropertyName("type")] + public string? Type { get; set; } + + /// + /// 识别出字段的文本信息 + /// 必填：否 + /// 示例值：餐饮服务 + /// + [JsonPropertyName("value")] + public string? Value { get; set; } + } } } } diff --git a/src/Approval.Events/ApprovalCcEventBodyDto.cs b/src/Approval.Events/ApprovalCcEventBodyDto.cs index b1ac4c2b..87b85275 100644 --- a/src/Approval.Events/ApprovalCcEventBodyDto.cs +++ b/src/Approval.Events/ApprovalCcEventBodyDto.cs @@ -65,7 +65,7 @@ public record ApprovalCcEventBodyDto() : EventBodyDto("approval_cc") /// 操作人 ID（当 task 为自动通过类型时，user_id 为空） /// [JsonPropertyName("user_id")] - public long UserId { get; set; } + public string? UserId { get; set; } /// /// diff --git a/src/Approval.Events/ApprovalTaskEventBodyDto.cs b/src/Approval.Events/ApprovalTaskEventBodyDto.cs index 6a2d0fdb..502307fd 100644 --- a/src/Approval.Events/ApprovalTaskEventBodyDto.cs +++ b/src/Approval.Events/ApprovalTaskEventBodyDto.cs @@ -58,7 +58,7 @@ public record ApprovalTaskEventBodyDto() : EventBodyDto("approval_task") /// 事件发生时间 /// [JsonPropertyName("operate_time")] - public long OperateTime { get; set; } + public string? OperateTime { get; set; } /// /// 审批任务 ID @@ -70,7 +70,7 @@ public record ApprovalTaskEventBodyDto() : EventBodyDto("approval_task") /// 操作人 ID（当 task 为自动通过类型时，user_id 为空） /// [JsonPropertyName("user_id")] - public long UserId { get; set; } + public string? UserId { get; set; } /// /// 任务状态 diff --git a/src/Attendance/PostAttendanceV1UserDailyShiftsBatchCreateTempBodyDto.cs b/src/Attendance/PostAttendanceV1UserDailyShiftsBatchCreateTempBodyDto.cs new file mode 100644 index 00000000..ed68b839 --- /dev/null +++ b/src/Attendance/PostAttendanceV1UserDailyShiftsBatchCreateTempBodyDto.cs @@ -0,0 +1,110 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-12-12 +// +// Last Modified By : yxr +// Last Modified On : 2024-12-12 +// ************************************************************************ +// +// MIT +// +// 创建或修改临时排班 请求体 +// ************************************************************************ +namespace FeishuNetSdk.Attendance; +/// +/// 创建或修改临时排班 请求体 +/// 可在排班表上创建或修改临时班次，并用于排班。目前支持按日期对一位或多位人员进行排临时班次。 +/// 临时排班为付费功能，如需使用请联系您的客户经理。 +/// 接口ID：7446612629576892419 +/// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_daily_shift/batch_create_temp +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fattendance-v1%2fuser_daily_shift%2fbatch_create_temp +/// +public record PostAttendanceV1UserDailyShiftsBatchCreateTempBodyDto +{ + /// + /// 临时班表信息列表（数量限制50以内） + /// 必填：是 + /// 最大长度：50 + /// 最小长度：0 + /// + [JsonPropertyName("user_tmp_daily_shifts")] + public UserTmpDailyShift[] UserTmpDailyShifts { get; set; } = Array.Empty(); + + /// + /// 临时班表信息列表（数量限制50以内） + /// + public record UserTmpDailyShift + { + /// + /// 考勤组 ID，获取方式：1）[创建或修改考勤组](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/group/create) 2）[按名称查询考勤组](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/group/search) 3）[获取打卡结果](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_task/query) + /// 必填：是 + /// 示例值：6737202939523236110 + /// + [JsonPropertyName("group_id")] + public string GroupId { get; set; } = string.Empty; + + /// + /// 用户 ID，与employee_type对应 + /// 必填：是 + /// 示例值：abd754f7 + /// + [JsonPropertyName("user_id")] + public string UserId { get; set; } = string.Empty; + + /// + /// 日期，格式：yyyymmdd，如20240120 + /// 必填：是 + /// 示例值：20240120 + /// + [JsonPropertyName("date")] + public int Date { get; set; } + + /// + /// 班次名称 + /// 必填：是 + /// 示例值：临时早班 + /// + [JsonPropertyName("shift_name")] + public string ShiftName { get; set; } = string.Empty; + + /// + /// 打卡规则 + /// 必填：是 + /// 最大长度：6 + /// 最小长度：0 + /// + [JsonPropertyName("punch_time_simple_rules")] + public PunchTimeSimpleRule[] PunchTimeSimpleRules { get; set; } = Array.Empty(); + + /// + /// 打卡规则 + /// + public record PunchTimeSimpleRule + { + /// + /// 上班时间，格式HH：MM + /// 必填：是 + /// 示例值：9：00 + /// + [JsonPropertyName("on_time")] + public string OnTime { get; set; } = string.Empty; + + /// + /// 下班时间，格式HH：MM。如需表示次日2点，则填入"26：00" + /// 必填：是 + /// 示例值：18：00 + /// + [JsonPropertyName("off_time")] + public string OffTime { get; set; } = string.Empty; + } + } + + /// + /// 操作人uid，与employee_type对应 + /// 必填：否 + /// 示例值：dd31248a + /// + [JsonPropertyName("operator_id")] + public string? OperatorId { get; set; } +} diff --git a/src/Attendance/PostAttendanceV1UserDailyShiftsBatchCreateTempResponseDto.cs b/src/Attendance/PostAttendanceV1UserDailyShiftsBatchCreateTempResponseDto.cs new file mode 100644 index 00000000..1df48d27 --- /dev/null +++ b/src/Attendance/PostAttendanceV1UserDailyShiftsBatchCreateTempResponseDto.cs @@ -0,0 +1,102 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-12-12 +// +// Last Modified By : yxr +// Last Modified On : 2024-12-12 +// ************************************************************************ +// +// MIT +// +// 创建或修改临时排班 响应体 +// ************************************************************************ +namespace FeishuNetSdk.Attendance; +/// +/// 创建或修改临时排班 响应体 +/// 可在排班表上创建或修改临时班次，并用于排班。目前支持按日期对一位或多位人员进行排临时班次。 +/// 临时排班为付费功能，如需使用请联系您的客户经理。 +/// 接口ID：7446612629576892419 +/// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_daily_shift/batch_create_temp +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fattendance-v1%2fuser_daily_shift%2fbatch_create_temp +/// +public record PostAttendanceV1UserDailyShiftsBatchCreateTempResponseDto +{ + /// + /// 临时班表信息列表 + /// 必填：否 + /// 最大长度：50 + /// 最小长度：0 + /// + [JsonPropertyName("user_tmp_daily_shifts")] + public UserTmpDailyShift[]? UserTmpDailyShifts { get; set; } + + /// + /// 临时班表信息列表 + /// + public record UserTmpDailyShift + { + /// + /// 考勤组 ID，可用于[按 ID 查询考勤组](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/group/get) + /// 必填：是 + /// 示例值：6737202939523236110 + /// + [JsonPropertyName("group_id")] + public string GroupId { get; set; } = string.Empty; + + /// + /// 用户 ID，与employee_type对应 + /// 必填：是 + /// 示例值：abd754f7 + /// + [JsonPropertyName("user_id")] + public string UserId { get; set; } = string.Empty; + + /// + /// 日期 + /// 必填：是 + /// 示例值：20240120 + /// + [JsonPropertyName("date")] + public int Date { get; set; } + + /// + /// 班次名称 + /// 必填：是 + /// 示例值：临时早班 + /// + [JsonPropertyName("shift_name")] + public string ShiftName { get; set; } = string.Empty; + + /// + /// 打卡规则 + /// 必填：是 + /// 最大长度：6 + /// 最小长度：0 + /// + [JsonPropertyName("punch_time_simple_rules")] + public PunchTimeSimpleRule[] PunchTimeSimpleRules { get; set; } = Array.Empty(); + + /// + /// 打卡规则 + /// + public record PunchTimeSimpleRule + { + /// + /// 上班时间 + /// 必填：是 + /// 示例值：9：00 + /// + [JsonPropertyName("on_time")] + public string OnTime { get; set; } = string.Empty; + + /// + /// 下班时间 + /// 必填：是 + /// 示例值：18：00 + /// + [JsonPropertyName("off_time")] + public string OffTime { get; set; } = string.Empty; + } + } +} diff --git a/src/Auth/PostAuthenV1AccessTokenBodyDto.cs b/src/Auth/PostAuthenV1AccessTokenBodyDto.cs index 2e8b6a5f..cd30f1fe 100644 --- a/src/Auth/PostAuthenV1AccessTokenBodyDto.cs +++ b/src/Auth/PostAuthenV1AccessTokenBodyDto.cs @@ -27,7 +27,7 @@ public record PostAuthenV1AccessTokenBodyDto /// 示例值：authorization_code /// [JsonPropertyName("grant_type")] - public string GrantType { get; set; } = string.Empty; + public string GrantType { get; } = "authorization_code"; /// /// 登录预授权码，调用[获取登录预授权码](https://open.feishu.cn/document/ukTMukTMukTM/ukzN4UjL5cDO14SO3gTN)接口获取 diff --git a/src/Auth/PostAuthenV1OidcAccessTokenBodyDto.cs b/src/Auth/PostAuthenV1OidcAccessTokenBodyDto.cs index 27219c6e..3592fb35 100644 --- a/src/Auth/PostAuthenV1OidcAccessTokenBodyDto.cs +++ b/src/Auth/PostAuthenV1OidcAccessTokenBodyDto.cs @@ -29,7 +29,7 @@ public record PostAuthenV1OidcAccessTokenBodyDto /// 示例值：authorization_code /// [JsonPropertyName("grant_type")] - public string GrantType { get; set; } = string.Empty; + public string GrantType { get; } = "authorization_code"; /// /// 登录预授权码，调用[登录预授权码](https://open.feishu.cn/document/common-capabilities/sso/api/obtain-oauth-code) 获取code diff --git a/src/Auth/PostAuthenV1OidcRefreshAccessTokenBodyDto.cs b/src/Auth/PostAuthenV1OidcRefreshAccessTokenBodyDto.cs index a44da87e..3ed6fc91 100644 --- a/src/Auth/PostAuthenV1OidcRefreshAccessTokenBodyDto.cs +++ b/src/Auth/PostAuthenV1OidcRefreshAccessTokenBodyDto.cs @@ -29,7 +29,7 @@ public record PostAuthenV1OidcRefreshAccessTokenBodyDto /// 示例值：refresh_token /// [JsonPropertyName("grant_type")] - public string GrantType { get; set; } = string.Empty; + public string GrantType { get; } = "refresh_token"; /// /// 刷新和获取user_access_token接口均返回 `refresh_token`，**每次请求，请注意使用最新获取到的`refresh_token`** diff --git a/src/Auth/PostAuthenV1RefreshAccessTokenBodyDto.cs b/src/Auth/PostAuthenV1RefreshAccessTokenBodyDto.cs index 43ed2e13..d57f94e4 100644 --- a/src/Auth/PostAuthenV1RefreshAccessTokenBodyDto.cs +++ b/src/Auth/PostAuthenV1RefreshAccessTokenBodyDto.cs @@ -27,7 +27,7 @@ public record PostAuthenV1RefreshAccessTokenBodyDto /// 示例值：refresh_token /// [JsonPropertyName("grant_type")] - public string GrantType { get; set; } = string.Empty; + public string GrantType { get; } = "refresh_token"; /// /// 刷新和获取user_access_token接口均返回 `refresh_token`，**每次请求，请注意使用最新获取到的`refresh_token`** diff --git a/src/Base/GetBitableV1AppsByAppTokenWorkflowsResponseDto.cs b/src/Base/GetBitableV1AppsByAppTokenWorkflowsResponseDto.cs new file mode 100644 index 00000000..9cb49295 --- /dev/null +++ b/src/Base/GetBitableV1AppsByAppTokenWorkflowsResponseDto.cs @@ -0,0 +1,60 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-12-12 +// +// Last Modified By : yxr +// Last Modified On : 2024-12-12 +// ************************************************************************ +// +// MIT +// +// 列出自动化流程 响应体 +// ************************************************************************ +namespace FeishuNetSdk.Base; +/// +/// 列出自动化流程 响应体 +/// 该接口用于列出多维表格的自动化流程。 +/// 接口ID：7447033368182571009 +/// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-workflow/list +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fbitable-v1%2fapp-workflow%2flist +/// +public record GetBitableV1AppsByAppTokenWorkflowsResponseDto +{ + /// + /// 自动化流程信息 + /// 必填：是 + /// + [JsonPropertyName("workflows")] + public AppWorkflow[] Workflows { get; set; } = Array.Empty(); + + /// + /// 自动化流程信息 + /// + public record AppWorkflow + { + /// + /// 自动化流程的 ID + /// 必填：是 + /// 示例值：72934597xxxx9998484 + /// + [JsonPropertyName("workflow_id")] + public string WorkflowId { get; set; } = string.Empty; + + /// + /// 自动化流程的状态 + /// 必填：否 + /// 示例值：Enable + /// + [JsonPropertyName("status")] + public string? Status { get; set; } + + /// + /// 自动化流程的名称 + /// 必填：否 + /// 示例值：流程 1 + /// + [JsonPropertyName("title")] + public string? Title { get; set; } + } +} diff --git a/src/Base/PostBitableV1AppsByAppTokenTablesByTableIdRecordsBatchCreateBodyDto.cs b/src/Base/PostBitableV1AppsByAppTokenTablesByTableIdRecordsBatchCreateBodyDto.cs index 8eab0326..190e043b 100644 --- a/src/Base/PostBitableV1AppsByAppTokenTablesByTableIdRecordsBatchCreateBodyDto.cs +++ b/src/Base/PostBitableV1AppsByAppTokenTablesByTableIdRecordsBatchCreateBodyDto.cs @@ -48,7 +48,7 @@ public record AppTableRecord /// - 日期：填写毫秒级时间戳 /// - 复选框：填写 true 或 false /// - 条码 - /// - 人员：填写用户的 open_id、union_id 或 user_id，类型需要与 user_id_type 指定的类型一致 + /// - 人员：：填写用户的[open_id](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid)、[union_id](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-union-id) 或 [user_id](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-user-id)，类型需要与 user_id_type 指定的类型一致 /// - 电话号码：填写文本内容 /// - 超链接：参考以下示例，text 为文本值，link 为 URL 链接 /// - 附件：填写附件 token，需要先调用[上传素材](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/upload_all)或[分片上传素材](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/upload_prepare)接口将附件上传至该多维表格中 diff --git a/src/Base/PostBitableV1AppsByAppTokenTablesByTableIdRecordsSearchBodyDto.cs b/src/Base/PostBitableV1AppsByAppTokenTablesByTableIdRecordsSearchBodyDto.cs index 873f0344..8d6b7ecc 100644 --- a/src/Base/PostBitableV1AppsByAppTokenTablesByTableIdRecordsSearchBodyDto.cs +++ b/src/Base/PostBitableV1AppsByAppTokenTablesByTableIdRecordsSearchBodyDto.cs @@ -94,7 +94,7 @@ public record Sort public record FilterInfo { /// - /// 表示条件之间的逻辑连接词 + /// 表示条件之间的逻辑连接词，该字段必填，请忽略左侧必填列的否 /// 必填：否 /// 示例值：and /// 最大长度：10 diff --git a/src/Base/PutBitableV1AppsByAppTokenWorkflowsByWorkflowIdBodyDto.cs b/src/Base/PutBitableV1AppsByAppTokenWorkflowsByWorkflowIdBodyDto.cs new file mode 100644 index 00000000..7d5efae7 --- /dev/null +++ b/src/Base/PutBitableV1AppsByAppTokenWorkflowsByWorkflowIdBodyDto.cs @@ -0,0 +1,33 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-12-12 +// +// Last Modified By : yxr +// Last Modified On : 2024-12-12 +// ************************************************************************ +// +// MIT +// +// 更新自动化流程状态 请求体 +// ************************************************************************ +namespace FeishuNetSdk.Base; +/// +/// 更新自动化流程状态 请求体 +/// 开启或关闭自动化流程。 +/// 接口ID：7447033368182587393 +/// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-workflow/update +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fbitable-v1%2fapp-workflow%2fupdate +/// +public record PutBitableV1AppsByAppTokenWorkflowsByWorkflowIdBodyDto +{ + /// + /// 自动化状态。可选值： + /// - Enable：开启自动化流程 + /// - Disable：关闭自动化流程 + /// 必填：是 + /// 示例值：Enable + /// + [JsonPropertyName("status")] + public string Status { get; set; } = string.Empty; +} diff --git a/src/Ccm/PostDriveV1FilesByFileTokenCopyBodyDto.cs b/src/Ccm/PostDriveV1FilesByFileTokenCopyBodyDto.cs index 92fce46f..7c1c5cd4 100644 --- a/src/Ccm/PostDriveV1FilesByFileTokenCopyBodyDto.cs +++ b/src/Ccm/PostDriveV1FilesByFileTokenCopyBodyDto.cs @@ -27,7 +27,7 @@ public record PostDriveV1FilesByFileTokenCopyBodyDto { /// /// 复制的新文件的名称 - /// **数据校验规则**：最大长度为 `256` 字符 + /// **数据校验规则**：最大长度为 `256` 字节 /// 必填：是 /// 示例值：Demo copy /// diff --git a/src/CompensationManagement/PostCompensationV1ArchivesQueryBodyDto.cs b/src/CompensationManagement/PostCompensationV1ArchivesQueryBodyDto.cs index 6cdb1c3f..fb25cfa8 100644 --- a/src/CompensationManagement/PostCompensationV1ArchivesQueryBodyDto.cs +++ b/src/CompensationManagement/PostCompensationV1ArchivesQueryBodyDto.cs @@ -4,7 +4,7 @@ // Created : 2024-06-24 // // Last Modified By : yxr -// Last Modified On : 2024-06-24 +// Last Modified On : 2024-12-12 // ************************************************************************ // // MIT @@ -30,6 +30,15 @@ public record PostCompensationV1ArchivesQueryBodyDto [JsonPropertyName("user_id_list")] public string[] UserIdList { get; set; } = Array.Empty(); + /// + /// 档案Tid列表 + /// 必填：否 + /// 最大长度：100 + /// 最小长度：1 + /// + [JsonPropertyName("tid_list")] + public string[]? TidList { get; set; } + /// /// 生效开始时间 /// 必填：否 diff --git a/src/CompensationManagement/PostCompensationV1ArchivesQueryResponseDto.cs b/src/CompensationManagement/PostCompensationV1ArchivesQueryResponseDto.cs index 7a346c24..52841f40 100644 --- a/src/CompensationManagement/PostCompensationV1ArchivesQueryResponseDto.cs +++ b/src/CompensationManagement/PostCompensationV1ArchivesQueryResponseDto.cs @@ -4,7 +4,7 @@ // Created : 2024-06-24 // // Last Modified By : yxr -// Last Modified On : 2024-06-24 +// Last Modified On : 2024-12-12 // ************************************************************************ // // MIT @@ -105,6 +105,14 @@ public record ArchiveDetail [JsonPropertyName("effective_date")] public string EffectiveDate { get; set; } = string.Empty; + /// + /// 失效时间 + /// 必填：否 + /// 示例值：2022-10-24 + /// + [JsonPropertyName("expiration_date")] + public string? ExpirationDate { get; set; } + /// /// 薪级薪等ID /// 必填：否 @@ -136,7 +144,7 @@ public record ArchiveItem public string ItemId { get; set; } = string.Empty; /// - /// 档案关联薪资项数值 + /// 档案关联薪酬项数值 /// 必填：是 /// 示例值：15000 /// @@ -144,7 +152,7 @@ public record ArchiveItem public string ItemResult { get; set; } = string.Empty; /// - /// 档案关联薪资项转正后数值 + /// 档案关联薪酬项转正后数值 /// 必填：否 /// 示例值：18000 /// diff --git a/src/Corehr/PostCorehrV2ReportDetailRowBatchDeleteBodyDto.cs b/src/Corehr/PostCorehrV2ReportDetailRowBatchDeleteBodyDto.cs new file mode 100644 index 00000000..0c70fcb7 --- /dev/null +++ b/src/Corehr/PostCorehrV2ReportDetailRowBatchDeleteBodyDto.cs @@ -0,0 +1,155 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-12-12 +// +// Last Modified By : yxr +// Last Modified On : 2024-12-12 +// ************************************************************************ +// +// MIT +// +// 批量删除填报行 请求体 +// ************************************************************************ +namespace FeishuNetSdk.Corehr; +/// +/// 批量删除填报行 请求体 +/// 批量删除填报行后，可在【设置-编制规划设置-编制规划XXX-集中填报】进行查看。 +/// 接口ID：7446337145820053508 +/// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/report_detail_row/batchDelete +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2freport_detail_row%2fbatchDelete +/// +public record PostCorehrV2ReportDetailRowBatchDeleteBodyDto +{ + /// + /// 编制规划id，可在「设置-编制规划设置-编制规划XXX-页面URL」中解析到。 + /// 必填：是 + /// 示例值：7430330781544564268 + /// + [JsonPropertyName("workforce_plan_id")] + public string WorkforcePlanId { get; set; } = string.Empty; + + /// + /// 集中填报id，可在「设置-编制规划设置-编制规划XXX-集中填报XXX」中解析到 + /// 必填：是 + /// 示例值：7430470688844023340 + /// + [JsonPropertyName("centralized_reporting_project_id")] + public string CentralizedReportingProjectId { get; set; } = string.Empty; + + /// + /// 集中填报的填报行数量应介于 1 至 5 个之间。 + /// 必填：是 + /// 最大长度：5 + /// 最小长度：1 + /// + [JsonPropertyName("items")] + public WorkforcePlanDetailRow[] Items { get; set; } = Array.Empty(); + + /// + /// 集中填报的填报行数量应介于 1 至 5 个之间。 + /// + public record WorkforcePlanDetailRow + { + /// + /// 集中填报的维度信息要和用户创建的维度匹配，即传入除自动匹配维度外的所有维度，不多不少。 + /// 通过「设置-编制规划设置-编制规划XXX」查看该编制规划有哪些维度。 + /// 自定义组织维度是否为自动匹配的维度则通过「设置-组织配置-自定义组织XXX-查看为组织设置自动匹配规则」，“是”代表该维度为自动匹配维度。 + /// 必填：是 + /// 最大长度：20 + /// 最小长度：1 + /// + [JsonPropertyName("dimensions")] + public DimensionEntity[] Dimensions { get; set; } = Array.Empty(); + + /// + /// 集中填报的维度信息要和用户创建的维度匹配，即传入除自动匹配维度外的所有维度，不多不少。 + /// 通过「设置-编制规划设置-编制规划XXX」查看该编制规划有哪些维度。 + /// 自定义组织维度是否为自动匹配的维度则通过「设置-组织配置-自定义组织XXX-查看为组织设置自动匹配规则」，“是”代表该维度为自动匹配维度。 + /// + public record DimensionEntity + { + /// + /// 维度key，可从下面列表中进行选择： + /// - "department"：部门。 + /// - "employee_type" ：人员类型。 + /// - "location"：地点。 + /// - "position" ：岗位。 + /// - "cost_center" ：成本中心/业务线。 + /// - "job_family" ：序列。 + /// - "job_level" ：职级。 + /// - "job" ：职务。 + /// 自定义组织： + /// - "custom_org_01" + /// - "custom_org_02" + /// - "custom_org_03" + /// - "custom_org_04" + /// - "custom_org_05" + /// 必填：是 + /// 示例值：department + /// + [JsonPropertyName("dimension_key")] + public string DimensionKey { get; set; } = string.Empty; + + /// + /// 维度value。 + /// - department：可从[查询部门](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get)获得。 + /// - location：可从[查询地点](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)获得。 + /// - cost_center：可从[查询成本中心](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)获得。 + /// - job：可从[查询职务](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)获得。 + /// - job_level：可从[查询职级](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)获得。 + /// - job_family：可从[查询序列](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)获得。 + /// - employee_type：可从[查询人员类型](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/employee_type_enum/list)获得。 + /// - position：岗位，功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// - custom_org_01：自定义组织，功能灰度中，有需要请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// - custom_org_02：自定义组织，功能灰度中，有需要请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// - custom_org_03：自定义组织，功能灰度中，有需要请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// - custom_org_04：自定义组织，功能灰度中，有需要请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// - custom_org_05：自定义组织，功能灰度中，有需要请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：是 + /// 示例值：7322790168290739756 + /// + [JsonPropertyName("dimension_value")] + public string DimensionValue { get; set; } = string.Empty; + } + + /// + /// 预估在职人数相关信息。可从「设置-编制规划设置-编制规划XXX-集中填报」查看预估在职人数的时间，如果不存在该字段说明用户创建时即没有允许填写该字段，批量删除填报行时则无需给该字段，如果存在，用户需要查看预估在职人数的日期，使用示例值格式进行传参。 + /// 必填：否 + /// 最大长度：15 + /// 最小长度：0 + /// + [JsonPropertyName("eai_details")] + public WorkforcePlanEaiDetail[]? EaiDetails { get; set; } + + /// + /// 预估在职人数相关信息。可从「设置-编制规划设置-编制规划XXX-集中填报」查看预估在职人数的时间，如果不存在该字段说明用户创建时即没有允许填写该字段，批量删除填报行时则无需给该字段，如果存在，用户需要查看预估在职人数的日期，使用示例值格式进行传参。 + /// + public record WorkforcePlanEaiDetail + { + /// + /// 预估在职人数的日期，和集中填报页面上显示的预估在职人数的日期一致，且格式要依照示例给定，若二者不匹配，则无法完成识别更新。 + /// 必填：否 + /// 示例值：2020-10-31 + /// + [JsonPropertyName("date")] + public string? Date { get; set; } + + /// + /// 预估在职人数应与创建编制规划时指定的小数位数相匹配，若不匹配，则无法更新。小数位查看方式：「设置-编制规划-编制规划XXX」查看预估在职人数的小数位数。 + /// 必填：否 + /// 示例值：10 + /// + [JsonPropertyName("estimated_active_individuals")] + public string? EstimatedActiveIndividuals { get; set; } + } + + /// + /// 编制规划值需与创建编制规划时指定的小数位数相匹配，若不匹配，则无法更新。小数位查看方式：「设置-编制规划-编制规划XXX」查看编制规划的小数位数。 + /// 必填：否 + /// 示例值：12 + /// + [JsonPropertyName("plan_value")] + public string? PlanValue { get; set; } + } +} diff --git a/src/Corehr/PostCorehrV2ReportDetailRowBatchSaveBodyDto.cs b/src/Corehr/PostCorehrV2ReportDetailRowBatchSaveBodyDto.cs new file mode 100644 index 00000000..3b7a3c91 --- /dev/null +++ b/src/Corehr/PostCorehrV2ReportDetailRowBatchSaveBodyDto.cs @@ -0,0 +1,155 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-12-12 +// +// Last Modified By : yxr +// Last Modified On : 2024-12-12 +// ************************************************************************ +// +// MIT +// +// 批量创建/更新填报行 请求体 +// ************************************************************************ +namespace FeishuNetSdk.Corehr; +/// +/// 批量创建/更新填报行 请求体 +/// 批量创建/更新填报行后，可在【设置-编制规划设置-编制规划XXX-集中填报】进行查看。 +/// 接口ID：7446337145820069892 +/// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/report_detail_row/batchSave +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2freport_detail_row%2fbatchSave +/// +public record PostCorehrV2ReportDetailRowBatchSaveBodyDto +{ + /// + /// 编制规划id，可在「设置-编制规划设置-编制规划XXX-页面URL」中解析到。 + /// 必填：是 + /// 示例值：7430330781544564268 + /// + [JsonPropertyName("workforce_plan_id")] + public string WorkforcePlanId { get; set; } = string.Empty; + + /// + /// 集中填报id，可在「设置-编制规划设置-编制规划XXX-集中填报XXX」中解析到。 + /// 必填：是 + /// 示例值：7430470688844023340 + /// + [JsonPropertyName("centralized_reporting_project_id")] + public string CentralizedReportingProjectId { get; set; } = string.Empty; + + /// + /// 集中填报的填报行数量应介于 1 至 5 个之间。 + /// 必填：是 + /// 最大长度：5 + /// 最小长度：1 + /// + [JsonPropertyName("items")] + public WorkforcePlanDetailRow[] Items { get; set; } = Array.Empty(); + + /// + /// 集中填报的填报行数量应介于 1 至 5 个之间。 + /// + public record WorkforcePlanDetailRow + { + /// + /// 集中填报的维度信息要和用户创建的维度匹配，即传入除自动匹配维度外的所有维度，不多不少。 + /// 通过「设置-编制规划设置-编制规划XXX」查看该编制规划有哪些维度。 + /// 自定义组织维度是否为自动匹配的维度则通过「设置-组织配置-自定义组织XXX-查看为组织设置自动匹配规则」，“是”代表该维度为自动匹配维度。 + /// 必填：是 + /// 最大长度：20 + /// 最小长度：1 + /// + [JsonPropertyName("dimensions")] + public DimensionEntity[] Dimensions { get; set; } = Array.Empty(); + + /// + /// 集中填报的维度信息要和用户创建的维度匹配，即传入除自动匹配维度外的所有维度，不多不少。 + /// 通过「设置-编制规划设置-编制规划XXX」查看该编制规划有哪些维度。 + /// 自定义组织维度是否为自动匹配的维度则通过「设置-组织配置-自定义组织XXX-查看为组织设置自动匹配规则」，“是”代表该维度为自动匹配维度。 + /// + public record DimensionEntity + { + /// + /// 维度key，可从下面列表中进行选择： + /// - "department"：部门。 + /// - "employee_type" ：人员类型。 + /// - "location"：地点。 + /// - "position" ：岗位。 + /// - "cost_center" ：成本中心/业务线。 + /// - "job_family" ：序列。 + /// - "job_level" ：职级。 + /// - "job" ：职务。 + /// 自定义组织： + /// - "custom_org_01" + /// - "custom_org_02" + /// - "custom_org_03" + /// - "custom_org_04" + /// - "custom_org_05" + /// 必填：是 + /// 示例值：department + /// + [JsonPropertyName("dimension_key")] + public string DimensionKey { get; set; } = string.Empty; + + /// + /// 维度value。 + /// - department：可从[查询部门](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get)获得。 + /// - location：可从[查询地点](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)获得。 + /// - cost_center：可从[查询成本中心](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)获得。 + /// - job：可从[查询职务](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)获得。 + /// - job_level：可从[查询职级](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)获得。 + /// - job_family：可从[查询序列](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)获得。 + /// - employee_type：可从[查询人员类型](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/employee_type_enum/list)获得。 + /// - position：岗位，功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// - custom_org_01：自定义组织，功能灰度中，有需要请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// - custom_org_02：自定义组织，功能灰度中，有需要请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// - custom_org_03：自定义组织，功能灰度中，有需要请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// - custom_org_04：自定义组织，功能灰度中，有需要请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// - custom_org_05：自定义组织，功能灰度中，有需要请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：是 + /// 示例值：7322790168290739756 + /// + [JsonPropertyName("dimension_value")] + public string DimensionValue { get; set; } = string.Empty; + } + + /// + /// 预估在职人数相关信息。可从「设置-编制规划设置-编制规划XXX-集中填报」查看预估在职人数的时间，如果不存在该字段说明用户创建时即没有允许填写该字段，批量创建/更新填报行时则无需给该字段，如果存在，用户需要查看预估在职人数的日期，使用示例值格式进行传参。 + /// 必填：否 + /// 最大长度：15 + /// 最小长度：0 + /// + [JsonPropertyName("eai_details")] + public WorkforcePlanEaiDetail[]? EaiDetails { get; set; } + + /// + /// 预估在职人数相关信息。可从「设置-编制规划设置-编制规划XXX-集中填报」查看预估在职人数的时间，如果不存在该字段说明用户创建时即没有允许填写该字段，批量创建/更新填报行时则无需给该字段，如果存在，用户需要查看预估在职人数的日期，使用示例值格式进行传参。 + /// + public record WorkforcePlanEaiDetail + { + /// + /// 预估在职人数的日期，和集中填报页面上显示的预估在职人数的日期一致，且格式要依照示例给定，若二者不匹配，则无法完成识别更新。 + /// 必填：否 + /// 示例值：2020-10-31 + /// + [JsonPropertyName("date")] + public string? Date { get; set; } + + /// + /// 预估在职人数应与创建编制规划时指定的小数位数相匹配，若不匹配，则无法更新。小数位查看方式：「设置-编制规划-编制规划XXX」查看预估在职人数的小数位数。 + /// 必填：否 + /// 示例值：10 + /// + [JsonPropertyName("estimated_active_individuals")] + public string? EstimatedActiveIndividuals { get; set; } + } + + /// + /// 编制规划值需与创建编制规划时指定的小数位数相匹配，若不匹配，则无法更新。小数位查看方式：「设置-编制规划-编制规划XXX」查看编制规划的小数位数。 + /// 必填：否 + /// 示例值：12 + /// + [JsonPropertyName("plan_value")] + public string? PlanValue { get; set; } + } +} diff --git a/src/Corehr/PostCorehrV2WorkforcePlanDetailRowBatchDeleteBodyDto.cs b/src/Corehr/PostCorehrV2WorkforcePlanDetailRowBatchDeleteBodyDto.cs new file mode 100644 index 00000000..da7fed3f --- /dev/null +++ b/src/Corehr/PostCorehrV2WorkforcePlanDetailRowBatchDeleteBodyDto.cs @@ -0,0 +1,147 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-12-12 +// +// Last Modified By : yxr +// Last Modified On : 2024-12-12 +// ************************************************************************ +// +// MIT +// +// 批量删除明细行 请求体 +// ************************************************************************ +namespace FeishuNetSdk.Corehr; +/// +/// 批量删除明细行 请求体 +/// 批量删除明细行后，可在【设置-编制规划设置-编制规划XXX-编辑数据】进行查看明细行是否被删除。 +/// 接口ID：7446337145820086276 +/// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/workforce_plan_detail_row/batchDelete +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fworkforce_plan_detail_row%2fbatchDelete +/// +public record PostCorehrV2WorkforcePlanDetailRowBatchDeleteBodyDto +{ + /// + /// 编制规划id，可在「设置-编制规划设置-编制规划XXX-页面URL」中解析到。 + /// 必填：是 + /// 示例值：7430330781544564268 + /// + [JsonPropertyName("workforce_plan_id")] + public string WorkforcePlanId { get; set; } = string.Empty; + + /// + /// 编制规划的明细行数量应介于 1 至 5 个之间。 + /// 必填：是 + /// 最大长度：5 + /// 最小长度：1 + /// + [JsonPropertyName("items")] + public WorkforcePlanDetailRow[] Items { get; set; } = Array.Empty(); + + /// + /// 编制规划的明细行数量应介于 1 至 5 个之间。 + /// + public record WorkforcePlanDetailRow + { + /// + /// 编制规划的维度信息要和用户创建的维度匹配，即传入除自动匹配维度外的所有维度，不多不少。 + /// 通过「设置-编制规划设置-编制规划XXX」查看该编制规划有哪些维度。 + /// 自定义组织维度是否为自动匹配的维度则通过「设置-组织配置-自定义组织XXX-查看为组织设置自动匹配规则」，“是”代表该维度为自动匹配维度。 + /// 必填：是 + /// 最大长度：20 + /// 最小长度：1 + /// + [JsonPropertyName("dimensions")] + public DimensionEntity[] Dimensions { get; set; } = Array.Empty(); + + /// + /// 编制规划的维度信息要和用户创建的维度匹配，即传入除自动匹配维度外的所有维度，不多不少。 + /// 通过「设置-编制规划设置-编制规划XXX」查看该编制规划有哪些维度。 + /// 自定义组织维度是否为自动匹配的维度则通过「设置-组织配置-自定义组织XXX-查看为组织设置自动匹配规则」，“是”代表该维度为自动匹配维度。 + /// + public record DimensionEntity + { + /// + /// 维度key，可从下面列表中进行选择： + /// - "department"：部门。 + /// - "employee_type" ：人员类型。 + /// - "location"：地点。 + /// - "position" ：岗位。 + /// - "cost_center" ：成本中心/业务线。 + /// - "job_family" ：序列。 + /// - "job_level" ：职级。 + /// - "job" ：职务。 + /// 自定义组织： + /// - "custom_org_01" + /// - "custom_org_02" + /// - "custom_org_03" + /// - "custom_org_04" + /// - "custom_org_05" + /// 必填：是 + /// 示例值：department + /// + [JsonPropertyName("dimension_key")] + public string DimensionKey { get; set; } = string.Empty; + + /// + /// 维度value。 + /// - department：可从[查询部门](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get)获得。 + /// - location：可从[查询地点](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)获得。 + /// - cost_center：可从[查询成本中心](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)获得。 + /// - job：可从[查询职务](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)获得。 + /// - job_level：可从[查询职级](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)获得。 + /// - job_family：可从[查询序列](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)获得。 + /// - employee_type：可从[查询人员类型](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/employee_type_enum/list)获得。 + /// - position：岗位，功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// - custom_org_01：自定义组织，功能灰度中，有需要请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// - custom_org_02：自定义组织，功能灰度中，有需要请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// - custom_org_03：自定义组织，功能灰度中，有需要请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// - custom_org_04：自定义组织，功能灰度中，有需要请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// - custom_org_05：自定义组织，功能灰度中，有需要请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：是 + /// 示例值：7322790168290739756 + /// + [JsonPropertyName("dimension_value")] + public string DimensionValue { get; set; } = string.Empty; + } + + /// + /// 预估在职人数相关信息。可从「设置-编制规划设置-编制规划XXX」查看预估在职人数的时间，如果不存在该字段说明用户创建时即没有允许填写该字段，批量删除明细行时则无需给该字段，如果存在，用户需要查看预估在职人数的日期，使用示例值格式进行传参。 + /// 必填：否 + /// 最大长度：15 + /// 最小长度：0 + /// + [JsonPropertyName("eai_details")] + public WorkforcePlanEaiDetail[]? EaiDetails { get; set; } + + /// + /// 预估在职人数相关信息。可从「设置-编制规划设置-编制规划XXX」查看预估在职人数的时间，如果不存在该字段说明用户创建时即没有允许填写该字段，批量删除明细行时则无需给该字段，如果存在，用户需要查看预估在职人数的日期，使用示例值格式进行传参。 + /// + public record WorkforcePlanEaiDetail + { + /// + /// 预估在职人数的日期，和编制规划页面上显示的预估在职人数的日期一致，且格式要依照示例给定，若二者不匹配，则无法完成识别更新。 + /// 必填：否 + /// 示例值：2020-10-31 + /// + [JsonPropertyName("date")] + public string? Date { get; set; } + + /// + /// 预估在职人数应与创建编制规划时指定的小数位数相匹配，若不匹配，则无法更新。小数位查看方式：「设置-编制规划-编制规划XXX」查看预估在职人数的小数位数。 + /// 必填：否 + /// 示例值：10 + /// + [JsonPropertyName("estimated_active_individuals")] + public string? EstimatedActiveIndividuals { get; set; } + } + + /// + /// 编制规划值需与创建编制规划时指定的小数位数相匹配，若不匹配，则无法更新。小数位查看方式：「设置-编制规划-编制规划XXX」查看编制规划的小数位数。 + /// 必填：否 + /// 示例值：12 + /// + [JsonPropertyName("plan_value")] + public string? PlanValue { get; set; } + } +} diff --git a/src/Corehr/PostCorehrV2WorkforcePlanDetailRowBatchSaveBodyDto.cs b/src/Corehr/PostCorehrV2WorkforcePlanDetailRowBatchSaveBodyDto.cs new file mode 100644 index 00000000..e9e2d02b --- /dev/null +++ b/src/Corehr/PostCorehrV2WorkforcePlanDetailRowBatchSaveBodyDto.cs @@ -0,0 +1,147 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-12-12 +// +// Last Modified By : yxr +// Last Modified On : 2024-12-12 +// ************************************************************************ +// +// MIT +// +// 批量创建/更新明细行 请求体 +// ************************************************************************ +namespace FeishuNetSdk.Corehr; +/// +/// 批量创建/更新明细行 请求体 +/// 批量创建/更新明细行后，可在【设置-编制规划设置-编制规划XXX-编辑数据】进行查看。 +/// 接口ID：7446337145820102660 +/// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/workforce_plan_detail_row/batchSave +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fworkforce_plan_detail_row%2fbatchSave +/// +public record PostCorehrV2WorkforcePlanDetailRowBatchSaveBodyDto +{ + /// + /// 编制规划id，可在「设置-编制规划设置-编制规划XXX-页面URL」中解析到。 + /// 必填：是 + /// 示例值：7430330781544564268 + /// + [JsonPropertyName("workforce_plan_id")] + public string WorkforcePlanId { get; set; } = string.Empty; + + /// + /// 编制规划的明细行数量应介于 1 至 5 个之间。 + /// 必填：是 + /// 最大长度：5 + /// 最小长度：1 + /// + [JsonPropertyName("items")] + public WorkforcePlanDetailRow[] Items { get; set; } = Array.Empty(); + + /// + /// 编制规划的明细行数量应介于 1 至 5 个之间。 + /// + public record WorkforcePlanDetailRow + { + /// + /// 编制规划的维度信息要和用户创建的维度匹配，即传入除自动匹配维度外的所有维度，不多不少。 + /// 通过「设置-编制规划设置-编制规划XXX」查看该编制规划有哪些维度。 + /// 自定义组织维度是否为自动匹配的维度则通过「设置-组织配置-自定义组织XXX-查看为组织设置自动匹配规则」，“是”代表该维度为自动匹配维度。 + /// 必填：是 + /// 最大长度：20 + /// 最小长度：1 + /// + [JsonPropertyName("dimensions")] + public DimensionEntity[] Dimensions { get; set; } = Array.Empty(); + + /// + /// 编制规划的维度信息要和用户创建的维度匹配，即传入除自动匹配维度外的所有维度，不多不少。 + /// 通过「设置-编制规划设置-编制规划XXX」查看该编制规划有哪些维度。 + /// 自定义组织维度是否为自动匹配的维度则通过「设置-组织配置-自定义组织XXX-查看为组织设置自动匹配规则」，“是”代表该维度为自动匹配维度。 + /// + public record DimensionEntity + { + /// + /// 维度key，可从下面列表中进行选择： + /// - "department"：部门。 + /// - "employee_type" ：人员类型。 + /// - "location"：地点。 + /// - "position" ：岗位。 + /// - "cost_center" ：成本中心/业务线。 + /// - "job_family" ：序列。 + /// - "job_level" ：职级。 + /// - "job" ：职务。 + /// 自定义组织： + /// - "custom_org_01" + /// - "custom_org_02" + /// - "custom_org_03" + /// - "custom_org_04" + /// - "custom_org_05" + /// 必填：是 + /// 示例值：department + /// + [JsonPropertyName("dimension_key")] + public string DimensionKey { get; set; } = string.Empty; + + /// + /// 维度value。 + /// - department：可从[查询部门](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get)获得。 + /// - location：可从[查询地点](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)获得。 + /// - cost_center：可从[查询成本中心](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)获得。 + /// - job：可从[查询职务](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)获得。 + /// - job_level：可从[查询职级](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)获得。 + /// - job_family：可从[查询序列](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)获得。 + /// - employee_type：可从[查询人员类型](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/employee_type_enum/list)获得。 + /// - position：岗位，功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// - custom_org_01：自定义组织，功能灰度中，有需要请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// - custom_org_02：自定义组织，功能灰度中，有需要请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// - custom_org_03：自定义组织，功能灰度中，有需要请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// - custom_org_04：自定义组织，功能灰度中，有需要请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// - custom_org_05：自定义组织，功能灰度中，有需要请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：是 + /// 示例值：7322790168290739756 + /// + [JsonPropertyName("dimension_value")] + public string DimensionValue { get; set; } = string.Empty; + } + + /// + /// 预估在职人数相关信息。可从「设置-编制规划设置-编制规划XXX」查看预估在职人数的时间，如果不存在该字段说明用户创建时即没有允许填写该字段，批量创建/更新明细行时则无需给该字段，如果存在，用户需要查看预估在职人数的日期，使用示例值格式进行传参。 + /// 必填：否 + /// 最大长度：15 + /// 最小长度：0 + /// + [JsonPropertyName("eai_details")] + public WorkforcePlanEaiDetail[]? EaiDetails { get; set; } + + /// + /// 预估在职人数相关信息。可从「设置-编制规划设置-编制规划XXX」查看预估在职人数的时间，如果不存在该字段说明用户创建时即没有允许填写该字段，批量创建/更新明细行时则无需给该字段，如果存在，用户需要查看预估在职人数的日期，使用示例值格式进行传参。 + /// + public record WorkforcePlanEaiDetail + { + /// + /// 预估在职人数的日期，和编制规划页面上显示的预估在职人数的日期一致，且格式要依照示例给定，若二者不匹配，则无法完成识别更新。 + /// 必填：否 + /// 示例值：2020-10-31 + /// + [JsonPropertyName("date")] + public string? Date { get; set; } + + /// + /// 预估在职人数应与创建编制规划时指定的小数位数相匹配，若不匹配，则无法更新。小数位查看方式：「设置-编制规划-编制规划XXX」查看预估在职人数的小数位数。 + /// 必填：否 + /// 示例值：10 + /// + [JsonPropertyName("estimated_active_individuals")] + public string? EstimatedActiveIndividuals { get; set; } + } + + /// + /// 编制规划值需与创建编制规划时指定的小数位数相匹配，若不匹配，则无法更新。小数位查看方式：「设置-编制规划-编制规划XXX」查看编制规划的小数位数。 + /// 必填：否 + /// 示例值：12 + /// + [JsonPropertyName("plan_value")] + public string? PlanValue { get; set; } + } +} diff --git a/src/DependencyInjection/FeishuNetSdkExtensions.cs b/src/DependencyInjection/FeishuNetSdkExtensions.cs index 5f81f48d..e259cc31 100644 --- a/src/DependencyInjection/FeishuNetSdkExtensions.cs +++ b/src/DependencyInjection/FeishuNetSdkExtensions.cs @@ -86,8 +86,16 @@ private static IServiceCollection AddFeishuNetSdk(this IServiceCollection servic services.AddHttpApi(); services.AddHttpApi(); - services.AddHttpApi(option => option.KeyValueSerializeOptions.IgnoreNullValues = true); - services.AddHttpApi(option => option.KeyValueSerializeOptions.IgnoreNullValues = true); + services.AddHttpApi(option => + { + option.JsonSerializeOptions.DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull; + option.KeyValueSerializeOptions.IgnoreNullValues = true; + }); + services.AddHttpApi(option => + { + option.JsonSerializeOptions.DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull; + option.KeyValueSerializeOptions.IgnoreNullValues = true; + }); services.TryAddSingleton(); diff --git a/src/FeishuNetSdk.csproj b/src/FeishuNetSdk.csproj index ce0f0f5a..18ab08c1 100644 --- a/src/FeishuNetSdk.csproj +++ b/src/FeishuNetSdk.csproj @@ -16,7 +16,7 @@ MIT 适用于飞书开放平台的.Net开发包 LICENSE - 3.1.7 + 3.1.8 @@ -41,8 +41,8 @@ - - + + diff --git a/src/Hire/GetHireV1ApplicationsByApplicationIdOfferResponseDto.cs b/src/Hire/GetHireV1ApplicationsByApplicationIdOfferResponseDto.cs index a8e1b9f0..feebb49b 100644 --- a/src/Hire/GetHireV1ApplicationsByApplicationIdOfferResponseDto.cs +++ b/src/Hire/GetHireV1ApplicationsByApplicationIdOfferResponseDto.cs @@ -62,7 +62,7 @@ public record ApplicationOffer public record ApplicationOfferBasicInfo { /// - /// Offer 类型 + /// Offer 类型，废弃字段 /// 必填：否 /// 示例值：1 /// 可选值： @@ -571,14 +571,14 @@ public record ApplicationOfferSalaryPlan public string? TotalAnnualCash { get; set; } /// - /// 自定义字段的 value 信息 + /// 自定义字段的 value 信息，详情可参考：[获取 Offer 申请表信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/offer_application_form/get) 中的自定义字段 /// 必填：否 /// [JsonPropertyName("customize_info_list")] public ApplicationOfferCustomValue[]? CustomizeInfoLists { get; set; } /// - /// 自定义字段的 value 信息 + /// 自定义字段的 value 信息，详情可参考：[获取 Offer 申请表信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/offer_application_form/get) 中的自定义字段 /// public record ApplicationOfferCustomValue { @@ -601,7 +601,7 @@ public record ApplicationOfferCustomValue } /// - /// 当前 Offer 使用的 schema + /// 当前 Offer 使用的 schema ID，详情可参考：[获取 Offer 申请表信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/offer_application_form/get) /// 必填：否 /// 示例值：6963562624677398823 /// diff --git a/src/Hire/GetHireV1ApplicationsByApplicationIdResponseDto.cs b/src/Hire/GetHireV1ApplicationsByApplicationIdResponseDto.cs index 21080f14..acabcb8b 100644 --- a/src/Hire/GetHireV1ApplicationsByApplicationIdResponseDto.cs +++ b/src/Hire/GetHireV1ApplicationsByApplicationIdResponseDto.cs @@ -42,7 +42,7 @@ public record GetHireV1ApplicationsByApplicationIdResponseDtoApplication public string? Id { get; set; } /// - /// 投递的职位 ID + /// 投递的职位 ID，详情可参考：[获取职位详情](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job/get_detail) /// 必填：否 /// 示例值：6843547872837273223 /// @@ -50,7 +50,7 @@ public record GetHireV1ApplicationsByApplicationIdResponseDtoApplication public string? JobId { get; set; } /// - /// 候选人 ID + /// 候选人 ID，详情可参考：[获取人才详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/hire-v2/talent/get) /// 必填：否 /// 示例值：6843547872837273223 /// @@ -78,7 +78,7 @@ public record GetHireV1ApplicationsByApplicationIdResponseDtoApplication public record ApplicationStageInfo { /// - /// 阶段 ID + /// 阶段 ID，详情可参考：[获取招聘流程信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_process/list)返回参数中的投递阶段信息 /// 必填：否 /// 示例值：614218419274131 /// diff --git a/src/Hire/GetHireV1InterviewFeedbackFormsResponseDto.cs b/src/Hire/GetHireV1InterviewFeedbackFormsResponseDto.cs index b6cab87f..f42c6d72 100644 --- a/src/Hire/GetHireV1InterviewFeedbackFormsResponseDto.cs +++ b/src/Hire/GetHireV1InterviewFeedbackFormsResponseDto.cs @@ -17,6 +17,7 @@ namespace FeishuNetSdk.Hire; /// 获取面试评价表信息列表，评价表信息包括题目描述、题目选项等。可用于面试评价表展示等场景。 /// ## 注意事项 /// - 面试评价表通过版本进行变更管理，每次修改评价表都会更新版本，同时变更评价表ID、模块ID、模块维度ID、选项ID、能力项ID。 +/// - 当使用分页方式获取数据时，仅能获取到最新版本的面试评价表，当指定面试评价表 ID 列表时，可以获取到历史版本面评评价表。 /// ## 面试评价表产品示意图 /// 接口ID：7356428725080342530 /// 文档地址：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/interview_feedback_form/list diff --git a/src/Hire/GetHireV1InterviewsGetByTalentResponseDto.cs b/src/Hire/GetHireV1InterviewsGetByTalentResponseDto.cs index 847201c3..bafa0a5d 100644 --- a/src/Hire/GetHireV1InterviewsGetByTalentResponseDto.cs +++ b/src/Hire/GetHireV1InterviewsGetByTalentResponseDto.cs @@ -98,7 +98,7 @@ public record InterviewExtend public record InterviewRecord { /// - /// 面试评价 ID + /// 面试评价 ID，详情可参考：[获取面试评价详细信息（新版）](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/hire-v2/interview_record/get) /// 必填：否 /// 示例值：6949805467799537964 /// diff --git a/src/Hire/GetHireV1JobRequirementsResponseDto.cs b/src/Hire/GetHireV1JobRequirementsResponseDto.cs index f4b93f8f..fdfc21ce 100644 --- a/src/Hire/GetHireV1JobRequirementsResponseDto.cs +++ b/src/Hire/GetHireV1JobRequirementsResponseDto.cs @@ -295,14 +295,14 @@ public record I18n public string? Description { get; set; } /// - /// 自定义字段 + /// 自定义字段，请参考[获取招聘需求模板列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_requirement_schema/list)中的自定义字段 /// 必填：否 /// [JsonPropertyName("customized_data_list")] public JobRequirementCustomizedDataDto[]? CustomizedDataLists { get; set; } /// - /// 自定义字段 + /// 自定义字段，请参考[获取招聘需求模板列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_requirement_schema/list)中的自定义字段 /// public record JobRequirementCustomizedDataDto { diff --git a/src/Hire/GetHireV1OffersResponseDto.cs b/src/Hire/GetHireV1OffersResponseDto.cs index 931b7319..9721e0c0 100644 --- a/src/Hire/GetHireV1OffersResponseDto.cs +++ b/src/Hire/GetHireV1OffersResponseDto.cs @@ -70,7 +70,7 @@ public record OfferListInfo public record OfferJobInfo { /// - /// Offer 职位 ID，获取职位详情请参考[获取职位信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job/get) + /// Offer 职位 ID，详情请参考[获取职位详情](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job/get_detail) /// 必填：否 /// 示例值：7080891505426925854 /// diff --git a/src/Hire/GetHireV1TalentsByTalentIdResponseDto.cs b/src/Hire/GetHireV1TalentsByTalentIdResponseDto.cs index 47016358..1644a4a8 100644 --- a/src/Hire/GetHireV1TalentsByTalentIdResponseDto.cs +++ b/src/Hire/GetHireV1TalentsByTalentIdResponseDto.cs @@ -9,11 +9,11 @@ // // MIT // -// 获取人才信息 V1 响应体 +// 获取人才信息 响应体 // ************************************************************************ namespace FeishuNetSdk.Hire; /// -/// 获取人才信息 V1 响应体 +/// 获取人才信息 响应体 /// 根据人才 ID 获取人才信息。 /// 接口ID：6964264269274611714 /// 文档地址：https://open.feishu.cn/document/server-docs/hire-v1/candidate-management/talent/get diff --git a/src/Hire/GetHireV1WebsitesByWebsiteIdJobPostsResponseDto.cs b/src/Hire/GetHireV1WebsitesByWebsiteIdJobPostsResponseDto.cs index c44033e3..c88e092d 100644 --- a/src/Hire/GetHireV1WebsitesByWebsiteIdJobPostsResponseDto.cs +++ b/src/Hire/GetHireV1WebsitesByWebsiteIdJobPostsResponseDto.cs @@ -360,7 +360,7 @@ public record I18n public int? Headcount { get; set; } /// - /// 职位亮点 + /// 职位亮点，详情请参考：[枚举常量介绍](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/enum)中「职位亮枚举定义」 /// 必填：否 /// [JsonPropertyName("high_light_list")] @@ -418,7 +418,7 @@ public record I18n public record WebsiteJobPostCustomizedData { /// - /// 自定义字段 ID + /// 自定义字段 ID，详情请参考：[获取职位模板](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_schema/list) /// 必填：否 /// 示例值：xxxx /// diff --git a/src/Hire/GetHireV2InterviewRecordsByInterviewRecordIdResponseDto.cs b/src/Hire/GetHireV2InterviewRecordsByInterviewRecordIdResponseDto.cs new file mode 100644 index 00000000..bc82fd84 --- /dev/null +++ b/src/Hire/GetHireV2InterviewRecordsByInterviewRecordIdResponseDto.cs @@ -0,0 +1,694 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-12-12 +// +// Last Modified By : yxr +// Last Modified On : 2024-12-12 +// ************************************************************************ +// +// MIT +// +// 获取面试评价详细信息（新版） 响应体 +// ************************************************************************ +namespace FeishuNetSdk.Hire; +/// +/// 获取面试评价详细信息（新版） 响应体 +/// 获取面试评价详细信息，如面试结论、面试得分和面试官等信息。 +/// 接口ID：7356428725080358914 +/// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/hire-v2/interview_record/get +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fhire-v2%2finterview_record%2fget +/// +public record GetHireV2InterviewRecordsByInterviewRecordIdResponseDto +{ + /// + /// 面试评价详细信息 + /// 必填：否 + /// + [JsonPropertyName("interview_record")] + public GetHireV2InterviewRecordsByInterviewRecordIdResponseDtoInterviewRecord? InterviewRecord { get; set; } + + /// + /// 面试评价详细信息 + /// + public record GetHireV2InterviewRecordsByInterviewRecordIdResponseDtoInterviewRecord + { + /// + /// 面试评价 ID + /// 必填：否 + /// 示例值：7171693733661327361 + /// + [JsonPropertyName("id")] + public string? Id { get; set; } + + /// + /// 面试评价表 ID，详情可查看：[获取面试评价表列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/interview_feedback_form/list) + /// 必填：否 + /// 示例值：71716937336613273612 + /// + [JsonPropertyName("feedback_form_id")] + public string? FeedbackFormId { get; set; } + + /// + /// 提交状态 + /// 必填：否 + /// 示例值：1 + /// 可选值： + /// 1：已提交 + /// 2：未提交 + /// + /// + [JsonPropertyName("commit_status")] + public int? CommitStatus { get; set; } + + /// + /// 面试评价提交时间，毫秒时间戳 + /// 必填：否 + /// 示例值：1710405457390 + /// + [JsonPropertyName("submit_time")] + public string? SubmitTime { get; set; } + + /// + /// 面试评价分数 + /// 必填：否 + /// + [JsonPropertyName("record_score")] + public GetHireV2InterviewRecordsByInterviewRecordIdResponseDtoInterviewRecordRecordScore? RecordScore { get; set; } + + /// + /// 面试评价分数 + /// + public record GetHireV2InterviewRecordsByInterviewRecordIdResponseDtoInterviewRecordRecordScore + { + /// + /// 面试评价得分，精确到小数点后两位 + /// 必填：否 + /// 示例值：100.00 + /// 最大值：2147483647 + /// 最小值：0 + /// + [JsonPropertyName("score")] + public float? Score { get; set; } + + /// + /// 面试评价总分，精确到小数点后两位 + /// 必填：否 + /// 示例值：100.00 + /// 最大值：2147483647 + /// 最小值：0 + /// + [JsonPropertyName("total_score")] + public float? TotalScore { get; set; } + } + + /// + /// 面试官信息 + /// 必填：否 + /// + [JsonPropertyName("interviewer")] + public IdNameObject? Interviewer { get; set; } + + /// + /// 面试官信息 + /// + public record IdNameObject + { + /// + /// 面试官 ID，与入参 `user_id_type` 类型一致 + /// 必填：是 + /// 示例值：7171693733661327364 + /// + [JsonPropertyName("id")] + public string Id { get; set; } = string.Empty; + + /// + /// 面试官姓名 + /// 必填：否 + /// + [JsonPropertyName("name")] + public I18n? Name { get; set; } + + /// + /// 面试官姓名 + /// + public record I18n + { + /// + /// 面试官中文名 + /// 必填：否 + /// 示例值：小明 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 面试官英文名 + /// 必填：否 + /// 示例值：xiaoming + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + } + + /// + /// 面试评价附件列表 + /// 必填：否 + /// 最大长度：1000 + /// 最小长度：0 + /// + [JsonPropertyName("attachments")] + public Attachment[]? Attachments { get; set; } + + /// + /// 面试评价附件列表 + /// + public record Attachment + { + /// + /// 附件 ID + /// 必填：否 + /// 示例值：7140517838785481004 + /// + [JsonPropertyName("file_id")] + public string? FileId { get; set; } + + /// + /// 附件名称 + /// 必填：否 + /// 示例值：1.13测试1的面试记录.pdf + /// + [JsonPropertyName("file_name")] + public string? FileName { get; set; } + + /// + /// 附件类型 + /// 必填：否 + /// 示例值：application/pdf + /// + [JsonPropertyName("content_type")] + public string? ContentType { get; set; } + + /// + /// 附件大小 + /// 必填：否 + /// 示例值：16615 + /// 最大值：2147483647 + /// 最小值：0 + /// + [JsonPropertyName("file_size")] + public int? FileSize { get; set; } + + /// + /// 附件创建时间，毫秒时间戳 + /// 必填：否 + /// 示例值：1710399930151 + /// + [JsonPropertyName("create_time")] + public string? CreateTime { get; set; } + } + + /// + /// 模块评价列表 + /// 必填：否 + /// 最大长度：1000 + /// 最小长度：0 + /// + [JsonPropertyName("module_assessments")] + public ModuleAssessment[]? ModuleAssessments { get; set; } + + /// + /// 模块评价列表 + /// + public record ModuleAssessment + { + /// + /// 面试评价表模块 ID，详情可查看：[获取面试评价表列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/interview_feedback_form/list)返回结果中 `data.items.modules` 字段 + /// 必填：否 + /// 示例值：7171693733661327361 + /// + [JsonPropertyName("interview_feedback_form_module_id")] + public string? InterviewFeedbackFormModuleId { get; set; } + + /// + /// 模块名称 + /// 必填：否 + /// + [JsonPropertyName("module_name")] + public I18n? ModuleName { get; set; } + + /// + /// 模块名称 + /// + public record I18n + { + /// + /// 模块中文名称 + /// 必填：否 + /// 示例值：面试记录 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 模块英文名称 + /// 必填：否 + /// 示例值：Interview Result + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 模块类型 + /// 必填：否 + /// 示例值：1 + /// 可选值： + /// 1：系统预置「面试结论」模块 + /// 2：自定义模块 + /// + /// + [JsonPropertyName("module_type")] + public int? ModuleType { get; set; } + + /// + /// 模块权重，精确到小数点后两位 + /// 必填：否 + /// 示例值：10.00 + /// 最大值：2147483647 + /// 最小值：0 + /// + [JsonPropertyName("module_weight")] + public float? ModuleWeight { get; set; } + + /// + /// 模块打分，精确到小数点后两位 + /// 必填：否 + /// 示例值：10.00 + /// 最大值：2147483647 + /// 最小值：0 + /// + [JsonPropertyName("module_score")] + public float? ModuleScore { get; set; } + + /// + /// 模块评价 + /// 必填：否 + /// 最大长度：1000 + /// 最小长度：0 + /// + [JsonPropertyName("dimension_assessments")] + public DimensionAssessment[]? DimensionAssessments { get; set; } + + /// + /// 模块评价 + /// + public record DimensionAssessment + { + /// + /// 维度 ID，详情可查看：[获取面试评价表列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/interview_feedback_form/list)返回结果中 `data.items.modules.dimensions` 字段 + /// 必填：否 + /// 示例值：7171693733661327361 + /// + [JsonPropertyName("interview_feedback_form_dimension_id")] + public string? InterviewFeedbackFormDimensionId { get; set; } + + /// + /// 维度名称 + /// 必填：否 + /// + [JsonPropertyName("dimension_name")] + public I18n? DimensionName { get; set; } + + /// + /// 维度名称 + /// + public record I18n + { + /// + /// 维度中文名称 + /// 必填：否 + /// 示例值：行业知识储备水平 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 维度英文名称 + /// 必填：否 + /// 示例值：Industry knowledge reserve level + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 维度评价方式 + /// 必填：否 + /// 示例值：1 + /// 可选值： + /// 1：单选题 + /// 2：多选题 + /// 3：描述题 + /// 5：职级建议 + /// 6：打分题(单选) + /// 7：打分题(填空) + /// 10：系统预置-结论 + /// 11：系统预置-得分 + /// 12：系统预置-记录 + /// + /// + [JsonPropertyName("dimension_type")] + public int? DimensionType { get; set; } + + /// + /// 维度权重，精确到小数点后两位 + /// 必填：否 + /// 示例值：1.00 + /// 最大值：2147483647 + /// 最小值：0 + /// + [JsonPropertyName("weight")] + public float? Weight { get; set; } + + /// + /// 当维度评价方式为 `描述题` 时，从此取值 + /// 必填：否 + /// 示例值：描述题作答 + /// + [JsonPropertyName("dimension_content")] + public string? DimensionContent { get; set; } + + /// + /// 当维度评价方式为 `单选题` 时，从此取值 + /// 必填：否 + /// + [JsonPropertyName("dimension_option")] + public DimensionAssessmentDimensionOption? DimensionOption { get; set; } + + /// + /// 当维度评价方式为 `单选题` 时，从此取值 + /// + public record DimensionAssessmentDimensionOption + { + /// + /// 选项 ID，详情可查看：[获取面试评价表列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/interview_feedback_form/list)返回结果中 `data.items.modules.dimensions.option_items` 字段 + /// 必填：否 + /// 示例值：7171693733661327361 + /// + [JsonPropertyName("id")] + public string? Id { get; set; } + + /// + /// 选项名称 + /// 必填：否 + /// 示例值：7171693733661327361 + /// + [JsonPropertyName("name")] + public I18n? Name { get; set; } + + /// + /// 选项名称 + /// + public record I18n + { + /// + /// 选项中文名称 + /// 必填：否 + /// 示例值：选项一 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 选项英文名称 + /// 必填：否 + /// 示例值：Option 1 + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 选项分数 + /// **数据范围**： + /// - `0` ～ `100` + /// 必填：否 + /// 示例值：10 + /// 最大值：2147483647 + /// 最小值：0 + /// + [JsonPropertyName("score_val")] + public int? ScoreVal { get; set; } + } + + /// + /// 当维度评价方式为 `多选题` 时，从此取值 + /// 必填：否 + /// 最大长度：1000 + /// 最小长度：0 + /// + [JsonPropertyName("dimension_options")] + public DimensionOptionSuffix[]? DimensionOptions { get; set; } + + /// + /// 当维度评价方式为 `多选题` 时，从此取值 + /// + public record DimensionOptionSuffix + { + /// + /// 选项 ID，详情可查看：[获取面试评价表列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/interview_feedback_form/list)返回结果中 `data.items.modules.dimensions.option_items` 字段 + /// 必填：否 + /// 示例值：7171693733661327361 + /// + [JsonPropertyName("id")] + public string? Id { get; set; } + + /// + /// 选项名称 + /// 必填：否 + /// 示例值：7171693733661327361 + /// + [JsonPropertyName("name")] + public I18n? Name { get; set; } + + /// + /// 选项名称 + /// + public record I18n + { + /// + /// 选项中文名称 + /// 必填：否 + /// 示例值：选项一 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 选项英文名称 + /// 必填：否 + /// 示例值：Option 1 + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 选项分数 + /// **数据范围**： + /// - `0` ～ `100` + /// 必填：否 + /// 示例值：10 + /// 最大值：2147483647 + /// 最小值：0 + /// + [JsonPropertyName("score_val")] + public int? ScoreVal { get; set; } + } + + /// + /// 当维度评价方式为 `打分题(填空)` 时，从此取值 + /// 必填：否 + /// 示例值：10 + /// 最大值：2147483647 + /// 最小值：0 + /// + [JsonPropertyName("dimension_score")] + public int? DimensionScore { get; set; } + + /// + /// 当维度评价方式为 `职级建议` 时，从此取值 + /// 必填：否 + /// + [JsonPropertyName("recommended_job_level")] + public DimensionAssessmentRecommendedJobLevel? RecommendedJobLevel { get; set; } + + /// + /// 当维度评价方式为 `职级建议` 时，从此取值 + /// + public record DimensionAssessmentRecommendedJobLevel + { + /// + /// 最低职级建议 + /// 必填：否 + /// + [JsonPropertyName("lower_limit_job_level_name")] + public I18n? LowerLimitJobLevelName { get; set; } + + /// + /// 最低职级建议 + /// + public record I18n + { + /// + /// 最低职级建议中文 + /// 必填：否 + /// 示例值：2-2 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 最低职级建议英文 + /// 必填：否 + /// 示例值：2-2 + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 最高职级建议 + /// 必填：否 + /// + [JsonPropertyName("higher_limit_job_level_name")] + public I18n? HigherLimitJobLevelName { get; set; } + } + + /// + /// 面试题 + /// 必填：否 + /// 最大长度：1000 + /// 最小长度：0 + /// + [JsonPropertyName("question_assessments")] + public QuestionAssessment[]? QuestionAssessments { get; set; } + + /// + /// 面试题 + /// + public record QuestionAssessment + { + /// + /// 面试题类型 + /// 必填：否 + /// 示例值：1 + /// 可选值： + /// 1：普通面试题目 + /// 2：在线编程题目 + /// + /// + [JsonPropertyName("question_type")] + public int? QuestionType { get; set; } + + /// + /// 面试题名称 + /// 必填：否 + /// + [JsonPropertyName("title")] + public I18n? Title { get; set; } + + /// + /// 面试题名称 + /// + public record I18n + { + /// + /// 面试题中文名称 + /// 必填：否 + /// 示例值：操作系统进程调度 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 面试题英文名称 + /// 必填：否 + /// 示例值：Operating system process scheduling + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 面试题描述 + /// 必填：否 + /// + [JsonPropertyName("description")] + public I18n? Description { get; set; } + + /// + /// 面试者作答内容 + /// 必填：否 + /// 示例值：操作系统的进程调度是通过... + /// + [JsonPropertyName("content")] + public string? Content { get; set; } + + /// + /// 能力项列表 + /// 必填：否 + /// 最大长度：1000 + /// 最小长度：0 + /// + [JsonPropertyName("abilities")] + public Ability[]? Abilities { get; set; } + + /// + /// 能力项列表 + /// + public record Ability + { + /// + /// 能力项名称 + /// 必填：否 + /// + [JsonPropertyName("name")] + public I18n? Name { get; set; } + + /// + /// 能力项名称 + /// + public record I18n + { + /// + /// 能力项中文名称 + /// 必填：否 + /// 示例值：算法 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 能力项英文名称 + /// 必填：否 + /// 示例值：Algorithm + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 能力项描述 + /// 必填：否 + /// + [JsonPropertyName("description")] + public I18n? Description { get; set; } + } + } + } + } + } +} diff --git a/src/Hire/GetHireV2InterviewRecordsResponseDto.cs b/src/Hire/GetHireV2InterviewRecordsResponseDto.cs new file mode 100644 index 00000000..9f1ffdbd --- /dev/null +++ b/src/Hire/GetHireV2InterviewRecordsResponseDto.cs @@ -0,0 +1,710 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-12-12 +// +// Last Modified By : yxr +// Last Modified On : 2024-12-12 +// ************************************************************************ +// +// MIT +// +// 批量获取面试评价详细信息（新版） 响应体 +// ************************************************************************ +namespace FeishuNetSdk.Hire; +/// +/// 批量获取面试评价详细信息（新版） 响应体 +/// 批量获取面试评价详细信息，如面试结论、面试得分和面试官等信息。 +/// 接口ID：7356428725080375298 +/// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/hire-v2/interview_record/list +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fhire-v2%2finterview_record%2flist +/// +public record GetHireV2InterviewRecordsResponseDto +{ + /// + /// 面试评价详细信息列表 + /// 必填：否 + /// + [JsonPropertyName("items")] + public InterviewRecord[]? Items { get; set; } + + /// + /// 面试评价详细信息列表 + /// + public record InterviewRecord + { + /// + /// 面试评价 ID + /// 必填：否 + /// 示例值：7171693733661327361 + /// + [JsonPropertyName("id")] + public string? Id { get; set; } + + /// + /// 面试评价表 ID，详情可查看：[获取面试评价表列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/interview_feedback_form/list) + /// 必填：否 + /// 示例值：71716937336613273612 + /// + [JsonPropertyName("feedback_form_id")] + public string? FeedbackFormId { get; set; } + + /// + /// 提交状态 + /// 必填：否 + /// 示例值：1 + /// 可选值： + /// 1：已提交 + /// 2：未提交 + /// + /// + [JsonPropertyName("commit_status")] + public int? CommitStatus { get; set; } + + /// + /// 面试评价提交时间 + /// 必填：否 + /// 示例值：1710405457390 + /// + [JsonPropertyName("submit_time")] + public string? SubmitTime { get; set; } + + /// + /// 面试评价分数 + /// 必填：否 + /// + [JsonPropertyName("record_score")] + public InterviewRecordRecordScore? RecordScore { get; set; } + + /// + /// 面试评价分数 + /// + public record InterviewRecordRecordScore + { + /// + /// 面试评价得分，精确到小数点后两位 + /// 必填：否 + /// 示例值：100.00 + /// 最大值：2147483647 + /// 最小值：0 + /// + [JsonPropertyName("score")] + public float? Score { get; set; } + + /// + /// 面试评价总分，精确到小数点后两位 + /// 必填：否 + /// 示例值：100.00 + /// 最大值：2147483647 + /// 最小值：0 + /// + [JsonPropertyName("total_score")] + public float? TotalScore { get; set; } + } + + /// + /// 面试官信息 + /// 必填：否 + /// + [JsonPropertyName("interviewer")] + public IdNameObject? Interviewer { get; set; } + + /// + /// 面试官信息 + /// + public record IdNameObject + { + /// + /// 面试官 ID，与入参 `user_id_type` 类型一致 + /// 必填：是 + /// 示例值：7171693733661327364 + /// + [JsonPropertyName("id")] + public string Id { get; set; } = string.Empty; + + /// + /// 面试官姓名 + /// 必填：否 + /// + [JsonPropertyName("name")] + public I18n? Name { get; set; } + + /// + /// 面试官姓名 + /// + public record I18n + { + /// + /// 面试官中文名 + /// 必填：否 + /// 示例值：小明 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 面试官英文名 + /// 必填：否 + /// 示例值：xiaoming + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + } + + /// + /// 面试评价附件列表 + /// 必填：否 + /// 最大长度：1000 + /// 最小长度：0 + /// + [JsonPropertyName("attachments")] + public Attachment[]? Attachments { get; set; } + + /// + /// 面试评价附件列表 + /// + public record Attachment + { + /// + /// 附件 ID + /// 必填：否 + /// 示例值：7140517838785481004 + /// + [JsonPropertyName("file_id")] + public string? FileId { get; set; } + + /// + /// 附件名称 + /// 必填：否 + /// 示例值：1.13测试1的面试记录.pdf + /// + [JsonPropertyName("file_name")] + public string? FileName { get; set; } + + /// + /// 附件类型 + /// 必填：否 + /// 示例值：application/pdf + /// + [JsonPropertyName("content_type")] + public string? ContentType { get; set; } + + /// + /// 附件大小 + /// 必填：否 + /// 示例值：16615 + /// 最大值：2147483647 + /// 最小值：0 + /// + [JsonPropertyName("file_size")] + public int? FileSize { get; set; } + + /// + /// 附件创建时间，毫秒时间戳 + /// 必填：否 + /// 示例值：1710399930151 + /// + [JsonPropertyName("create_time")] + public string? CreateTime { get; set; } + } + + /// + /// 模块评价列表 + /// 必填：否 + /// 最大长度：1000 + /// 最小长度：0 + /// + [JsonPropertyName("module_assessments")] + public ModuleAssessment[]? ModuleAssessments { get; set; } + + /// + /// 模块评价列表 + /// + public record ModuleAssessment + { + /// + /// 面试评价表模块 ID，详情可查看：[获取面试评价表列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/interview_feedback_form/list)返回结果中 `data.items.modules` 字段 + /// 必填：否 + /// 示例值：7171693733661327361 + /// + [JsonPropertyName("interview_feedback_form_module_id")] + public string? InterviewFeedbackFormModuleId { get; set; } + + /// + /// 模块名称 + /// 必填：否 + /// + [JsonPropertyName("module_name")] + public I18n? ModuleName { get; set; } + + /// + /// 模块名称 + /// + public record I18n + { + /// + /// 模块中文名称 + /// 必填：否 + /// 示例值：面试结论 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 模块英文名称 + /// 必填：否 + /// 示例值：Interview Result + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 模块类型 + /// 必填：否 + /// 示例值：1 + /// 可选值： + /// 1：系统预置「面试结论」模块 + /// 2：自定义模块 + /// + /// + [JsonPropertyName("module_type")] + public int? ModuleType { get; set; } + + /// + /// 模块权重，精确到小数点后两位 + /// 必填：否 + /// 示例值：10.00 + /// 最大值：2147483647 + /// 最小值：0 + /// + [JsonPropertyName("module_weight")] + public float? ModuleWeight { get; set; } + + /// + /// 模块打分，精确到小数点后两位 + /// 必填：否 + /// 示例值：10.00 + /// 最大值：2147483647 + /// 最小值：0 + /// + [JsonPropertyName("module_score")] + public float? ModuleScore { get; set; } + + /// + /// 模块评价 + /// 必填：否 + /// 最大长度：1000 + /// 最小长度：0 + /// + [JsonPropertyName("dimension_assessments")] + public DimensionAssessment[]? DimensionAssessments { get; set; } + + /// + /// 模块评价 + /// + public record DimensionAssessment + { + /// + /// 维度 ID，详情可查看：[获取面试评价表列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/interview_feedback_form/list)返回结果中 `data.items.modules.dimensions` 字段 + /// 必填：否 + /// 示例值：7171693733661327361 + /// + [JsonPropertyName("interview_feedback_form_dimension_id")] + public string? InterviewFeedbackFormDimensionId { get; set; } + + /// + /// 维度名称 + /// 必填：否 + /// + [JsonPropertyName("dimension_name")] + public I18n? DimensionName { get; set; } + + /// + /// 维度名称 + /// + public record I18n + { + /// + /// 维度中文名称 + /// 必填：否 + /// 示例值：行业知识储备水平 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 维度英文名称 + /// 必填：否 + /// 示例值：Industry knowledge reserve level + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 维度评价方式 + /// 必填：否 + /// 示例值：1 + /// 可选值： + /// 1：单选题 + /// 2：多选题 + /// 3：描述题 + /// 5：职级建议 + /// 6：打分题(单选) + /// 7：打分题(填空) + /// 10：系统预置-结论 + /// 11：系统预置-得分 + /// 12：系统预置-记录 + /// + /// + [JsonPropertyName("dimension_type")] + public int? DimensionType { get; set; } + + /// + /// 维度权重，精确到小数点后两位 + /// 必填：否 + /// 示例值：1.00 + /// 最大值：2147483647 + /// 最小值：0 + /// + [JsonPropertyName("weight")] + public float? Weight { get; set; } + + /// + /// 当维度评价方式为 `描述题` 时，从此取值 + /// 必填：否 + /// 示例值：描述题作答 + /// + [JsonPropertyName("dimension_content")] + public string? DimensionContent { get; set; } + + /// + /// 当维度评价方式为 `单选题` 时，从此取值 + /// 必填：否 + /// + [JsonPropertyName("dimension_option")] + public DimensionAssessmentDimensionOption? DimensionOption { get; set; } + + /// + /// 当维度评价方式为 `单选题` 时，从此取值 + /// + public record DimensionAssessmentDimensionOption + { + /// + /// 选项 ID，详情可查看：[获取面试评价表列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/interview_feedback_form/list)返回结果中 `data.items.modules.dimensions.option_items` 字段 + /// 必填：否 + /// 示例值：7171693733661327361 + /// + [JsonPropertyName("id")] + public string? Id { get; set; } + + /// + /// 选项名称 + /// 必填：否 + /// 示例值：7171693733661327361 + /// + [JsonPropertyName("name")] + public I18n? Name { get; set; } + + /// + /// 选项名称 + /// + public record I18n + { + /// + /// 选项中文名称 + /// 必填：否 + /// 示例值：选项一 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 选项英文名称 + /// 必填：否 + /// 示例值：Option 1 + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 选项分数 + /// **数据范围**： + /// - `0` ～ `100` + /// 必填：否 + /// 示例值：10 + /// 最大值：2147483647 + /// 最小值：0 + /// + [JsonPropertyName("score_val")] + public int? ScoreVal { get; set; } + } + + /// + /// 当维度评价方式为 `多选题` 时，从此取值 + /// 必填：否 + /// 最大长度：1000 + /// 最小长度：0 + /// + [JsonPropertyName("dimension_options")] + public DimensionOptionSuffix[]? DimensionOptions { get; set; } + + /// + /// 当维度评价方式为 `多选题` 时，从此取值 + /// + public record DimensionOptionSuffix + { + /// + /// 选项 ID，详情可查看：[获取面试评价表列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/interview_feedback_form/list)返回结果中 `data.items.modules.dimensions.option_items` 字段 + /// 必填：否 + /// 示例值：7171693733661327361 + /// + [JsonPropertyName("id")] + public string? Id { get; set; } + + /// + /// 选项名称 + /// 必填：否 + /// 示例值：7171693733661327361 + /// + [JsonPropertyName("name")] + public I18n? Name { get; set; } + + /// + /// 选项名称 + /// + public record I18n + { + /// + /// 选项中文名称 + /// 必填：否 + /// 示例值：选项一 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 选项英文名称 + /// 必填：否 + /// 示例值：Option 1 + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 选项分数 + /// **数据范围**： + /// - `0` ～ `100` + /// 必填：否 + /// 示例值：10 + /// 最大值：2147483647 + /// 最小值：0 + /// + [JsonPropertyName("score_val")] + public int? ScoreVal { get; set; } + } + + /// + /// 当维度评价方式为 `打分题(填空)` 时，从此取值 + /// 必填：否 + /// 示例值：10 + /// 最大值：2147483647 + /// 最小值：0 + /// + [JsonPropertyName("dimension_score")] + public int? DimensionScore { get; set; } + + /// + /// 当维度评价方式为 `职级建议` 时，从此取值 + /// 必填：否 + /// + [JsonPropertyName("recommended_job_level")] + public DimensionAssessmentRecommendedJobLevel? RecommendedJobLevel { get; set; } + + /// + /// 当维度评价方式为 `职级建议` 时，从此取值 + /// + public record DimensionAssessmentRecommendedJobLevel + { + /// + /// 最低职级建议 + /// 必填：否 + /// + [JsonPropertyName("lower_limit_job_level_name")] + public I18n? LowerLimitJobLevelName { get; set; } + + /// + /// 最低职级建议 + /// + public record I18n + { + /// + /// 最低职级建议中文 + /// 必填：否 + /// 示例值：2-2 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 最低职级建议英文 + /// 必填：否 + /// 示例值：2-2 + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 最高职级建议 + /// 必填：否 + /// + [JsonPropertyName("higher_limit_job_level_name")] + public I18n? HigherLimitJobLevelName { get; set; } + } + + /// + /// 面试题 + /// 必填：否 + /// 最大长度：1000 + /// 最小长度：0 + /// + [JsonPropertyName("question_assessments")] + public QuestionAssessment[]? QuestionAssessments { get; set; } + + /// + /// 面试题 + /// + public record QuestionAssessment + { + /// + /// 面试题类型 + /// 必填：否 + /// 示例值：1 + /// 可选值： + /// 1：普通面试题目 + /// 2：在线编程题目 + /// + /// + [JsonPropertyName("question_type")] + public int? QuestionType { get; set; } + + /// + /// 面试题名称 + /// 必填：否 + /// + [JsonPropertyName("title")] + public I18n? Title { get; set; } + + /// + /// 面试题名称 + /// + public record I18n + { + /// + /// 面试题中文名称 + /// 必填：否 + /// 示例值：操作系统进程调度 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 面试题英文名称 + /// 必填：否 + /// 示例值：Operating system process scheduling + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 面试题描述 + /// 必填：否 + /// + [JsonPropertyName("description")] + public I18n? Description { get; set; } + + /// + /// 面试者作答内容 + /// 必填：否 + /// 示例值：操作系统的进程调度是通过... + /// + [JsonPropertyName("content")] + public string? Content { get; set; } + + /// + /// 能力项列表 + /// 必填：否 + /// 最大长度：1000 + /// 最小长度：0 + /// + [JsonPropertyName("abilities")] + public Ability[]? Abilities { get; set; } + + /// + /// 能力项列表 + /// + public record Ability + { + /// + /// 能力项名称 + /// 必填：否 + /// + [JsonPropertyName("name")] + public I18n? Name { get; set; } + + /// + /// 能力项名称 + /// + public record I18n + { + /// + /// 能力项中文名称 + /// 必填：否 + /// 示例值：算法 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 能力项英文名称 + /// 必填：否 + /// 示例值：Algorithm + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 能力项描述 + /// 必填：否 + /// + [JsonPropertyName("description")] + public I18n? Description { get; set; } + } + } + } + } + } + + /// + /// 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token + /// 必填：否 + /// 示例值：eVQrYzJBNDNONlk4VFZBZVlSdzlKdFJ4bVVHVExENDNKVHoxaVdiVnViQT0= + /// + [JsonPropertyName("page_token")] + public string? PageToken { get; set; } + + /// + /// 是否还有更多项 + /// 必填：否 + /// 示例值：true + /// + [JsonPropertyName("has_more")] + public bool? HasMore { get; set; } +} diff --git a/src/Hire/PostHireV1WebsitesByWebsiteIdJobPostsSearchResponseDto.cs b/src/Hire/PostHireV1WebsitesByWebsiteIdJobPostsSearchResponseDto.cs index 63153edd..c196e040 100644 --- a/src/Hire/PostHireV1WebsitesByWebsiteIdJobPostsSearchResponseDto.cs +++ b/src/Hire/PostHireV1WebsitesByWebsiteIdJobPostsSearchResponseDto.cs @@ -50,7 +50,7 @@ public record WebsiteJobPost public string? Title { get; set; } /// - /// 职位 ID + /// 职位 ID，详情可参考：[获取职位详情](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job/get_detail) /// 必填：否 /// 示例值：7380246392272603428 /// diff --git a/src/IFeishuTenantApi.cs b/src/IFeishuTenantApi.cs index 15be5b78..4bcae972 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-12-08 +// Last Modified On : 2024-12-12 // ************************************************************************ // // MIT @@ -10617,7 +10617,7 @@ System.Threading.Tasks.Task DeleteVcV1ReservesByReserveIdAsync( [PathQuery] string? user_id_type = "open_id"); /// - /// 【招聘】获取人才信息 V1 + /// 【招聘】获取人才信息 /// 接口ID：6964264269274611714 /// 接口文档：https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent/get /// Authorization：tenant_access_token @@ -10804,7 +10804,7 @@ System.Threading.Tasks.Task PostHireV1ApplicationsByApplicationI /// /// 路径参数 /// 必填：是 - /// 投递 ID + /// 投递 ID，可通过[获取投递列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/list)获取 /// 示例值：6949805467799537964 /// /// @@ -10989,7 +10989,7 @@ System.Threading.Tasks.Task PostHireV1ApplicationsByApplicationI /// /// 路径参数 /// 必填：是 - /// 投递ID，详情请参考：[获取投递列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/list) + /// 投递ID，可通过[获取投递列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/list)获取 /// 示例值：6949805467799537964 /// /// @@ -41495,6 +41495,7 @@ System.Threading.Tasks.Task PostApaasV1ApprovalTasksByApprovalTa /// 获取面试评价表信息列表，评价表信息包括题目描述、题目选项等。可用于面试评价表展示等场景。 /// ## 注意事项 /// - 面试评价表通过版本进行变更管理，每次修改评价表都会更新版本，同时变更评价表ID、模块ID、模块维度ID、选项ID、能力项ID。 + /// - 当使用分页方式获取数据时，仅能获取到最新版本的面试评价表，当指定面试评价表 ID 列表时，可以获取到历史版本面评评价表。 /// ## 面试评价表产品示意图 /// 权限要求： /// hire:interview @@ -41503,7 +41504,7 @@ System.Threading.Tasks.Task PostApaasV1ApprovalTasksByApprovalTa /// /// /// 必填：否 - /// 面试评价表ID列表, 如果使用此字段则会忽略其他参数 + /// 面试评价表 ID 列表，使用此参数时不再分页 /// 默认值：null /// /// @@ -41524,6 +41525,92 @@ System.Threading.Tasks.Task PostApaasV1ApprovalTasksByApprovalTa [PathQuery] int? page_size = 10, [PathQuery] string? page_token = null); + /// + /// 【招聘】获取面试评价详细信息（新版） + /// 接口ID：7356428725080358914 + /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/hire-v2/interview_record/get + /// Authorization：tenant_access_token、user_access_token + /// 获取面试评价详细信息，如面试结论、面试得分和面试官等信息。 + /// 权限要求： + /// hire:interview + /// hire:interview:readonly + /// + /// 字段权限要求： + /// contact:user.employee_id:readonly + /// + /// + /// + /// 路径参数 + /// 必填：是 + /// 面试评价 ID，可通过[获取面试信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/interview/list)接口获取 + /// 示例值：7171693733661327361 + /// + /// + /// 必填：否 + /// 用户 ID 类型 + /// 示例值：open_id + /// + /// open_id：标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。[了解更多：如何获取 Open ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid) + /// union_id：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。[了解更多：如何获取 Union ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-union-id) + /// user_id：标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。[了解更多：如何获取 User ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-user-id) + /// + /// 默认值：open_id + /// + [HttpGet("/open-apis/hire/v2/interview_records/{interview_record_id}")] + System.Threading.Tasks.Task> GetHireV2InterviewRecordsByInterviewRecordIdAsync( + [PathQuery] string interview_record_id, + [PathQuery] string? user_id_type = "open_id"); + + /// + /// 【招聘】批量获取面试评价详细信息（新版） + /// 接口ID：7356428725080375298 + /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/hire-v2/interview_record/list + /// Authorization：tenant_access_token、user_access_token + /// 批量获取面试评价详细信息，如面试结论、面试得分和面试官等信息。 + /// 权限要求： + /// hire:interview + /// hire:interview:readonly + /// + /// 字段权限要求： + /// contact:user.employee_id:readonly + /// + /// + /// + /// 必填：否 + /// 面试评价 ID 列表，可通过[获取面试信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/interview/list)接口获取，使用该筛选项时不会分页 + /// 默认值：null + /// + /// + /// 必填：否 + /// 分页大小 + /// **注意**：若不传该参数，则默认根据 `ids` 参数获取数据 + /// 示例值：10 + /// 默认值：10 + /// + /// + /// 必填：否 + /// 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果 + /// 示例值：eVQrYzJBNDNONlk4VFZBZVlSdzlKdFJ4bVVHVExENDNKVHoxaVdiVnViQT0= + /// 默认值：null + /// + /// + /// 必填：否 + /// 用户 ID 类型 + /// 示例值：open_id + /// + /// open_id：标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。[了解更多：如何获取 Open ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid) + /// union_id：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。[了解更多：如何获取 Union ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-union-id) + /// user_id：标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。[了解更多：如何获取 User ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-user-id) + /// + /// 默认值：open_id + /// + [HttpGet("/open-apis/hire/v2/interview_records")] + System.Threading.Tasks.Task> GetHireV2InterviewRecordsAsync( + [PathQuery] string[]? ids = null, + [PathQuery] int? page_size = 10, + [PathQuery] string? page_token = null, + [PathQuery] string? user_id_type = "open_id"); + /// /// 【飞书人事（企业版）】操作员工完成入职 /// 接口ID：7357756972752699394 @@ -44325,7 +44412,7 @@ System.Threading.Tasks.Task GetBoardV1WhiteboardsByWhiteboa /// /// /// 必填：否 - /// ID 列表 + /// 标签 ID 列表 /// 默认值：null /// /// @@ -46168,5 +46255,163 @@ System.Threading.Tasks.Task PostCorehrV2OffboardingsRevokeAsync( [PathQuery] string @namespace, [PathQuery] string flow_id, [JsonContent] AppEngine.PostApaasV1ApplicationsByNamespaceFlowsByFlowIdExecuteBodyDto dto); + + /// + /// 【飞书人事（企业版）】批量删除填报行 + /// 接口ID：7446337145820053508 + /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/report_detail_row/batchDelete + /// Authorization：tenant_access_token + /// 批量删除填报行后，可在【设置-编制规划设置-编制规划XXX-集中填报】进行查看。 + /// 权限要求： + /// corehr:workforce_plan_centralized_reporting_project_detail:write + /// + /// + /// 请求体 + [HttpPost("/open-apis/corehr/v2/report_detail_row/batchDelete")] + System.Threading.Tasks.Task PostCorehrV2ReportDetailRowBatchDeleteAsync( + [JsonContent] Corehr.PostCorehrV2ReportDetailRowBatchDeleteBodyDto dto); + + /// + /// 【飞书人事（企业版）】批量创建/更新填报行 + /// 接口ID：7446337145820069892 + /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/report_detail_row/batchSave + /// Authorization：tenant_access_token + /// 批量创建/更新填报行后，可在【设置-编制规划设置-编制规划XXX-集中填报】进行查看。 + /// 权限要求： + /// corehr:workforce_plan_centralized_reporting_project_detail:write + /// + /// + /// 请求体 + [HttpPost("/open-apis/corehr/v2/report_detail_row/batchSave")] + System.Threading.Tasks.Task PostCorehrV2ReportDetailRowBatchSaveAsync( + [JsonContent] Corehr.PostCorehrV2ReportDetailRowBatchSaveBodyDto dto); + + /// + /// 【飞书人事（企业版）】批量删除明细行 + /// 接口ID：7446337145820086276 + /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/workforce_plan_detail_row/batchDelete + /// Authorization：tenant_access_token + /// 批量删除明细行后，可在【设置-编制规划设置-编制规划XXX-编辑数据】进行查看明细行是否被删除。 + /// 权限要求： + /// corehr:workforce_detail:write + /// + /// + /// 请求体 + [HttpPost("/open-apis/corehr/v2/workforce_plan_detail_row/batchDelete")] + System.Threading.Tasks.Task PostCorehrV2WorkforcePlanDetailRowBatchDeleteAsync( + [JsonContent] Corehr.PostCorehrV2WorkforcePlanDetailRowBatchDeleteBodyDto dto); + + /// + /// 【飞书人事（企业版）】批量创建/更新明细行 + /// 接口ID：7446337145820102660 + /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/workforce_plan_detail_row/batchSave + /// Authorization：tenant_access_token + /// 批量创建/更新明细行后，可在【设置-编制规划设置-编制规划XXX-编辑数据】进行查看。 + /// 权限要求： + /// corehr:workforce_detail:write + /// + /// + /// 请求体 + [HttpPost("/open-apis/corehr/v2/workforce_plan_detail_row/batchSave")] + System.Threading.Tasks.Task PostCorehrV2WorkforcePlanDetailRowBatchSaveAsync( + [JsonContent] Corehr.PostCorehrV2WorkforcePlanDetailRowBatchSaveBodyDto dto); + + /// + /// 【考勤打卡】创建或修改临时排班 + /// 接口ID：7446612629576892419 + /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_daily_shift/batch_create_temp + /// Authorization：tenant_access_token、user_access_token + /// 可在排班表上创建或修改临时班次，并用于排班。目前支持按日期对一位或多位人员进行排临时班次。 + /// 临时排班为付费功能，如需使用请联系您的客户经理。 + /// 权限要求： + /// attendance:rule + /// + /// + /// + /// 必填：是 + /// 请求体和响应体中的 user_id 的员工ID类型。如果没有后台管理权限，可使用[通过手机号或邮箱获取用户 ID](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/batch_get_id) + /// 示例值：employee_id + /// + /// employee_id：员工 employee ID，即[飞书管理后台](https://example.feishu.cn/admin/contacts/departmentanduser) > 组织架构 > 成员与部门 > 成员详情中的用户 ID + /// employee_no：员工工号，即[飞书管理后台](https://example.feishu.cn/admin/contacts/departmentanduser) > 组织架构 > 成员与部门 > 成员详情中的工号 + /// + /// + /// 请求体 + [HttpPost("/open-apis/attendance/v1/user_daily_shifts/batch_create_temp")] + System.Threading.Tasks.Task> PostAttendanceV1UserDailyShiftsBatchCreateTempAsync( + [PathQuery] string employee_type, + [JsonContent] Attendance.PostAttendanceV1UserDailyShiftsBatchCreateTempBodyDto dto); + + /// + /// 【多维表格】列出自动化流程 + /// 接口ID：7447033368182571009 + /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-workflow/list + /// Authorization：tenant_access_token、user_access_token + /// 该接口用于列出多维表格的自动化流程。 + /// 权限要求： + /// bitable:app + /// bitable:app:readonly + /// + /// + /// + /// 路径参数 + /// 必填：是 + /// 多维表格 App 的唯一标识。不同形态的多维表格，其 `app_token` 的获取方式不同： + /// - 如果多维表格的 URL 以 ==**feishu.cn/base**== 开头，该多维表格的 `app_token` 是下图高亮部分： + /// ![app_token.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/6916f8cfac4045ba6585b90e3afdfb0a_GxbfkJHZBa.png?height=766&lazyload=true&width=3004) + /// - 如果多维表格的 URL 以 ==**feishu.cn/wiki**== 开头，你需调用知识库相关[获取知识空间节点信息](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space/get_node)接口获取多维表格的 app_token。当 `obj_type` 的值为 `bitable` 时，`obj_token` 字段的值才是多维表格的 `app_token`。 + /// 了解更多，参考[多维表格 app_token 获取方式](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/bitable-overview#-752212c)。 + /// 示例值：appbcbWCzen6D8dezhoCH2RpMAh + /// + /// + /// 必填：否 + /// 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果 + /// 示例值：eVQrYzJBNDNONlk4VFZBZVlSdzlKdFJ4bVVHVExENDNKVHoxaVdiVnViQT0= + /// 默认值：null + /// + /// + /// 必填：否 + /// 分页大小 + /// 示例值：10 + /// 默认值：20 + /// + [HttpGet("/open-apis/bitable/v1/apps/{app_token}/workflows")] + System.Threading.Tasks.Task> GetBitableV1AppsByAppTokenWorkflowsAsync( + [PathQuery] string app_token, + [PathQuery] string? page_token = null, + [PathQuery] int? page_size = 20); + + /// + /// 【多维表格】更新自动化流程状态 + /// 接口ID：7447033368182587393 + /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-workflow/update + /// Authorization：tenant_access_token、user_access_token + /// 开启或关闭自动化流程。 + /// 权限要求： + /// bitable:app + /// + /// + /// + /// 路径参数 + /// 必填：是 + /// 多维表格 App 的唯一标识。不同形态的多维表格，其 `app_token` 的获取方式不同： + /// - 如果多维表格的 URL 以 ==**feishu.cn/base**== 开头，该多维表格的 `app_token` 是下图高亮部分： + /// ![app_token.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/6916f8cfac4045ba6585b90e3afdfb0a_GxbfkJHZBa.png?height=766&lazyload=true&width=3004) + /// - 如果多维表格的 URL 以 ==**feishu.cn/wiki**== 开头，你需调用知识库相关[获取知识空间节点信息](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space/get_node)接口获取多维表格的 app_token。当 `obj_type` 的值为 `bitable` 时，`obj_token` 字段的值才是多维表格的 `app_token`。 + /// 了解更多，参考[多维表格 app_token 获取方式](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/bitable-overview#-752212c)。 + /// 示例值：appbcbWCzen6D8dezh + /// + /// + /// 路径参数 + /// 必填：是 + /// 自动化工作流 ID，通过[列出自动化流程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-workflow/list)接口获取。 + /// 示例值：730887xxxx552638996 + /// + /// 请求体 + [HttpPut("/open-apis/bitable/v1/apps/{app_token}/workflows/{workflow_id}")] + System.Threading.Tasks.Task PutBitableV1AppsByAppTokenWorkflowsByWorkflowIdAsync( + [PathQuery] string app_token, + [PathQuery] string workflow_id, + [JsonContent] Base.PutBitableV1AppsByAppTokenWorkflowsByWorkflowIdBodyDto dto); } diff --git a/src/IFeishuUserApi.cs b/src/IFeishuUserApi.cs index 090fc032..3e6dc86e 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-11-22 +// Last Modified On : 2024-12-12 // ************************************************************************ // // MIT @@ -18955,6 +18955,96 @@ System.Threading.Tasks.Task DeleteAcsV1VisitorsByVisitorIdAsync( [PathQuery] bool? force_submit = false, [PathQuery] bool? ignore_working_hours_type_rule = false); + /// + /// 【招聘】获取面试评价详细信息（新版） + /// 接口ID：7356428725080358914 + /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/hire-v2/interview_record/get + /// Authorization：tenant_access_token、user_access_token + /// 获取面试评价详细信息，如面试结论、面试得分和面试官等信息。 + /// 权限要求： + /// hire:interview + /// hire:interview:readonly + /// + /// 字段权限要求： + /// contact:user.employee_id:readonly + /// + /// + /// + /// 路径参数 + /// 必填：是 + /// 面试评价 ID，可通过[获取面试信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/interview/list)接口获取 + /// 示例值：7171693733661327361 + /// + /// + /// 必填：否 + /// 用户 ID 类型 + /// 示例值：open_id + /// + /// open_id：标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。[了解更多：如何获取 Open ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid) + /// union_id：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。[了解更多：如何获取 Union ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-union-id) + /// user_id：标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。[了解更多：如何获取 User ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-user-id) + /// + /// 默认值：open_id + /// + /// 用户凭证 + [HttpGet("/open-apis/hire/v2/interview_records/{interview_record_id}")] + System.Threading.Tasks.Task> GetHireV2InterviewRecordsByInterviewRecordIdAsync( + UserAccessToken access_token, + [PathQuery] string interview_record_id, + [PathQuery] string? user_id_type = "open_id"); + + /// + /// 【招聘】批量获取面试评价详细信息（新版） + /// 接口ID：7356428725080375298 + /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/hire-v2/interview_record/list + /// Authorization：tenant_access_token、user_access_token + /// 批量获取面试评价详细信息，如面试结论、面试得分和面试官等信息。 + /// 权限要求： + /// hire:interview + /// hire:interview:readonly + /// + /// 字段权限要求： + /// contact:user.employee_id:readonly + /// + /// + /// + /// 必填：否 + /// 面试评价 ID 列表，可通过[获取面试信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/interview/list)接口获取，使用该筛选项时不会分页 + /// 默认值：null + /// + /// + /// 必填：否 + /// 分页大小 + /// **注意**：若不传该参数，则默认根据 `ids` 参数获取数据 + /// 示例值：10 + /// 默认值：10 + /// + /// + /// 必填：否 + /// 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果 + /// 示例值：eVQrYzJBNDNONlk4VFZBZVlSdzlKdFJ4bVVHVExENDNKVHoxaVdiVnViQT0= + /// 默认值：null + /// + /// + /// 必填：否 + /// 用户 ID 类型 + /// 示例值：open_id + /// + /// open_id：标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。[了解更多：如何获取 Open ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid) + /// union_id：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。[了解更多：如何获取 Union ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-union-id) + /// user_id：标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。[了解更多：如何获取 User ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-user-id) + /// + /// 默认值：open_id + /// + /// 用户凭证 + [HttpGet("/open-apis/hire/v2/interview_records")] + System.Threading.Tasks.Task> GetHireV2InterviewRecordsAsync( + UserAccessToken access_token, + [PathQuery] string[]? ids = null, + [PathQuery] int? page_size = 10, + [PathQuery] string? page_token = null, + [PathQuery] string? user_id_type = "open_id"); + /// /// 【智能伙伴创建平台】获取智能伙伴消息 /// 接口ID：7358047310868152324 @@ -20080,5 +20170,109 @@ System.Threading.Tasks.Task GetBoardV1WhiteboardsByWhiteboa [PathQuery] int member_clock_type, [PathQuery] int? page_size = 10, [PathQuery] string? page_token = null); + + /// + /// 【考勤打卡】创建或修改临时排班 + /// 接口ID：7446612629576892419 + /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_daily_shift/batch_create_temp + /// Authorization：tenant_access_token、user_access_token + /// 可在排班表上创建或修改临时班次，并用于排班。目前支持按日期对一位或多位人员进行排临时班次。 + /// 临时排班为付费功能，如需使用请联系您的客户经理。 + /// 权限要求： + /// attendance:rule + /// + /// + /// + /// 必填：是 + /// 请求体和响应体中的 user_id 的员工ID类型。如果没有后台管理权限，可使用[通过手机号或邮箱获取用户 ID](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/batch_get_id) + /// 示例值：employee_id + /// + /// employee_id：员工 employee ID，即[飞书管理后台](https://example.feishu.cn/admin/contacts/departmentanduser) > 组织架构 > 成员与部门 > 成员详情中的用户 ID + /// employee_no：员工工号，即[飞书管理后台](https://example.feishu.cn/admin/contacts/departmentanduser) > 组织架构 > 成员与部门 > 成员详情中的工号 + /// + /// + /// 请求体 + /// 用户凭证 + [HttpPost("/open-apis/attendance/v1/user_daily_shifts/batch_create_temp")] + System.Threading.Tasks.Task> PostAttendanceV1UserDailyShiftsBatchCreateTempAsync( + UserAccessToken access_token, + [PathQuery] string employee_type, + [JsonContent] Attendance.PostAttendanceV1UserDailyShiftsBatchCreateTempBodyDto dto); + + /// + /// 【多维表格】列出自动化流程 + /// 接口ID：7447033368182571009 + /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-workflow/list + /// Authorization：tenant_access_token、user_access_token + /// 该接口用于列出多维表格的自动化流程。 + /// 权限要求： + /// bitable:app + /// bitable:app:readonly + /// + /// + /// + /// 路径参数 + /// 必填：是 + /// 多维表格 App 的唯一标识。不同形态的多维表格，其 `app_token` 的获取方式不同： + /// - 如果多维表格的 URL 以 ==**feishu.cn/base**== 开头，该多维表格的 `app_token` 是下图高亮部分： + /// ![app_token.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/6916f8cfac4045ba6585b90e3afdfb0a_GxbfkJHZBa.png?height=766&lazyload=true&width=3004) + /// - 如果多维表格的 URL 以 ==**feishu.cn/wiki**== 开头，你需调用知识库相关[获取知识空间节点信息](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space/get_node)接口获取多维表格的 app_token。当 `obj_type` 的值为 `bitable` 时，`obj_token` 字段的值才是多维表格的 `app_token`。 + /// 了解更多，参考[多维表格 app_token 获取方式](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/bitable-overview#-752212c)。 + /// 示例值：appbcbWCzen6D8dezhoCH2RpMAh + /// + /// + /// 必填：否 + /// 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果 + /// 示例值：eVQrYzJBNDNONlk4VFZBZVlSdzlKdFJ4bVVHVExENDNKVHoxaVdiVnViQT0= + /// 默认值：null + /// + /// + /// 必填：否 + /// 分页大小 + /// 示例值：10 + /// 默认值：20 + /// + /// 用户凭证 + [HttpGet("/open-apis/bitable/v1/apps/{app_token}/workflows")] + System.Threading.Tasks.Task> GetBitableV1AppsByAppTokenWorkflowsAsync( + UserAccessToken access_token, + [PathQuery] string app_token, + [PathQuery] string? page_token = null, + [PathQuery] int? page_size = 20); + + /// + /// 【多维表格】更新自动化流程状态 + /// 接口ID：7447033368182587393 + /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-workflow/update + /// Authorization：tenant_access_token、user_access_token + /// 开启或关闭自动化流程。 + /// 权限要求： + /// bitable:app + /// + /// + /// + /// 路径参数 + /// 必填：是 + /// 多维表格 App 的唯一标识。不同形态的多维表格，其 `app_token` 的获取方式不同： + /// - 如果多维表格的 URL 以 ==**feishu.cn/base**== 开头，该多维表格的 `app_token` 是下图高亮部分： + /// ![app_token.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/6916f8cfac4045ba6585b90e3afdfb0a_GxbfkJHZBa.png?height=766&lazyload=true&width=3004) + /// - 如果多维表格的 URL 以 ==**feishu.cn/wiki**== 开头，你需调用知识库相关[获取知识空间节点信息](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space/get_node)接口获取多维表格的 app_token。当 `obj_type` 的值为 `bitable` 时，`obj_token` 字段的值才是多维表格的 `app_token`。 + /// 了解更多，参考[多维表格 app_token 获取方式](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/bitable-overview#-752212c)。 + /// 示例值：appbcbWCzen6D8dezh + /// + /// + /// 路径参数 + /// 必填：是 + /// 自动化工作流 ID，通过[列出自动化流程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-workflow/list)接口获取。 + /// 示例值：730887xxxx552638996 + /// + /// 请求体 + /// 用户凭证 + [HttpPut("/open-apis/bitable/v1/apps/{app_token}/workflows/{workflow_id}")] + System.Threading.Tasks.Task PutBitableV1AppsByAppTokenWorkflowsByWorkflowIdAsync( + UserAccessToken access_token, + [PathQuery] string app_token, + [PathQuery] string workflow_id, + [JsonContent] Base.PutBitableV1AppsByAppTokenWorkflowsByWorkflowIdBodyDto dto); }