From 14ec2fc07504c4bdd44dffa96cd71ef2c5431ec4 Mon Sep 17 00:00:00 2001 From: "Vicente.Yu" <^@^> Date: Wed, 18 Sep 2024 22:44:59 +0800 Subject: [PATCH] =?UTF-8?q?=E6=96=B0=E5=A2=9E=20-=20=E3=80=90=E9=A3=9E?= =?UTF-8?q?=E4=B9=A6=E4=BA=BA=E4=BA=8B=EF=BC=88=E4=BC=81=E4=B8=9A=E7=89=88?= =?UTF-8?q?=EF=BC=89=E3=80=91=E5=BA=8F=E5=88=97=E5=88=9B=20=E4=BA=8B?= =?UTF-8?q?=E4=BB=B6=E4=BD=93=20-=20=E3=80=90=E9=A3=9E=E4=B9=A6=E4=BA=BA?= =?UTF-8?q?=E4=BA=8B=EF=BC=88=E4=BC=81=E4=B8=9A=E7=89=88=EF=BC=89=E3=80=91?= =?UTF-8?q?=E5=BA=8F=E5=88=97=E6=9B=B4=E6=96=B0=20=E4=BA=8B=E4=BB=B6?= =?UTF-8?q?=E4=BD=93=20-=20=E3=80=90=E9=A3=9E=E4=B9=A6=E4=BA=BA=E4=BA=8B?= =?UTF-8?q?=EF=BC=88=E4=BC=81=E4=B8=9A=E7=89=88=EF=BC=89=E3=80=91=E5=BA=8F?= =?UTF-8?q?=E5=88=97=E5=88=A0=E9=99=A4=20=E4=BA=8B=E4=BB=B6=E4=BD=93=20-?= =?UTF-8?q?=20=E3=80=90=E9=A3=9E=E4=B9=A6=E4=BA=BA=E4=BA=8B=EF=BC=88?= =?UTF-8?q?=E4=BC=81=E4=B8=9A=E7=89=88=EF=BC=89=E3=80=91=E8=81=8C=E7=BA=A7?= =?UTF-8?q?=E5=88=9B=E5=BB=BA=20=E4=BA=8B=E4=BB=B6=E4=BD=93=20-=20?= =?UTF-8?q?=E3=80=90=E9=A3=9E=E4=B9=A6=E4=BA=BA=E4=BA=8B=EF=BC=88=E4=BC=81?= =?UTF-8?q?=E4=B8=9A=E7=89=88=EF=BC=89=E3=80=91=E8=81=8C=E7=BA=A7=E6=9B=B4?= =?UTF-8?q?=E6=96=B0=20=E4=BA=8B=E4=BB=B6=E4=BD=93=20-=20=E3=80=90?= =?UTF-8?q?=E9=A3=9E=E4=B9=A6=E4=BA=BA=E4=BA=8B=EF=BC=88=E4=BC=81=E4=B8=9A?= =?UTF-8?q?=E7=89=88=EF=BC=89=E3=80=91=E8=81=8C=E7=BA=A7=E5=88=A0=E9=99=A4?= =?UTF-8?q?=20=E4=BA=8B=E4=BB=B6=E4=BD=93=20-=20=E3=80=90=E9=A3=9E?= =?UTF-8?q?=E4=B9=A6=E4=BA=BA=E4=BA=8B=EF=BC=88=E4=BC=81=E4=B8=9A=E7=89=88?= =?UTF-8?q?=EF=BC=89=E3=80=91=E6=9F=A5=E8=AF=A2=E7=BC=96=E5=88=B6=E8=A7=84?= =?UTF-8?q?=E5=88=92=E6=98=8E=E7=BB=86=E4=BF=A1=E6=81=AF=20-=20=E3=80=90?= =?UTF-8?q?=E9=A3=9E=E4=B9=A6=E4=BA=BA=E4=BA=8B=EF=BC=88=E4=BC=81=E4=B8=9A?= =?UTF-8?q?=E7=89=88=EF=BC=89=E3=80=91=E6=9F=A5=E8=AF=A2=E9=83=A8=E9=97=A8?= =?UTF-8?q?=E5=8F=98=E6=9B=B4=E8=AE=B0=E5=BD=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 变更 - 创建审批实例 请求体 - 复制多维表格 响应体 - 搜索 Wiki 响应体 Signed-off-by: Vicente.Yu <^@^> --- EventCallbackList.md | 8 +- .../FeishuNetSdk.WebSocket.csproj | 2 +- FeishuNetSdk.WebSocket/WssService.cs | 4 +- README.md | 6 +- TenantAccessList.md | 118 +++++----- UserAccessList.md | 46 ++-- ...icationApplicationCreatedV6EventBodyDto.cs | 2 +- ...pplicationVisibilityAddedV6EventBodyDto.cs | 18 +- .../PostApprovalV4ExternalInstancesBodyDto.cs | 2 +- .../PostApprovalV4InstancesBodyDto.cs | 59 ++++- ...stAuthenV1OidcRefreshAccessTokenBodyDto.cs | 2 +- ...leIdFormsByFormIdFieldsByFieldIdBodyDto.cs | 12 +- ...FormsByFormIdFieldsByFieldIdResponseDto.cs | 11 +- .../PostBitableV1AppsByAppTokenCopyBodyDto.cs | 2 +- ...tBitableV1AppsByAppTokenCopyResponseDto.cs | 14 +- .../PostWikiV1NodesSearchResponseDto.cs | 29 ++- src/Core/EventDto.cs | 14 +- .../CorehrJobFamilyCreatedV2EventBodyDto.cs | 31 +++ .../CorehrJobFamilyDeletedV2EventBodyDto.cs | 31 +++ .../CorehrJobFamilyUpdatedV2EventBodyDto.cs | 40 ++++ .../CorehrJobLevelCreatedV2EventBodyDto.cs | 31 +++ .../CorehrJobLevelDeletedV2EventBodyDto.cs | 31 +++ .../CorehrJobLevelUpdatedV2EventBodyDto.cs | 39 ++++ ...DepartmentsQueryRecentChangeResponseDto.cs | 59 +++++ ...orehrV2CostCentersByCostCenterIdBodyDto.cs | 7 +- ...rV2CostCentersByCostCenterIdResponseDto.cs | 20 +- ...yCostCenterIdVersionsByVersionIdBodyDto.cs | 13 +- ...tCenterIdVersionsByVersionIdResponseDto.cs | 14 +- src/Corehr/PostCorehrV2CostCentersBodyDto.cs | 18 +- ...ostCentersByCostCenterIdVersionsBodyDto.cs | 3 +- ...entersByCostCenterIdVersionsResponseDto.cs | 14 +- .../PostCorehrV2CostCentersResponseDto.cs | 10 +- .../PostCorehrV2DepartmentsTreeResponseDto.cs | 2 + ...orehrV2WorkforcePlanDetailsBatchBodyDto.cs | 124 +++++++++++ ...rV2WorkforcePlanDetailsBatchResponseDto.cs | 205 ++++++++++++++++++ src/FeishuNetSdk.csproj | 2 +- .../CorehrJobCreatedV1EventBodyDto.cs | 4 +- .../CorehrJobUpdatedV1EventBodyDto.cs | 4 +- .../GetCorehrV1JobsByJobIdResponseDto.cs | 22 +- ...CorehrV1JobFamiliesByJobFamilyIdBodyDto.cs | 45 ++-- ...hrV1JobFamiliesByJobFamilyIdResponseDto.cs | 23 +- ...tchCorehrV1JobLevelsByJobLevelIdBodyDto.cs | 25 ++- ...orehrV1JobLevelsByJobLevelIdResponseDto.cs | 16 +- .../PatchCorehrV1JobsByJobIdBodyDto.cs | 46 ++-- .../PatchCorehrV1JobsByJobIdResponseDto.cs | 26 ++- .../PostCorehrV1JobFamiliesBodyDto.cs | 39 ++-- .../PostCorehrV1JobFamiliesResponseDto.cs | 25 ++- .../PostCorehrV1JobLevelsBodyDto.cs | 31 +-- .../PostCorehrV1JobLevelsResponseDto.cs | 14 +- src/FeishuPeople/PostCorehrV1JobsBodyDto.cs | 47 ++-- .../PostCorehrV1JobsResponseDto.cs | 36 +-- ...tHelpdeskV1TicketsByTicketIdResponseDto.cs | 4 +- ...ostHireV1JobsByJobIdUpdateConfigBodyDto.cs | 12 +- src/IFeishuTenantApi.cs | 158 +++++++++++--- src/IFeishuUserApi.cs | 20 +- 55 files changed, 1289 insertions(+), 351 deletions(-) rename src/{Base.Spec => Base}/PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFieldsByFieldIdBodyDto.cs (89%) rename src/{Base.Spec => Base}/PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFieldsByFieldIdResponseDto.cs (88%) create mode 100644 src/Corehr.Events/CorehrJobFamilyCreatedV2EventBodyDto.cs create mode 100644 src/Corehr.Events/CorehrJobFamilyDeletedV2EventBodyDto.cs create mode 100644 src/Corehr.Events/CorehrJobFamilyUpdatedV2EventBodyDto.cs create mode 100644 src/Corehr.Events/CorehrJobLevelCreatedV2EventBodyDto.cs create mode 100644 src/Corehr.Events/CorehrJobLevelDeletedV2EventBodyDto.cs create mode 100644 src/Corehr.Events/CorehrJobLevelUpdatedV2EventBodyDto.cs create mode 100644 src/Corehr/GetCorehrV2DepartmentsQueryRecentChangeResponseDto.cs create mode 100644 src/Corehr/PostCorehrV2WorkforcePlanDetailsBatchBodyDto.cs create mode 100644 src/Corehr/PostCorehrV2WorkforcePlanDetailsBatchResponseDto.cs diff --git a/EventCallbackList.md b/EventCallbackList.md index 9a322150..083a3048 100644 --- a/EventCallbackList.md +++ b/EventCallbackList.md @@ -1,4 +1,4 @@ -## 事件回调类型清单 +## 事件回调类型清单 @@ -23,8 +23,14 @@ + + + + + + diff --git a/FeishuNetSdk.WebSocket/FeishuNetSdk.WebSocket.csproj b/FeishuNetSdk.WebSocket/FeishuNetSdk.WebSocket.csproj index cc14a2b5..c4720de0 100644 --- a/FeishuNetSdk.WebSocket/FeishuNetSdk.WebSocket.csproj +++ b/FeishuNetSdk.WebSocket/FeishuNetSdk.WebSocket.csproj @@ -16,7 +16,7 @@ MIT适用于飞书开放平台的.Net开发包LICENSE - 3.0.1 + 3.0.2 diff --git a/FeishuNetSdk.WebSocket/WssService.cs b/FeishuNetSdk.WebSocket/WssService.cs index 6b1a541c..8ccda95c 100644 --- a/FeishuNetSdk.WebSocket/WssService.cs +++ b/FeishuNetSdk.WebSocket/WssService.cs @@ -123,9 +123,11 @@ private async void MessageReceived(object? sender, MessageReceivedEventArgs e) } } - private void ServerDisconnected(object? sender, EventArgs e) + private async void ServerDisconnected(object? sender, EventArgs e) { logger.LogInformation("长连接已断开"); + + await StartConnectAsync(); } private void ServerConnected(object? sender, EventArgs e) diff --git a/README.md b/README.md index 1a67dd53..da5d0116 100644 --- a/README.md +++ b/README.md @@ -119,7 +119,9 @@ public class TestController : ControllerBase 事件体类型参照：[事件回调类型清单](https://github.com/vicenteyu/FeishuNetSdk/blob/main/EventCallbackList.md) **注意：需要3秒内响应。** -**规则上允许，但不建议：同一事件有多个继承类，可以同时执行不同内容，但任何一个超时或失败都会导致返回失败结果。** + +**规则上允许，但不建议：同一事件有多个派生类，可以同时执行，但任何一个超时或失败都会导致返回失败结果。** + **相同的事件消息可能会推送多次，原因例如日志上没有显示超时，但服务端判断已经超时。可以使用`完整消息体`上的`EventId`属性进行重复判断。** ```csharp @@ -145,7 +147,9 @@ public class EventHandler1(ILogger logger) : IEventHandler - + @@ -259,7 +259,7 @@ - + @@ -343,7 +343,7 @@ - + @@ -365,33 +365,33 @@ - + - + - + - + - + - + - + - + - + - + - + - + - + @@ -667,7 +667,7 @@ - + @@ -691,7 +691,7 @@ - + @@ -709,17 +709,17 @@ - + - + - + @@ -735,7 +735,7 @@ - + @@ -751,19 +751,19 @@ - + - + - + @@ -793,7 +793,7 @@ - + @@ -1111,7 +1111,7 @@ - + @@ -1333,7 +1333,7 @@ - + @@ -1395,7 +1395,7 @@ - + @@ -1415,11 +1415,11 @@ - + - + - + @@ -1429,29 +1429,29 @@ - + - + - + - + - + - + - + - + - + @@ -1543,7 +1543,7 @@ - + @@ -1579,7 +1579,7 @@ - + @@ -1777,7 +1777,7 @@ - + @@ -1787,9 +1787,9 @@ - + - + @@ -2019,17 +2019,17 @@ - + - + - + - + - + @@ -2209,7 +2209,7 @@ - + @@ -2359,7 +2359,7 @@ - + @@ -2379,12 +2379,16 @@ - + - + - + - + + + + +
事件代码事件类型描述
approval.approval.updated_v4EventV2Dto<Approval.Events.ApprovalApprovalUpdatedV4EventBodyDto>【审批】审批定义更新
approval.instance.trip_group_update_v4EventV2Dto<Approval.Events.ApprovalInstanceTripGroupUpdateV4EventBodyDto>【审批】出差审批
corehr.employee.domain_event_v2EventV2Dto<Corehr.Events.CorehrEmployeeDomainEventV2EventBodyDto>【飞书人事（企业版）】人员信息变更
corehr.process.approver.updated_v2EventV2Dto<Corehr.Events.CorehrProcessApproverUpdatedV2EventBodyDto>【飞书人事（企业版）】审批任务状态变更
corehr.probation.updated_v2EventV2Dto<Corehr.Events.CorehrProbationUpdatedV2EventBodyDto>【飞书人事（企业版）】试用期状态变更
corehr.job_family.created_v2EventV2Dto<Corehr.Events.CorehrJobFamilyCreatedV2EventBodyDto>【飞书人事（企业版）】序列创建
corehr.job_family.updated_v2EventV2Dto<Corehr.Events.CorehrJobFamilyUpdatedV2EventBodyDto>【飞书人事（企业版）】序列更新
corehr.job_family.deleted_v2EventV2Dto<Corehr.Events.CorehrJobFamilyDeletedV2EventBodyDto>【飞书人事（企业版）】序列删除
corehr.job_change.updated_v2EventV2Dto<Corehr.Events.CorehrJobChangeUpdatedV2EventBodyDto>【飞书人事（企业版）】异动信息变更
corehr.job_change.status_updated_v2EventV2Dto<Corehr.Events.CorehrJobChangeStatusUpdatedV2EventBodyDto>【飞书人事（企业版）】异动状态变更
corehr.job_level.created_v2EventV2Dto<Corehr.Events.CorehrJobLevelCreatedV2EventBodyDto>【飞书人事（企业版）】职级创建
corehr.job_level.updated_v2EventV2Dto<Corehr.Events.CorehrJobLevelUpdatedV2EventBodyDto>【飞书人事（企业版）】职级更新
corehr.job_level.deleted_v2EventV2Dto<Corehr.Events.CorehrJobLevelDeletedV2EventBodyDto>【飞书人事（企业版）】职级删除
corehr.department.created_v1EventV2Dto<FeishuPeople.Events.CorehrDepartmentCreatedV1EventBodyDto>【飞书人事】【事件】创建部门
corehr.employment.created_v1EventV2Dto<FeishuPeople.Events.CorehrEmploymentCreatedV1EventBodyDto>【飞书人事】【事件】创建雇佣信息
corehr.person.created_v1EventV2Dto<FeishuPeople.Events.CorehrPersonCreatedV1EventBodyDto>【飞书人事】【事件】个人信息创建
PostDrivePermissionMemberList
792024-07-31✓云文档增加协作者权限
PostDriveV1PermissionsByTokenMembers
802024-07-05✓通讯录查询用户所属用户组
802024-09-14✓通讯录查询用户所属用户组
GetContactV3GroupMemberBelong
812024-07-31✓云文档更新协作者权限
PutDriveV1PermissionsByTokenMembersByMemberId
GetSheetsV2SpreadsheetsBySpreadsheetTokenValuesBatchGet
1302024-08-14✓云文档向多个范围写入数据
PostSheetsV2SpreadsheetsBySpreadsheetTokenValuesBatchUpdate
1312024-08-14✓云文档设置单元格样式
1312024-09-18✓云文档设置单元格样式
PutSheetsV2SpreadsheetsBySpreadsheetTokenStyle
1322024-08-14✓云文档批量设置单元格样式
PutSheetsV2SpreadsheetsBySpreadsheetTokenStylesBatchUpdate
PatchSheetsV3SpreadsheetsBySpreadsheetTokenSheetsBySheetIdFloatImagesByFloatImageId
1722024-09-09✓云文档删除浮动图片
DeleteSheetsV3SpreadsheetsBySpreadsheetTokenSheetsBySheetIdFloatImagesByFloatImageId
1732023-11-07✓多维表格复制多维表格
1732024-09-18✓多维表格复制多维表格
PostBitableV1AppsByAppTokenCopy
1742024-09-12✓多维表格创建多维表格
PostBitableV1Apps
PatchBitableV1AppsByAppTokenTablesByTableId
1832023-08-03✓多维表格列出数据表
GetBitableV1AppsByAppTokenTables
1842024-09-12✓多维表格复制仪表盘
1842024-09-18✓多维表格复制仪表盘
PostBitableV1AppsByAppTokenDashboardsByBlockIdCopy
1852023-08-03✓多维表格列出仪表盘
1852024-09-18✓多维表格列出仪表盘
GetBitableV1AppsByAppTokenDashboards
1862024-09-12✓多维表格更新视图
1862024-09-18✓多维表格更新视图
PatchBitableV1AppsByAppTokenTablesByTableIdViewsByViewId
1872024-09-12✓多维表格检索视图
1872024-09-18✓多维表格检索视图
GetBitableV1AppsByAppTokenTablesByTableIdViewsByViewId
1882024-09-12✓多维表格列出视图
1882024-09-18✓多维表格列出视图
GetBitableV1AppsByAppTokenTablesByTableIdViews
1892024-09-12✓多维表格新增视图
1892024-09-18✓多维表格新增视图
PostBitableV1AppsByAppTokenTablesByTableIdViews
1902024-09-12✓多维表格删除视图
1902024-09-18✓多维表格删除视图
DeleteBitableV1AppsByAppTokenTablesByTableIdViewsByViewId
1912024-07-05✓通讯录部门群转为普通群
PostContactV3DepartmentsUnbindDepartmentChat
1922023-11-07✓多维表格更新表单元数据
1922024-09-18✓多维表格更新表单元数据
PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormId
1932024-02-01✓多维表格获取表单元数据
1932024-09-18✓多维表格获取表单元数据
GetBitableV1AppsByAppTokenTablesByTableIdFormsByFormId
1942023-04-18✓多维表格更新表单问题
1942024-09-18✓多维表格更新表单问题
PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFieldsByFieldId
1952023-07-28✓多维表格列出表单问题
1952024-09-18✓多维表格列出表单问题
GetBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFields
1962024-07-31✓多维表格[不推荐] 检索记录
1962024-09-18✓多维表格[不推荐] 检索记录
GetBitableV1AppsByAppTokenTablesByTableIdRecordsByRecordId
1972024-07-31✓多维表格列出记录
1972024-09-18✓多维表格列出记录
GetBitableV1AppsByAppTokenTablesByTableIdRecords
1982024-09-12✓多维表格新增记录
PostBitableV1AppsByAppTokenTablesByTableIdRecords
PostAttendanceV1UserStatsViewsQuery
3342024-08-13✓考勤打卡查询统计数据
PostAttendanceV1UserStatsDatasQuery
3352024-07-05✓通讯录删除用户
3352024-09-14✓通讯录删除用户
DeleteContactV3UsersByUserId
3362024-07-05✓通讯录获取单位列表
GetContactV3Unit
PostAttendanceV1UserFlowsQuery
3462024-08-13✓考勤打卡查询打卡结果
PostAttendanceV1UserTasksQuery
3472024-07-05✓通讯录添加用户组成员
3472024-09-14✓通讯录添加用户组成员
PostContactV3GroupByGroupIdMemberAdd
3482024-08-28✓考勤打卡修改用户人脸识别信息
PostAttendanceV1UserSettingsModify
PostApprovalV4Approvals
3552024-03-01✓审批查看指定审批定义
GetApprovalV4ApprovalsByApprovalCode
3562024-03-27✓审批创建审批实例
3562024-09-18✓审批创建审批实例
PostApprovalV4Instances
3572023-09-19✓审批撤回审批实例
PostApprovalV4InstancesCancel
3582024-08-12✓通讯录批量添加用户组成员
3582024-09-14✓通讯录批量添加用户组成员
PostContactV3GroupByGroupIdMemberBatchAdd
3592022-12-28✓审批抄送审批实例
PostApprovalV4InstancesCc
3602024-04-28✓审批预览审批流程
PostApprovalV4InstancesPreview
3612023-11-02✓审批获取单个审批实例详情
3612024-09-13✓审批获取单个审批实例详情
GetApprovalV4InstancesByInstanceId
3622022-12-28✓审批批量获取审批实例 ID
GetApprovalV4Instances
PostApprovalV4InstancesAddSign
3682022-12-28✓审批重新提交审批任务
PostApprovalV4TasksResubmit
3692024-07-05✓通讯录移除用户组成员
3692024-09-14✓通讯录移除用户组成员
PostContactV3GroupByGroupIdMemberRemove
3702023-03-16✓审批上传文件
PostApprovalOpenapiV2FileUpload
PostApprovalV4ExternalApprovals
3762023-07-13✓审批查看指定三方审批定义
GetApprovalV4ExternalApprovalsByApprovalCode
3772024-08-14✓审批同步三方审批实例
3772024-09-18✓审批同步三方审批实例
PostApprovalV4ExternalInstances
3782022-12-28✓审批校验三方审批实例
PostApprovalV4ExternalInstancesCheck
3792024-08-14✓审批获取三方审批任务状态
GetApprovalV4ExternalTasks
3802024-08-12✓通讯录批量移除用户组成员
3802024-09-14✓通讯录批量移除用户组成员
PostContactV3GroupByGroupIdMemberBatchRemove
3812024-08-27✓审批发送审批 Bot 消息
PostApprovalV1MessageSend
3822024-01-26✓审批更新审批 Bot 消息
PostApprovalV1MessageUpdate
3832024-03-01✓审批查询实例列表
3832024-09-18✓审批查询实例列表
PostApprovalV4InstancesQuery
3842024-02-04✓审批查询抄送列表
PostApprovalV4InstancesSearchCc
GetHelpdeskV1AgentSkillRules
3972023-08-15✓服务台创建服务台对话
PostHelpdeskV1StartService
3982023-08-15✓服务台查询指定工单详情
3982024-09-18✓服务台查询指定工单详情
GetHelpdeskV1TicketsByTicketId
3992023-08-15✓服务台查询全部工单详情
GetHelpdeskV1Tickets
PatchApplicationV6ApplicationsByAppIdContactsRange
5562023-09-12✓应用信息获取用户可用的应用
GetApplicationV1UserVisibleApps
5572024-09-04✓通讯录修改用户部分信息
5572024-09-14✓通讯录修改用户部分信息
PatchContactV3UsersByUserId
5582024-07-05✓通讯录删除序列
DeleteContactV3JobFamiliesByJobFamilyId
GetCorehrV1WorkingHoursTypes
6672023-07-14✓飞书人事查询单个货币信息
GetCorehrV1CurrenciesByCurrencyId
6682024-09-02✓通讯录获取单个用户信息
6682024-09-14✓通讯录获取单个用户信息
GetContactV3UsersByUserId
6692024-08-09✓消息与群组编辑消息
PutImV1MessagesByMessageId
PostCorehrV2LocationsBatchGet
6982024-02-06✓飞书人事创建地点
PostCorehrV1Locations
6992024-08-28✓飞书人事删除地点
6992024-09-13✓飞书人事删除地点
DeleteCorehrV1LocationsByLocationId
7002024-08-28✓飞书人事查询单个地点
GetCorehrV1LocationsByLocationId
GetCorehrV1Companies
7082024-09-04✓飞书人事（企业版）通过职级 ID 批量获取职级信息
PostCorehrV2JobLevelsBatchGet
7092024-02-06✓飞书人事创建职级
7092024-09-13✓飞书人事新建职级
PostCorehrV1JobLevels
7102024-02-06✓飞书人事删除职级
7102024-09-13✓飞书人事删除职级
DeleteCorehrV1JobLevelsByJobLevelId
7112024-02-06✓飞书人事更新职级
7112024-09-13✓飞书人事更新单个职级
PatchCorehrV1JobLevelsByJobLevelId
7122024-09-06✓飞书人事查询单个职级
GetCorehrV1JobLevelsByJobLevelId
GetCorehrV1JobLevels
7152024-09-06✓飞书人事（企业版）通过序列 ID 批量获取序列信息
PostCorehrV2JobFamiliesBatchGet
7162024-02-06✓飞书人事创建序列
7162024-09-13✓飞书人事创建序列
PostCorehrV1JobFamilies
7172024-02-06✓飞书人事删除序列
7172024-09-13✓飞书人事删除序列
DeleteCorehrV1JobFamiliesByJobFamilyId
7182024-02-06✓飞书人事更新序列
7182024-09-13✓飞书人事更新序列
PatchCorehrV1JobFamiliesByJobFamilyId
7192024-09-09✓飞书人事查询单个序列
GetCorehrV1JobFamiliesByJobFamilyId
7202024-09-06✓飞书人事批量查询序列
GetCorehrV1JobFamilies
7212024-02-06✓飞书人事创建职务
7212024-09-13✓飞书人事创建职务
PostCorehrV1Jobs
7222024-02-06✓飞书人事删除职务
7222024-09-13✓飞书人事删除职务
DeleteCorehrV1JobsByJobId
7232024-02-06✓飞书人事更新职务
7232024-09-13✓飞书人事更新职务
PatchCorehrV1JobsByJobId
7242024-09-11✓消息与群组获取会话历史消息
GetImV1Messages
7252024-09-06✓飞书人事（企业版）查询单个职务
7252024-09-13✓飞书人事（企业版）查询单个职务
GetCorehrV2JobsByJobId
7262024-09-06✓飞书人事（企业版）批量查询职务
7262024-09-13✓飞书人事（企业版）批量查询职务
GetCorehrV2Jobs
7272024-02-06✓飞书人事查询单个职务
7272024-09-13✓飞书人事查询单个职务
GetCorehrV1JobsByJobId
7282024-02-06✓飞书人事批量查询职务
GetCorehrV1Jobs
GetHireV1JobsByJobIdConfig
7722024-09-10✓招聘更新职位
PostHireV1JobsByJobIdCombinedUpdate
7732024-08-29✓招聘更新职位设置
7732024-09-13✓招聘更新职位设置
PostHireV1JobsByJobIdUpdateConfig
7742024-08-28✓招聘获取职位类别列表
GetHireV1JobTypes
PutHireV1ExternalApplicationsByExternalApplicationId
7902024-09-09✓招聘删除外部投递
DeleteHireV1ExternalApplicationsByExternalApplicationId
7912024-09-04✓消息与群组批量发送消息
7912024-09-14✓消息与群组批量发送消息
PostMessageV4BatchSend
7922024-09-09✓招聘创建外部面试
PostHireV1ExternalInterviews
GetLingoV1Classifications
8892023-10-25✓词典获取词库列表
GetLingoV1Repos
8902024-07-05✓通讯录获取部门直属用户列表
8902024-09-14✓通讯录获取部门直属用户列表
GetContactV3UsersFindByDepartment
8912024-09-09✓消息与群组延时更新消息卡片
PostInteractiveV1CardUpdate
GetLingoV1FilesByFileTokenDownload
8942024-04-26✓安全合规获取OpenAPI审计日志数据
PostSecurityAndComplianceV1OpenapiLogsListData
8952024-09-09✓妙记获取妙记统计数据
8952024-09-14✓妙记获取妙记统计数据
GetMinutesV1MinutesByMinuteTokenStatistics
8962024-09-09✓妙记获取妙记信息
8962024-09-14✓妙记获取妙记信息
GetMinutesV1MinutesByMinuteToken
8972023-06-29✓工作台获取工作台访问数据
PostWorkplaceV1WorkplaceAccessDataSearch
PostDocumentAiV1VehicleInvoiceRecognize
10102024-01-03✓AI 能力识别文件中的健康证
PostDocumentAiV1HealthCertificateRecognize
10112024-09-06✓飞书人事（企业版）创建成本中心
10112024-09-13✓飞书人事（企业版）创建成本中心
PostCorehrV2CostCenters
10122024-09-04✓飞书人事（企业版）启用 / 停用成本中心
10122024-09-13✓飞书人事（企业版）启用 / 停用成本中心
PatchCorehrV2CostCentersByCostCenterId
10132024-08-26✓飞书人事（企业版）删除成本中心
10132024-09-13✓飞书人事（企业版）删除成本中心
DeleteCorehrV2CostCentersByCostCenterId
10142024-08-26✓飞书人事（企业版）搜索成本中心信息
PostCorehrV2CostCentersSearch
10152024-09-04✓飞书人事（企业版）创建成本中心版本
10152024-09-13✓飞书人事（企业版）创建成本中心版本
PostCorehrV2CostCentersByCostCenterIdVersions
10162024-08-26✓飞书人事（企业版）更正成本中心版本
10162024-09-13✓飞书人事（企业版）更正成本中心版本
PatchCorehrV2CostCentersByCostCenterIdVersionsByVersionId
10172024-08-26✓飞书人事（企业版）撤销成本中心版本
DeleteCorehrV2CostCentersByCostCenterIdVersionsByVersionId
PostHireV1WebsitesByWebsiteIdChannels
11052024-08-02✓招聘更新招聘官网推广渠道
PutHireV1WebsitesByWebsiteIdChannelsByChannelId
11062024-09-04✓消息与群组添加跟随气泡
11062024-09-14✓消息与群组添加跟随气泡
PostImV1MessagesByMessageIdPushFollowUp
11072024-08-30✓招聘获取地址列表
GetHireV1Locations
GetBoardV1WhiteboardsByWhiteboardIdDownloadAsImage
11802024-08-08✓管理后台获取行为审计日志数据
GetAdminV1AuditInfos
11812024-09-06✓飞书人事（企业版）查询指定生效日期的部门架构树
11812024-09-13✓飞书人事（企业版）查询指定生效日期的部门架构树
PostCorehrV2DepartmentsTree
11822024-08-30✓招聘获取用户角色列表
GetHireV1UserRoles
GetMomentsV1PostsByPostId
11902024-09-04✓飞书人事（企业版）删除部门 V2
DeleteCorehrV2DepartmentsByDepartmentId
11912024-09-06新增飞书人事（企业版）更新部门
11912024-09-06✓飞书人事（企业版）更新部门
PatchCorehrV2DepartmentsByDepartmentId
11922024-09-09新增飞书人事根据适用条件获取工作日历 ID
11922024-09-09✓飞书人事根据适用条件获取工作日历 ID
GetCorehrV1LeavesCalendarByScope
11932024-09-12新增飞书人事获取工作日历日期详情
11932024-09-12✓飞书人事获取工作日历日期详情
PostCorehrV1LeavesWorkCalendarDate
11942024-09-12新增飞书人事获取工作日历
11942024-09-12✓飞书人事获取工作日历
PostCorehrV1LeavesWorkCalendar
11952024-09-13新增飞书人事（企业版）查询编制规划明细信息
PostCorehrV2WorkforcePlanDetailsBatch
11962024-09-13新增飞书人事（企业版）查询部门变更记录
GetCorehrV2DepartmentsQueryRecentChange
diff --git a/UserAccessList.md b/UserAccessList.md index 803bfea9..870802fe 100644 --- a/UserAccessList.md +++ b/UserAccessList.md @@ -1,7 +1,7 @@ - + @@ -79,7 +79,7 @@ - + @@ -163,7 +163,7 @@ - + @@ -185,33 +185,33 @@ - + - + - + - + - + - + - + - + - + - + - + - + - + @@ -223,7 +223,7 @@ - + @@ -287,7 +287,7 @@ - + @@ -667,7 +667,7 @@ - + @@ -763,9 +763,9 @@ - + - + @@ -1047,8 +1047,8 @@ - + - +
序号更新日期可用类别说明
12024-07-16✓身份验证获取登录用户信息
GetAuthenV1UserInfo
22024-09-04✓通讯录修改用户部分信息
22024-09-14✓通讯录修改用户部分信息
PatchContactV3UsersByUserId
32024-07-05✓通讯录搜索部门
PostContactV3DepartmentsSearch
GetSheetsV2SpreadsheetsBySpreadsheetTokenValuesBatchGet
402024-08-14✓云文档向多个范围写入数据
PostSheetsV2SpreadsheetsBySpreadsheetTokenValuesBatchUpdate
412024-08-14✓云文档设置单元格样式
412024-09-18✓云文档设置单元格样式
PutSheetsV2SpreadsheetsBySpreadsheetTokenStyle
422024-08-14✓云文档批量设置单元格样式
PutSheetsV2SpreadsheetsBySpreadsheetTokenStylesBatchUpdate
PatchSheetsV3SpreadsheetsBySpreadsheetTokenSheetsBySheetIdFloatImagesByFloatImageId
822024-09-09✓云文档删除浮动图片
DeleteSheetsV3SpreadsheetsBySpreadsheetTokenSheetsBySheetIdFloatImagesByFloatImageId
832023-11-07✓多维表格复制多维表格
832024-09-18✓多维表格复制多维表格
PostBitableV1AppsByAppTokenCopy
842024-09-12✓多维表格创建多维表格
PostBitableV1Apps
PatchBitableV1AppsByAppTokenTablesByTableId
932023-08-03✓多维表格列出数据表
GetBitableV1AppsByAppTokenTables
942024-09-12✓多维表格复制仪表盘
942024-09-18✓多维表格复制仪表盘
PostBitableV1AppsByAppTokenDashboardsByBlockIdCopy
952023-08-03✓多维表格列出仪表盘
952024-09-18✓多维表格列出仪表盘
GetBitableV1AppsByAppTokenDashboards
962024-09-12✓多维表格更新视图
962024-09-18✓多维表格更新视图
PatchBitableV1AppsByAppTokenTablesByTableIdViewsByViewId
972024-09-12✓多维表格检索视图
972024-09-18✓多维表格检索视图
GetBitableV1AppsByAppTokenTablesByTableIdViewsByViewId
982024-09-12✓多维表格列出视图
982024-09-18✓多维表格列出视图
GetBitableV1AppsByAppTokenTablesByTableIdViews
992024-09-12✓多维表格新增视图
992024-09-18✓多维表格新增视图
PostBitableV1AppsByAppTokenTablesByTableIdViews
1002024-09-12✓多维表格删除视图
1002024-09-18✓多维表格删除视图
DeleteBitableV1AppsByAppTokenTablesByTableIdViewsByViewId
1012023-11-07✓多维表格更新表单元数据
1012024-09-18✓多维表格更新表单元数据
PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormId
1022024-08-21✓消息与群组获取消息表情回复
GetImV1MessagesByMessageIdReactions
1032024-02-01✓多维表格获取表单元数据
1032024-09-18✓多维表格获取表单元数据
GetBitableV1AppsByAppTokenTablesByTableIdFormsByFormId
1042023-04-18✓多维表格更新表单问题
1042024-09-18✓多维表格更新表单问题
PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFieldsByFieldId
1052023-07-28✓多维表格列出表单问题
1052024-09-18✓多维表格列出表单问题
GetBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFields
1062024-07-31✓多维表格[不推荐] 检索记录
1062024-09-18✓多维表格[不推荐] 检索记录
GetBitableV1AppsByAppTokenTablesByTableIdRecordsByRecordId
1072024-07-31✓多维表格列出记录
1072024-09-18✓多维表格列出记录
GetBitableV1AppsByAppTokenTablesByTableIdRecords
1082024-09-12✓多维表格新增记录
PostBitableV1AppsByAppTokenTablesByTableIdRecords
PostBitableV1AppsByAppTokenTablesByTableIdRecordsBatchCreate
1122024-09-12✓多维表格更新多条记录
PostBitableV1AppsByAppTokenTablesByTableIdRecordsBatchUpdate
1132024-09-02✓通讯录获取单个用户信息
1132024-09-14✓通讯录获取单个用户信息
GetContactV3UsersByUserId
1142024-08-23✓消息与群组Pin 消息
PostImV1Pins
PostWikiV2SpacesBySpaceIdNodesMoveDocsToWiki
1442024-07-31✓云文档获取任务结果
GetWikiV2TasksByTaskId
1452024-05-31✓云文档搜索 Wiki
1452024-09-18✓云文档搜索 Wiki
PostWikiV1NodesSearch
1462023-12-29✓云文档获取订阅状态
GetDriveV1FilesByFileTokenSubscriptionsBySubscriptionId
GetTaskV2Comments
3342023-11-06✓任务上传附件
PostTaskV2AttachmentsUpload
3352024-07-05✓通讯录获取部门直属用户列表
3352024-09-14✓通讯录获取部门直属用户列表
GetContactV3UsersFindByDepartment
3362024-06-21✓消息与群组更新群公告信息
PatchImV1ChatsByChatIdAnnouncement
PostLingoV1FilesUpload
3822023-10-25✓词典下载图片
GetLingoV1FilesByFileTokenDownload
3832024-09-09✓妙记获取妙记统计数据
3832024-09-14✓妙记获取妙记统计数据
GetMinutesV1MinutesByMinuteTokenStatistics
3842024-09-09✓妙记获取妙记信息
3842024-09-14✓妙记获取妙记信息
GetMinutesV1MinutesByMinuteToken
3852023-04-07✓应用信息获取用户自定义常用的应用
GetApplicationV5ApplicationsFavourite
PostMailV1UserMailboxesByUserMailboxIdMessagesSend
5242024-08-30✓公司圈查询帖子信息
GetMomentsV1PostsByPostId
5252024-09-09新增飞书人事根据适用条件获取工作日历 ID
5252024-09-09✓飞书人事根据适用条件获取工作日历 ID
GetCorehrV1LeavesCalendarByScope
5262024-09-12新增飞书人事获取工作日历日期详情
5262024-09-12✓飞书人事获取工作日历日期详情
PostCorehrV1LeavesWorkCalendarDate
diff --git a/src/Application.Events/ApplicationApplicationCreatedV6EventBodyDto.cs b/src/Application.Events/ApplicationApplicationCreatedV6EventBodyDto.cs index ada100bc..f37d3043 100644 --- a/src/Application.Events/ApplicationApplicationCreatedV6EventBodyDto.cs +++ b/src/Application.Events/ApplicationApplicationCreatedV6EventBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Application.Events; /// /// 应用创建 事件体 -/// 当企业内有新的应用被创建时推送此事件{使用示例}(url=/api/tools/api_explore/api_explore_config?project=application&version=v6&resource=application&event=created) +/// 当企业内有新的自建应用被创建时推送此事件（创建就会产生此事件，不需要发版）{使用示例}(url=/api/tools/api_explore/api_explore_config?project=application&version=v6&resource=application&event=created) /// 接口ID：7050360820601405468 /// 文档地址：https://open.feishu.cn/document/server-docs/application-v6/event/created /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fapplication-v6%2fapplication%2fevents%2fcreated diff --git a/src/Application.Events/ApplicationApplicationVisibilityAddedV6EventBodyDto.cs b/src/Application.Events/ApplicationApplicationVisibilityAddedV6EventBodyDto.cs index 0b297f82..55f15df6 100644 --- a/src/Application.Events/ApplicationApplicationVisibilityAddedV6EventBodyDto.cs +++ b/src/Application.Events/ApplicationApplicationVisibilityAddedV6EventBodyDto.cs @@ -1,10 +1,24 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-09-01 +// +// Last Modified By : yxr +// Last Modified On : 2024-09-01 +// ************************************************************************ +// +// MIT +// +// 员工免审安装应用 事件体 +// ************************************************************************ namespace FeishuNetSdk.Application.Events; /// /// 员工免审安装应用 事件体 -/// 当员工免审安装商店应用时会触发该事件，事件体内包含员工的 ID 信息。 +/// 以下场景会触发该事件，事件体内包含对应用户的 ID 信息。 +/// - 员工免审安装商店应用。功能介绍参见[员工免审安装应用](https://open.feishu.cn/document/uAjLw4CM/uYjL24iN/platform-overveiw/develop-process/configuring-employee-review-free-installation)。 +/// - 员工免审加入商店应用可用范围。当员工免审安装商店应用后，企业内其他员工在该应用详情页内获取应用时，员工会加入应用可用范围内，并触发该事件。 /// 使用限制： /// 应用必须是商店应用，且应用需要订阅该事件。了解事件订阅的使用场景和配置流程，请点击查看 [事件订阅概述](https://open.feishu.cn/document/ukTMukTMukTM/uUTNz4SN1MjL1UzM)。 -/// 员工免审安装应用功能介绍参见[员工免审安装应用](https://open.feishu.cn/document/uAjLw4CM/uYjL24iN/platform-overveiw/develop-process/configuring-employee-review-free-installation)。 /// 接口ID：7013340088257511452 /// 文档地址：https://open.feishu.cn/document/server-docs/application-v6/event/app-availability-scope-extended /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fapplication-v6%2fevent%2fapp-availability-scope-extended diff --git a/src/Approval/PostApprovalV4ExternalInstancesBodyDto.cs b/src/Approval/PostApprovalV4ExternalInstancesBodyDto.cs index a76a89ff..c4d129d9 100644 --- a/src/Approval/PostApprovalV4ExternalInstancesBodyDto.cs +++ b/src/Approval/PostApprovalV4ExternalInstancesBodyDto.cs @@ -538,7 +538,7 @@ public record ExternalInstanceLink } /// - /// 阅读状态，空值表示不支持已读未读： + /// 阅读状态 /// 必填：是 /// 示例值：READ /// 可选值： diff --git a/src/Approval/PostApprovalV4InstancesBodyDto.cs b/src/Approval/PostApprovalV4InstancesBodyDto.cs index 5d02cfcf..03d27410 100644 --- a/src/Approval/PostApprovalV4InstancesBodyDto.cs +++ b/src/Approval/PostApprovalV4InstancesBodyDto.cs @@ -4,7 +4,7 @@ // Created : 2024-06-24 // // Last Modified By : yxr -// Last Modified On : 2024-06-24 +// Last Modified On : 2024-09-18 // ************************************************************************ // // MIT @@ -146,7 +146,7 @@ public record NodeCc public string? Uuid { get; set; } /// - /// 可配置是否可以重新提交，适用于审批人退回场景，提单人在同一实例重新提交单据 + /// 可配置“提交”按钮，该操作适用于审批人退回场景，提单人在同一实例提交单据 /// 必填：否 /// 示例值：true /// @@ -245,4 +245,59 @@ public record I18nResourceText [JsonPropertyName("is_default")] public bool IsDefault { get; set; } } + + /// + /// 审批展示名称，如果填写了该字段，则审批列表中的审批名称使用该字段，如果不填该字段，则审批名称使用审批定义的名称 + /// 必填：否 + /// 示例值：@i18n@1 + /// + [JsonPropertyName("title")] + public string? Title { get; set; } + + /// + /// 详情页title展示模式 + /// 必填：否 + /// 示例值：0 + /// 可选值： + /// 0：如果都有title，展示approval 和instance的title，竖线分割。 + /// 1：如果都有title，只展示instance的title + /// + /// 默认值：0 + /// + [JsonPropertyName("title_display_method")] + public int? TitleDisplayMethod { get; set; } + + /// + /// 自动通过节点ID + /// 必填：否 + /// 最大长度：10 + /// + [JsonPropertyName("node_auto_approval_list")] + public NodeAutoApproval[]? NodeAutoApprovalLists { get; set; } + + /// + /// 自动通过节点ID + /// + public record NodeAutoApproval + { + /// + /// 节点id的类型 + /// 必填：否 + /// 示例值：NON_CUSTOM + /// 可选值： + /// CUSTOM：自定义节点ID + /// NON_CUSTOM：非自定义节点ID + /// + /// + [JsonPropertyName("node_id_type")] + public string? NodeIdType { get; set; } + + /// + /// 节点id + /// 必填：否 + /// 示例值：manager_node_id + /// + [JsonPropertyName("node_id")] + public string? NodeId { get; set; } + } } diff --git a/src/Auth/PostAuthenV1OidcRefreshAccessTokenBodyDto.cs b/src/Auth/PostAuthenV1OidcRefreshAccessTokenBodyDto.cs index 4ae39c5c..b4ff5397 100644 --- a/src/Auth/PostAuthenV1OidcRefreshAccessTokenBodyDto.cs +++ b/src/Auth/PostAuthenV1OidcRefreshAccessTokenBodyDto.cs @@ -32,7 +32,7 @@ public record PostAuthenV1OidcRefreshAccessTokenBodyDto /// /// 刷新和获取user_access_token接口均返回 `refresh_token`，**每次请求，请注意使用最新获取到的`refresh_token`** /// 必填：是 - /// 示例值：ur-oQ0mMq6MCcueAv0pwx2fQQhxqv__CbLu6G8ySFwafeKww2Def2BJdOkW3.9gCFM.LBQgFri901QaqeuL + /// 示例值：ur-h4_5nUXdJ4O8rqfGe.YJCwM13Gjc557xUG20hkk00f7K /// [JsonPropertyName("refresh_token")] public string RefreshToken { get; set; } = string.Empty; diff --git a/src/Base.Spec/PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFieldsByFieldIdBodyDto.cs b/src/Base/PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFieldsByFieldIdBodyDto.cs similarity index 89% rename from src/Base.Spec/PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFieldsByFieldIdBodyDto.cs rename to src/Base/PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFieldsByFieldIdBodyDto.cs index 02b3baa5..7498e824 100644 --- a/src/Base.Spec/PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFieldsByFieldIdBodyDto.cs +++ b/src/Base/PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFieldsByFieldIdBodyDto.cs @@ -11,7 +11,7 @@ // // 更新表单问题 请求体 // ************************************************************************ -namespace FeishuNetSdk.Base.Spec; +namespace FeishuNetSdk.Base; /// /// 更新表单问题 请求体 /// 该接口用于更新表单中的问题项 @@ -23,40 +23,40 @@ public record PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFieldsByFi { /// /// 上一个表单问题 ID，用于支持调整表单问题的顺序，通过前一个表单问题的 field_id 来确定位置；如果 pre_field_id 为空字符串，则说明要排到首个表单问题 - /// **示例值**："fldjX7dUj5" /// 必填：否 + /// 示例值：fldjX7dUj5 /// [JsonPropertyName("pre_field_id")] public string? PreFieldId { get; set; } /// /// 表单问题 - /// **示例值**："多行文本" /// 必填：否 + /// 示例值：多行文本 /// [JsonPropertyName("title")] public string? Title { get; set; } /// /// 问题描述 - /// **示例值**："多行文本描述" /// 必填：否 + /// 示例值：多行文本描述 /// [JsonPropertyName("description")] public string? Description { get; set; } /// /// 是否必填 - /// **示例值**：true /// 必填：否 + /// 示例值：true /// [JsonPropertyName("required")] public bool? Required { get; set; } /// /// 是否可见，当值为 false 时，不允许更新其他字段。 - /// **示例值**：true /// 必填：否 + /// 示例值：true /// [JsonPropertyName("visible")] public bool? Visible { get; set; } diff --git a/src/Base.Spec/PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFieldsByFieldIdResponseDto.cs b/src/Base/PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFieldsByFieldIdResponseDto.cs similarity index 88% rename from src/Base.Spec/PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFieldsByFieldIdResponseDto.cs rename to src/Base/PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFieldsByFieldIdResponseDto.cs index ddeff650..f833eec6 100644 --- a/src/Base.Spec/PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFieldsByFieldIdResponseDto.cs +++ b/src/Base/PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFieldsByFieldIdResponseDto.cs @@ -11,7 +11,7 @@ // // 更新表单问题 响应体 // ************************************************************************ -namespace FeishuNetSdk.Base.Spec; +namespace FeishuNetSdk.Base; /// /// 更新表单问题 响应体 /// 该接口用于更新表单中的问题项 @@ -28,12 +28,15 @@ public record PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFieldsByFi [JsonPropertyName("field")] public AppTableFormPatchedField? Field { get; set; } - /// + /// + /// 更新后的表单问题项 + /// public record AppTableFormPatchedField { /// /// 上一个表单问题 ID，用于支持调整表单问题的顺序，通过前一个表单问题的 field_id 来确定位置；如果 pre_field_id 为空字符串，则说明要排到首个表单问题 /// 必填：否 + /// 示例值：fldjX7dUj5 /// [JsonPropertyName("pre_field_id")] public string? PreFieldId { get; set; } @@ -41,6 +44,7 @@ public record AppTableFormPatchedField /// /// 表单问题 /// 必填：否 + /// 示例值：多行文本 /// [JsonPropertyName("title")] public string? Title { get; set; } @@ -48,6 +52,7 @@ public record AppTableFormPatchedField /// /// 问题描述 /// 必填：否 + /// 示例值：多行文本描述 /// [JsonPropertyName("description")] public string? Description { get; set; } @@ -55,6 +60,7 @@ public record AppTableFormPatchedField /// /// 是否必填 /// 必填：否 + /// 示例值：true /// [JsonPropertyName("required")] public bool? Required { get; set; } @@ -62,6 +68,7 @@ public record AppTableFormPatchedField /// /// 是否可见，当值为 false 时，不允许更新其他字段。 /// 必填：否 + /// 示例值：true /// [JsonPropertyName("visible")] public bool? Visible { get; set; } diff --git a/src/Base/PostBitableV1AppsByAppTokenCopyBodyDto.cs b/src/Base/PostBitableV1AppsByAppTokenCopyBodyDto.cs index d73cbd71..989868ec 100644 --- a/src/Base/PostBitableV1AppsByAppTokenCopyBodyDto.cs +++ b/src/Base/PostBitableV1AppsByAppTokenCopyBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Base; /// /// 复制多维表格 请求体 -/// 复制一个多维表格，可以指定复制到某个有权限的文件夹下 +/// 复制一个多维表格，可以指定复制到某个有权限的文件夹下。 /// 接口ID：7205776220394160156 /// 文档地址：https://open.feishu.cn/document/server-docs/docs/bitable-v1/app/copy /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fbitable-v1%2fapp%2fcopy diff --git a/src/Base/PostBitableV1AppsByAppTokenCopyResponseDto.cs b/src/Base/PostBitableV1AppsByAppTokenCopyResponseDto.cs index c31506fb..178cbf45 100644 --- a/src/Base/PostBitableV1AppsByAppTokenCopyResponseDto.cs +++ b/src/Base/PostBitableV1AppsByAppTokenCopyResponseDto.cs @@ -4,7 +4,7 @@ // Created : 2024-06-24 // // Last Modified By : yxr -// Last Modified On : 2024-06-24 +// Last Modified On : 2024-09-18 // ************************************************************************ // // MIT @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Base; /// /// 复制多维表格 响应体 -/// 复制一个多维表格，可以指定复制到某个有权限的文件夹下 +/// 复制一个多维表格，可以指定复制到某个有权限的文件夹下。 /// 接口ID：7205776220394160156 /// 文档地址：https://open.feishu.cn/document/server-docs/docs/bitable-v1/app/copy /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fbitable-v1%2fapp%2fcopy @@ -65,18 +65,10 @@ public record PostBitableV1AppsByAppTokenCopyResponseDtoApp [JsonPropertyName("url")] public string? Url { get; set; } - /// - /// 默认的表格id - /// 必填：否 - /// 示例值："" //只有创建才返回默认表Id - /// - [JsonPropertyName("default_table_id")] - public string? DefaultTableId { get; set; } - /// /// 文档时区 /// 必填：否 - /// 示例值：Asia/Shanghai + /// 示例值："" //只有创建才返回默认表Id /// [JsonPropertyName("time_zone")] public string? TimeZone { get; set; } diff --git a/src/Ccm.Spec/PostWikiV1NodesSearchResponseDto.cs b/src/Ccm.Spec/PostWikiV1NodesSearchResponseDto.cs index c40b74a9..09059ee5 100644 --- a/src/Ccm.Spec/PostWikiV1NodesSearchResponseDto.cs +++ b/src/Ccm.Spec/PostWikiV1NodesSearchResponseDto.cs @@ -4,7 +4,7 @@ // Created : 2024-06-24 // // Last Modified By : yxr -// Last Modified On : 2024-06-24 +// Last Modified On : 2024-09-18 // ************************************************************************ // // MIT @@ -29,11 +29,13 @@ public record PostWikiV1NodesSearchResponseDto [JsonPropertyName("items")] public Item[]? Items { get; set; } - /// + /// + /// + /// public record Item { /// - /// wiki 节点 Id + /// wiki 节点的 token /// 必填：否 /// [JsonPropertyName("node_id")] @@ -53,6 +55,27 @@ public record Item [JsonPropertyName("obj_type")] public int? ObjType { get; set; } + /// + /// 节点的真实文档的 token，如果要获取或编辑节点内容，需要使用此 token 调用对应的接口 + /// 必填：否 + /// + [JsonPropertyName("obj_token")] + public string? ObjToken { get; set; } + + /// + /// 暂未生效，一律返回空 + /// 必填：否 + /// + [JsonPropertyName("parent_id")] + public string? ParentId { get; set; } + + /// + /// 该知识库文档的序号，从 1 开始计数 + /// 必填：否 + /// + [JsonPropertyName("sort_id")] + public int? SortId { get; set; } + /// /// wiki 标题 /// 必填：否 diff --git a/src/Core/EventDto.cs b/src/Core/EventDto.cs index 210bf928..05583f99 100644 --- a/src/Core/EventDto.cs +++ b/src/Core/EventDto.cs @@ -4,7 +4,7 @@ // Created : 2024-09-01 // // Last Modified By : yxr -// Last Modified On : 2024-09-12 +// Last Modified On : 2024-09-18 // ************************************************************************ // // MIT @@ -64,10 +64,22 @@ namespace FeishuNetSdk.Core; [JsonDerivedType(typeof(EventV2Dto), typeDiscriminator: "corehr.process.approver.updated_v2")] //【飞书人事（企业版）】试用期状态变更 [JsonDerivedType(typeof(EventV2Dto), typeDiscriminator: "corehr.probation.updated_v2")] +//【飞书人事（企业版）】序列创建 +[JsonDerivedType(typeof(EventV2Dto), typeDiscriminator: "corehr.job_family.created_v2")] +//【飞书人事（企业版）】序列更新 +[JsonDerivedType(typeof(EventV2Dto), typeDiscriminator: "corehr.job_family.updated_v2")] +//【飞书人事（企业版）】序列删除 +[JsonDerivedType(typeof(EventV2Dto), typeDiscriminator: "corehr.job_family.deleted_v2")] //【飞书人事（企业版）】异动信息变更 [JsonDerivedType(typeof(EventV2Dto), typeDiscriminator: "corehr.job_change.updated_v2")] //【飞书人事（企业版）】异动状态变更 [JsonDerivedType(typeof(EventV2Dto), typeDiscriminator: "corehr.job_change.status_updated_v2")] +//【飞书人事（企业版）】职级创建 +[JsonDerivedType(typeof(EventV2Dto), typeDiscriminator: "corehr.job_level.created_v2")] +//【飞书人事（企业版）】职级更新 +[JsonDerivedType(typeof(EventV2Dto), typeDiscriminator: "corehr.job_level.updated_v2")] +//【飞书人事（企业版）】职级删除 +[JsonDerivedType(typeof(EventV2Dto), typeDiscriminator: "corehr.job_level.deleted_v2")] //【飞书人事】【事件】创建部门 [JsonDerivedType(typeof(EventV2Dto), typeDiscriminator: "corehr.department.created_v1")] //【飞书人事】【事件】创建雇佣信息 diff --git a/src/Corehr.Events/CorehrJobFamilyCreatedV2EventBodyDto.cs b/src/Corehr.Events/CorehrJobFamilyCreatedV2EventBodyDto.cs new file mode 100644 index 00000000..2f4fb45e --- /dev/null +++ b/src/Corehr.Events/CorehrJobFamilyCreatedV2EventBodyDto.cs @@ -0,0 +1,31 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-09-18 +// +// Last Modified By : yxr +// Last Modified On : 2024-09-18 +// ************************************************************************ +// +// MIT +// +// 序列创建 事件体 +// ************************************************************************ +namespace FeishuNetSdk.Corehr.Events; +/// +/// 序列创建 事件体 +/// 飞书人事中「序列被创建」时将触发此事件。{使用示例}(url=/api/tools/api_explore/api_explore_config?project=corehr&version=v2&resource=job_family&event=created) +/// 接口ID：7414100499044696092 +/// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_family/events/created +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fjob_family%2fevents%2fcreated +/// +public record CorehrJobFamilyCreatedV2EventBodyDto() : EventBodyDto("corehr.job_family.created_v2") +{ + /// + /// 序列ID。ID获取方式： + /// - 调用[【新建序列】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/create)[【查询租户的序列信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)等接口可以返回序列ID + /// 必填：否 + /// + [JsonPropertyName("job_family_id")] + public string? JobFamilyId { get; set; } +} diff --git a/src/Corehr.Events/CorehrJobFamilyDeletedV2EventBodyDto.cs b/src/Corehr.Events/CorehrJobFamilyDeletedV2EventBodyDto.cs new file mode 100644 index 00000000..cce6f726 --- /dev/null +++ b/src/Corehr.Events/CorehrJobFamilyDeletedV2EventBodyDto.cs @@ -0,0 +1,31 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-09-18 +// +// Last Modified By : yxr +// Last Modified On : 2024-09-18 +// ************************************************************************ +// +// MIT +// +// 序列删除 事件体 +// ************************************************************************ +namespace FeishuNetSdk.Corehr.Events; +/// +/// 序列删除 事件体 +/// 飞书人事中「序列被删除」时将触发此事件。 +/// {使用示例}(url=/api/tools/api_explore/api_explore_config?project=corehr&version=v2&resource=job_family&event=deleted) +/// 接口ID：7414100499044663324 +/// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_family/events/deleted +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fjob_family%2fevents%2fdeleted +/// +public record CorehrJobFamilyDeletedV2EventBodyDto() : EventBodyDto("corehr.job_family.deleted_v2") +{ + /// + /// 被删除序列的 ID。 + /// 必填：否 + /// + [JsonPropertyName("job_family_id")] + public string? JobFamilyId { get; set; } +} diff --git a/src/Corehr.Events/CorehrJobFamilyUpdatedV2EventBodyDto.cs b/src/Corehr.Events/CorehrJobFamilyUpdatedV2EventBodyDto.cs new file mode 100644 index 00000000..24884c93 --- /dev/null +++ b/src/Corehr.Events/CorehrJobFamilyUpdatedV2EventBodyDto.cs @@ -0,0 +1,40 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-09-18 +// +// Last Modified By : yxr +// Last Modified On : 2024-09-18 +// ************************************************************************ +// +// MIT +// +// 序列更新 事件体 +// ************************************************************************ +namespace FeishuNetSdk.Corehr.Events; +/// +/// 序列更新 事件体 +/// 飞书人事中「序列信息被更新」时将触发此事件。{使用示例}(url=/api/tools/api_explore/api_explore_config?project=corehr&version=v2&resource=job_family&event=updated) +/// 接口ID：7414100499044679708 +/// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_family/events/updated +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fjob_family%2fevents%2fupdated +/// +public record CorehrJobFamilyUpdatedV2EventBodyDto() : EventBodyDto("corehr.job_family.updated_v2") +{ + /// + /// 序列ID。 + /// - 调用[【新建序列】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/create)[【查询租户的序列信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)等接口可以返回序列ID + /// 必填：否 + /// + [JsonPropertyName("job_family_id")] + public string? JobFamilyId { get; set; } + + /// + /// 发生变更的字段 + /// **数据校验规则**： + /// - 长度范围：`0` ～ `200` + /// 必填：否 + /// + [JsonPropertyName("field_changes")] + public string[]? FieldChanges { get; set; } +} diff --git a/src/Corehr.Events/CorehrJobLevelCreatedV2EventBodyDto.cs b/src/Corehr.Events/CorehrJobLevelCreatedV2EventBodyDto.cs new file mode 100644 index 00000000..08964f9a --- /dev/null +++ b/src/Corehr.Events/CorehrJobLevelCreatedV2EventBodyDto.cs @@ -0,0 +1,31 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-09-18 +// +// Last Modified By : yxr +// Last Modified On : 2024-09-18 +// ************************************************************************ +// +// MIT +// +// 职级创建 事件体 +// ************************************************************************ +namespace FeishuNetSdk.Corehr.Events; +/// +/// 职级创建 事件体 +/// 飞书人事中「职级被创建」时将触发此事件。{使用示例}(url=/api/tools/api_explore/api_explore_config?project=corehr&version=v2&resource=job_level&event=created) +/// 接口ID：7414100499044630556 +/// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_level/events/created +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fjob_level%2fevents%2fcreated +/// +public record CorehrJobLevelCreatedV2EventBodyDto() : EventBodyDto("corehr.job_level.created_v2") +{ + /// + /// 职级ID。ID获取方式： + /// - 调用[【新建职级】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/create)[【查询租户的职级信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)等接口可以返回职级ID + /// 必填：否 + /// + [JsonPropertyName("job_level_id")] + public string? JobLevelId { get; set; } +} diff --git a/src/Corehr.Events/CorehrJobLevelDeletedV2EventBodyDto.cs b/src/Corehr.Events/CorehrJobLevelDeletedV2EventBodyDto.cs new file mode 100644 index 00000000..818dd322 --- /dev/null +++ b/src/Corehr.Events/CorehrJobLevelDeletedV2EventBodyDto.cs @@ -0,0 +1,31 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-09-18 +// +// Last Modified By : yxr +// Last Modified On : 2024-09-18 +// ************************************************************************ +// +// MIT +// +// 职级删除 事件体 +// ************************************************************************ +namespace FeishuNetSdk.Corehr.Events; +/// +/// 职级删除 事件体 +/// 飞书人事中「职级被删除」时将触发此事件。 +/// {使用示例}(url=/api/tools/api_explore/api_explore_config?project=corehr&version=v2&resource=job_level&event=deleted) +/// 接口ID：7414100499044712476 +/// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_level/events/deleted +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fjob_level%2fevents%2fdeleted +/// +public record CorehrJobLevelDeletedV2EventBodyDto() : EventBodyDto("corehr.job_level.deleted_v2") +{ + /// + /// 被删除职级的 ID。 + /// 必填：否 + /// + [JsonPropertyName("job_level_id")] + public string? JobLevelId { get; set; } +} diff --git a/src/Corehr.Events/CorehrJobLevelUpdatedV2EventBodyDto.cs b/src/Corehr.Events/CorehrJobLevelUpdatedV2EventBodyDto.cs new file mode 100644 index 00000000..affc4fe5 --- /dev/null +++ b/src/Corehr.Events/CorehrJobLevelUpdatedV2EventBodyDto.cs @@ -0,0 +1,39 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-09-18 +// +// Last Modified By : yxr +// Last Modified On : 2024-09-18 +// ************************************************************************ +// +// MIT +// +// 职级更新 事件体 +// ************************************************************************ +namespace FeishuNetSdk.Corehr.Events; +/// +/// 职级更新 事件体 +/// 飞书人事中「职级信息被更新」时将触发此事件。{使用示例}(url=/api/tools/api_explore/api_explore_config?project=corehr&version=v2&resource=job_level&event=updated) +/// 接口ID：7414100499044614172 +/// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_level/events/updated +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fjob_level%2fevents%2fupdated +/// +public record CorehrJobLevelUpdatedV2EventBodyDto() : EventBodyDto("corehr.job_level.updated_v2") +{ + /// + /// 职级ID + /// 必填：否 + /// + [JsonPropertyName("job_level_id")] + public string? JobLevelId { get; set; } + + /// + /// 发生变更的字段 + /// **数据校验规则**： + /// - 长度范围：`0` ～ `200` + /// 必填：否 + /// + [JsonPropertyName("field_changes")] + public string[]? FieldChanges { get; set; } +} diff --git a/src/Corehr/GetCorehrV2DepartmentsQueryRecentChangeResponseDto.cs b/src/Corehr/GetCorehrV2DepartmentsQueryRecentChangeResponseDto.cs new file mode 100644 index 00000000..ad2d59ca --- /dev/null +++ b/src/Corehr/GetCorehrV2DepartmentsQueryRecentChangeResponseDto.cs @@ -0,0 +1,59 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-09-18 +// +// Last Modified By : yxr +// Last Modified On : 2024-09-18 +// ************************************************************************ +// +// MIT +// +// 查询部门变更记录 响应体 +// ************************************************************************ +namespace FeishuNetSdk.Corehr; +/// +/// 查询部门变更记录 响应体 +/// 查询指定时间范围内部门变更记录 +/// 接口ID：7414100499044646940 +/// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/query_recent_change +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fdepartment%2fquery_recent_change +/// +public record GetCorehrV2DepartmentsQueryRecentChangeResponseDto +{ + /// + /// 部门 ID 列表， 其中包含新建、更新以及删除的 ID 列表。 + /// - 非删除的数据，可通过[批量查询部门V2](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get) 或者[搜索部门信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/search) 获取详情 + /// 必填：否 + /// 最大长度：2000 + /// 最小长度：0 + /// + [JsonPropertyName("department_ids")] + public string[]? DepartmentIds { get; set; } + + /// + /// 目标查询时间范围内被删除的部门列表， 该列表是 department_ids 的子集，便于获取在指定的[start_date, end_date+1) 的范围内被删除的部门 IDs。 + /// - **由于对应的部门已经被删除，无法通过 ID 查询到历史数据。** + /// 必填：否 + /// 最大长度：2000 + /// 最小长度：0 + /// + [JsonPropertyName("deleted_department_ids")] + public string[]? DeletedDepartmentIds { get; set; } + + /// + /// 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token + /// 必填：否 + /// 示例值：7094136522860922111 + /// + [JsonPropertyName("page_token")] + public string? PageToken { get; set; } + + /// + /// 是否还有更多项 + /// 必填：否 + /// 示例值：true + /// + [JsonPropertyName("has_more")] + public bool? HasMore { get; set; } +} diff --git a/src/Corehr/PatchCorehrV2CostCentersByCostCenterIdBodyDto.cs b/src/Corehr/PatchCorehrV2CostCentersByCostCenterIdBodyDto.cs index fb75c03d..9cb8b43a 100644 --- a/src/Corehr/PatchCorehrV2CostCentersByCostCenterIdBodyDto.cs +++ b/src/Corehr/PatchCorehrV2CostCentersByCostCenterIdBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Corehr; /// /// 启用 / 停用成本中心 请求体 -/// 对成本中心进行启用和停用操作，支持单个操作 +/// 该接口支持对单个成本中心进行启用和停用操作。 /// 接口ID：7225452763517206531 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/organization-management/cost_center/patch /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fcost_center%2fpatch @@ -22,11 +22,12 @@ namespace FeishuNetSdk.Corehr; public record PatchCorehrV2CostCentersByCostCenterIdBodyDto { /// - /// 生效时间 + /// 版本生效日期 /// - 填写格式：YYYY-MM-DD /// - 系统默认为填写日期当天的 00:00:00 生效 /// - 该接口只支持到最小单位为日 - /// - 日期范围要求:1900-01-01 ～9999-12-31 + /// - 日期范围要求:1900-01-01～9999-12-31 + /// - 详情可以参考[时间轴介绍](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/about-timeline-version) /// 必填：是 /// 示例值：2020-01-01 /// diff --git a/src/Corehr/PatchCorehrV2CostCentersByCostCenterIdResponseDto.cs b/src/Corehr/PatchCorehrV2CostCentersByCostCenterIdResponseDto.cs index 04f997c5..092a2a76 100644 --- a/src/Corehr/PatchCorehrV2CostCentersByCostCenterIdResponseDto.cs +++ b/src/Corehr/PatchCorehrV2CostCentersByCostCenterIdResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.Corehr; /// /// 启用 / 停用成本中心 响应体 -/// 对成本中心进行启用和停用操作，支持单个操作 +/// 该接口支持对单个成本中心进行启用和停用操作。 /// 接口ID：7225452763517206531 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/organization-management/cost_center/patch /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fcost_center%2fpatch @@ -35,6 +35,7 @@ public record PatchCorehrV2CostCentersByCostCenterIdResponseDtoCostCenter { /// /// 成本中心ID + /// - 详细信息可通过[【搜索成本中心信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search)接口查询获得 /// 必填：否 /// 示例值：6969828847121885087 /// @@ -87,7 +88,8 @@ public record I18n public string? ParentCostCenterId { get; set; } /// - /// 成本中心负责人ID 列表，详细信息可通过[【搜索员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search)接口获取 + /// 成本中心负责人ID 列表 + /// - 详细信息可通过[【搜索员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search) 或 [【批量查询员工】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get) 接口获取 /// 必填：否 /// [JsonPropertyName("managers")] @@ -101,9 +103,9 @@ public record I18n public I18n[]? Descriptions { get; set; } /// - /// 生效日期 - /// - 返回格式：YYYY-MM-DD （最小单位到日） - /// - 日期范围:1900-01-01 ～9999-12-31 + /// 版本生效日期 + /// - 返回格式：YYYY-MM-DD（最小单位到日） + /// - 日期范围:1900-01-01～9999-12-31 /// 必填：是 /// 示例值：2020-01-01 /// @@ -111,9 +113,9 @@ public record I18n public string EffectiveTime { get; set; } = string.Empty; /// - /// 失效日期 - /// - 返回格式：YYYY-MM-DD （最小单位到日） - /// - 日期范围:1900-01-01 ～9999-12-31 + /// 版本失效日期 + /// - 返回格式：YYYY-MM-DD（最小单位到日） + /// - 日期范围:1900-01-01～9999-12-31 /// 必填：否 /// 示例值：2020-01-01 /// @@ -121,7 +123,7 @@ public record I18n public string? ExpirationTime { get; set; } /// - /// 当前实体是否启用 + /// 成本中心启用状态，true为启用，false为停用 /// 必填：否 /// 示例值：true /// diff --git a/src/Corehr/PatchCorehrV2CostCentersByCostCenterIdVersionsByVersionIdBodyDto.cs b/src/Corehr/PatchCorehrV2CostCentersByCostCenterIdVersionsByVersionIdBodyDto.cs index c2e49723..74c05510 100644 --- a/src/Corehr/PatchCorehrV2CostCentersByCostCenterIdVersionsByVersionIdBodyDto.cs +++ b/src/Corehr/PatchCorehrV2CostCentersByCostCenterIdVersionsByVersionIdBodyDto.cs @@ -59,7 +59,9 @@ public record I18n public string? ParentCostCenterId { get; set; } /// - /// 成本中心负责人ID 列表，可通过[【搜索员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search)接口获取 + /// 成本中心负责人ID 列表。ID获取方式： + /// - 调用[【添加人员】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/create)返回雇佣信息ID + /// - 调用[【搜索员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search)接口返回雇佣信息ID /// 必填：否 /// [JsonPropertyName("managers")] @@ -73,11 +75,12 @@ public record I18n public I18n[]? Descriptions { get; set; } /// - /// 生效时间 - /// - 填写格式：YYYY-MM-DD - /// - 系统默认为填写日期当天的 00:00:00 生效 - /// - 该接口只支持到最小单位为日 + /// 版本失效日期 + /// - 填写格式：YYYY-MM-DD（系统会自动将时分秒改为00:00:00） + /// - 本次编辑的记录版本失效的时间， 如果用户在本次操作的生效日期之后修改了对象信息，则系统会将下一次操作的日期作为当前记录的失效时间。 + /// - 系统默认为填写日期当天的 失效 /// - 日期范围要求:1900-01-01 ～9999-12-31 + /// - 详情可以参考[时间轴介绍](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/about-timeline-version) /// 必填：是 /// 示例值：2020-01-01 /// diff --git a/src/Corehr/PatchCorehrV2CostCentersByCostCenterIdVersionsByVersionIdResponseDto.cs b/src/Corehr/PatchCorehrV2CostCentersByCostCenterIdVersionsByVersionIdResponseDto.cs index 3c2f562d..f911405a 100644 --- a/src/Corehr/PatchCorehrV2CostCentersByCostCenterIdVersionsByVersionIdResponseDto.cs +++ b/src/Corehr/PatchCorehrV2CostCentersByCostCenterIdVersionsByVersionIdResponseDto.cs @@ -109,9 +109,10 @@ public record I18n public I18n[]? Descriptions { get; set; } /// - /// 生效时间 - /// - 返回格式：YYYY-MM-DD（最小单位到日） - /// - 日期范围:1900-01-01 ～9999-12-31 + /// 版本生效日期 + /// - 返回格式：YYYY-MM-DD 00:00:00（最小单位到日） + /// - 日期范围:1900-01-01 00:00:00～9999-12-31 23:59:59 + /// - 详情可以参考[时间轴介绍](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/about-timeline-version) /// 必填：是 /// 示例值：2020-01-01 /// @@ -119,9 +120,10 @@ public record I18n public string EffectiveTime { get; set; } = string.Empty; /// - /// 失效时间 - /// - 返回格式：YYYY-MM-DD（最小单位到日） - /// - 日期范围:1900-01-01～9999-12-31 + /// 版本失效日期 + /// - 返回格式：YYYY-MM-DD 00:00:00（最小单位到日） + /// - 日期范围:1900-01-01 00:00:00～9999-12-31 23:59:59 + /// - 详情可以参考[时间轴介绍](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/about-timeline-version) /// 必填：否 /// 示例值：2020-01-01 /// diff --git a/src/Corehr/PostCorehrV2CostCentersBodyDto.cs b/src/Corehr/PostCorehrV2CostCentersBodyDto.cs index aa5ce1fc..34df12bd 100644 --- a/src/Corehr/PostCorehrV2CostCentersBodyDto.cs +++ b/src/Corehr/PostCorehrV2CostCentersBodyDto.cs @@ -22,6 +22,7 @@ namespace FeishuNetSdk.Corehr; public record PostCorehrV2CostCentersBodyDto { /// + /// 成本中心名称 /// - 名称不能包含「/」「；」「;」字符 /// - 成本中心中英文名称会有全局唯一校验 /// 必填：是 @@ -30,6 +31,7 @@ public record PostCorehrV2CostCentersBodyDto public I18n[] Names { get; set; } = Array.Empty(); /// + /// 成本中心名称 /// - 名称不能包含「/」「；」「;」字符 /// - 成本中心中英文名称会有全局唯一校验 /// @@ -53,7 +55,9 @@ public record I18n } /// - /// - 编码 (不能与其他记录的编码重复)；当开启自动编码时，若没传入编码则自动生成编码，若传入编码，则以传入的编码为准 + /// 成本中心编码 (不能与其他记录的编码重复) + /// - 开启自动编码时，如果不传值会自动生成编码，否则以传入值为准 + /// - 未开启自动编码时，不传值不会自动生成编码 /// 必填：否 /// 示例值：MDPD00000023 /// @@ -69,8 +73,9 @@ public record I18n public string? ParentCostCenterId { get; set; } /// - /// 成本中心负责人ID 列表； - /// 详细信息可通过[【搜索员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search)接口获取 + /// 成本中心负责人ID 列表。ID获取方式： + /// - 调用[【添加人员】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/create)返回雇佣信息ID + /// - 调用[【搜索员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search)接口返回雇佣信息ID /// 必填：否 /// [JsonPropertyName("managers")] @@ -84,7 +89,12 @@ public record I18n public I18n[]? Descriptions { get; set; } /// - /// 生效时间；该接口最知好吃到最小单位为日 + /// 版本生效日期 + /// - 填写格式：YYYY-MM-DD + /// - 系统默认为填写日期当天的 00:00:00 生效 + /// - 该接口只支持到最小单位为日 + /// - 日期范围要求:1900-01-01～9999-12-31 + /// - 详情可以参考[时间轴介绍](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/about-timeline-version) /// 必填：是 /// 示例值：2020-01-01 /// diff --git a/src/Corehr/PostCorehrV2CostCentersByCostCenterIdVersionsBodyDto.cs b/src/Corehr/PostCorehrV2CostCentersByCostCenterIdVersionsBodyDto.cs index ed90bdfe..ed2fb6a5 100644 --- a/src/Corehr/PostCorehrV2CostCentersByCostCenterIdVersionsBodyDto.cs +++ b/src/Corehr/PostCorehrV2CostCentersByCostCenterIdVersionsBodyDto.cs @@ -73,11 +73,12 @@ public record I18n public I18n[]? Descriptions { get; set; } /// - /// 生效时间 + /// 版本生效时间 /// - 填写格式：YYYY-MM-DD /// - 系统默认为填写日期当天的 00:00:00 生效 /// - 该接口只支持到最小单位为日 /// - 日期范围要求:1900-01-01～9999-12-31 + /// - 详情可以参考[时间轴介绍](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/about-timeline-version) /// 必填：是 /// 示例值：2020-01-01 /// diff --git a/src/Corehr/PostCorehrV2CostCentersByCostCenterIdVersionsResponseDto.cs b/src/Corehr/PostCorehrV2CostCentersByCostCenterIdVersionsResponseDto.cs index 8bc00761..4f8274ec 100644 --- a/src/Corehr/PostCorehrV2CostCentersByCostCenterIdVersionsResponseDto.cs +++ b/src/Corehr/PostCorehrV2CostCentersByCostCenterIdVersionsResponseDto.cs @@ -109,9 +109,10 @@ public record I18n public I18n[]? Descriptions { get; set; } /// - /// 生效时间 - /// - 返回格式：YYYY-MM-DD （最小单位到日） - /// - 日期范围:1900-01-01 ～9999-12-31 + /// 版本生效日期 + /// - 返回格式：YYYY-MM-DD 00:00:00（最小单位到日） + /// - 日期范围:1900-01-01 00:00:00～9999-12-31 23:59:59 + /// - 详情可以参考[时间轴介绍](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/about-timeline-version) /// 必填：是 /// 示例值：2020-01-01 /// @@ -119,9 +120,10 @@ public record I18n public string EffectiveTime { get; set; } = string.Empty; /// - /// 失效时间 - /// - 返回格式：YYYY-MM-DD （最小单位到日） - /// - 日期范围:1900-01-01 ～9999-12-31 + /// 版本失效日期 + /// - 返回格式：YYYY-MM-DD 00:00:00（最小单位到日） + /// - 日期范围:1900-01-01 00:00:00～9999-12-31 23:59:59 + /// - 详情可以参考[时间轴介绍](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/about-timeline-version) /// 必填：否 /// 示例值：2020-01-01 /// diff --git a/src/Corehr/PostCorehrV2CostCentersResponseDto.cs b/src/Corehr/PostCorehrV2CostCentersResponseDto.cs index e6e5b3de..64049bfe 100644 --- a/src/Corehr/PostCorehrV2CostCentersResponseDto.cs +++ b/src/Corehr/PostCorehrV2CostCentersResponseDto.cs @@ -101,9 +101,9 @@ public record I18n public I18n[]? Descriptions { get; set; } /// - /// 生效日期 - /// - 返回格式：YYYY-MM-DD （最小单位到日） - /// - 日期范围:1900-01-01 ～9999-12-31 + /// 版本生效日期 + /// - 返回格式：YYYY-MM-DD 00:00:00（最小单位到日） + /// - 日期范围:1900-01-01 00:00:00～9999-12-31 23:59:59 /// 必填：是 /// 示例值：2020-01-01 /// @@ -111,7 +111,7 @@ public record I18n public string EffectiveTime { get; set; } = string.Empty; /// - /// 失效日期 + /// 版本失效日期 /// - 返回格式：YYYY-MM-DD （最小单位到日） /// - 日期范围:1900-01-01 ～9999-12-31 /// 必填：否 @@ -121,7 +121,7 @@ public record I18n public string? ExpirationTime { get; set; } /// - /// 当前实体是否启用 + /// 成本中心启用状态，true为启用，fasle为停用 /// 必填：否 /// 示例值：true /// diff --git a/src/Corehr/PostCorehrV2DepartmentsTreeResponseDto.cs b/src/Corehr/PostCorehrV2DepartmentsTreeResponseDto.cs index 5ed6553f..eb786d72 100644 --- a/src/Corehr/PostCorehrV2DepartmentsTreeResponseDto.cs +++ b/src/Corehr/PostCorehrV2DepartmentsTreeResponseDto.cs @@ -35,6 +35,7 @@ public record DepartmentTree { /// /// 部门 ID + /// - 可通过[批量查询部门V2](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get) 或者[搜索部门信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/search) 获取详情 /// 必填：否 /// 示例值：4719456877659520852 /// @@ -53,6 +54,7 @@ public record DepartmentTree /// /// 下级部门 ID 列表 + /// - 可通过[批量查询部门V2](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get) 或者[搜索部门信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/search) 获取详情 /// 必填：否 /// 最大长度：10000 /// 最小长度：0 diff --git a/src/Corehr/PostCorehrV2WorkforcePlanDetailsBatchBodyDto.cs b/src/Corehr/PostCorehrV2WorkforcePlanDetailsBatchBodyDto.cs new file mode 100644 index 00000000..c53e4e56 --- /dev/null +++ b/src/Corehr/PostCorehrV2WorkforcePlanDetailsBatchBodyDto.cs @@ -0,0 +1,124 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-09-18 +// +// Last Modified By : yxr +// Last Modified On : 2024-09-18 +// ************************************************************************ +// +// MIT +// +// 查询编制规划明细信息 请求体 +// ************************************************************************ +namespace FeishuNetSdk.Corehr; +/// +/// 查询编制规划明细信息 请求体 +/// 查询编制规划明细，包括维度信息、编制数和预估在职人数 +/// 接口ID：7314710843818524673 +/// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/workforce_plan_detail/batch +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fworkforce_plan_detail%2fbatch +/// +public record PostCorehrV2WorkforcePlanDetailsBatchBodyDto +{ + /// + /// 编制规划方案 ID， ID及详细信息可通过[获取编制规划方案列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/workforce_plan/list)接口查询获得。查询编制规划明细信息时，编制规划方案 ID 必填。 + /// 必填：否 + /// 示例值：781234834512 + /// + [JsonPropertyName("workforce_plan_id")] + public string? WorkforcePlanId { get; set; } + + /// + /// 是否为集中填报项目。如果租户未使用集中填报功能，将此参数置空即可。 + /// **字段权限要求**：获取编制规划集中填报明细信息(corehr:workforce_plan_centralized_reporting_project_detail:read) + /// 必填：否 + /// 示例值：false + /// 默认值：false + /// + [JsonPropertyName("is_centralized_reporting_project")] + public bool? IsCentralizedReportingProject { get; set; } + + /// + /// 编制规划集中填报项目 ID。ID可根据集中填报链接获取。如果租户未使用集中填报功能，将此参数置空即可。查询集中填报信息时，将以集中填报ID为准，无需填写编制规划方案 ID。 + /// **字段权限要求**：获取编制规划集中填报明细信息(corehr:workforce_plan_centralized_reporting_project_detail:read) + /// 必填：否 + /// 示例值：7140964208476371111 + /// 最大长度：1000 + /// 最小长度：0 + /// + [JsonPropertyName("centralized_reporting_project_id")] + public string? CentralizedReportingProjectId { get; set; } + + /// + /// 部门ID列表。ID获取方式： + /// - 调用[【创建部门】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/department/create)[【搜索部门】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/search)等接口可以返回部门ID + /// - 也可以通过[【事件】创建部门](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/department/events/created)[【事件】更新部门](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/department/events/updated) 获取部门ID信息 + /// 必填：否 + /// 最大长度：1000 + /// 最小长度：0 + /// + [JsonPropertyName("department_ids")] + public string[]? DepartmentIds { get; set; } + + /// + /// 人员类型 ID 列表 + /// - 可通过[查询人员类型](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/employee_type/get)获取详情。 + /// 必填：否 + /// 最大长度：1000 + /// 最小长度：0 + /// + [JsonPropertyName("employee_type_ids")] + public string[]? EmployeeTypeIds { get; set; } + + /// + /// 工作地点 ID 列表。ID获取方式： + /// - 调用[【创建地点】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/create)[【批量分页查询地点】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)等接口可以返回地点ID + /// 必填：否 + /// 最大长度：1000 + /// 最小长度：0 + /// + [JsonPropertyName("work_location_ids")] + public string[]? WorkLocationIds { get; set; } + + /// + /// 序列 ID 列表。ID获取方式： + /// - 调用[【新建序列】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/create)[【查询租户的序列信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)等接口可以返回序列ID + /// 必填：否 + /// 最大长度：1000 + /// 最小长度：0 + /// + [JsonPropertyName("job_family_ids")] + public string[]? JobFamilyIds { get; set; } + + /// + /// 职级ID。ID获取方式： + /// - 调用[【新建职级】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/create)[【查询租户的职级信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)等接口可以返回职级ID + /// 必填：否 + /// 最大长度：1000 + /// 最小长度：0 + /// + [JsonPropertyName("job_level_ids")] + public string[]? JobLevelIds { get; set; } + + /// + /// 职务ID。ID获取方式： + /// - 调用[【创建职务】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job/create)[【批量查询职务】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/list)等可以返回职务ID + /// - 也可以通过[【事件】创建职务](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job/events/created) [【事件】更新职务](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job/events/updated) 获取ID + /// 必填：否 + /// 最大长度：1000 + /// 最小长度：0 + /// + [JsonPropertyName("job_ids")] + public string[]? JobIds { get; set; } + + /// + /// 成本中心 ID 列表。ID获取方式： + /// - 调用[【创建成本中心】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/create)[【搜索成本中心】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search)等接口可以返回成本中心ID + /// 必填：否 + /// 最大长度：1000 + /// 最小长度：0 + /// + [JsonPropertyName("cost_center_ids")] + public string[]? CostCenterIds { get; set; } +} diff --git a/src/Corehr/PostCorehrV2WorkforcePlanDetailsBatchResponseDto.cs b/src/Corehr/PostCorehrV2WorkforcePlanDetailsBatchResponseDto.cs new file mode 100644 index 00000000..ea99bc83 --- /dev/null +++ b/src/Corehr/PostCorehrV2WorkforcePlanDetailsBatchResponseDto.cs @@ -0,0 +1,205 @@ +// ************************************************************************ +// Assembly : FeishuNetSdk +// Author : yxr +// Created : 2024-09-18 +// +// Last Modified By : yxr +// Last Modified On : 2024-09-18 +// ************************************************************************ +// +// MIT +// +// 查询编制规划明细信息 响应体 +// ************************************************************************ +namespace FeishuNetSdk.Corehr; +/// +/// 查询编制规划明细信息 响应体 +/// 查询编制规划明细，包括维度信息、编制数和预估在职人数 +/// 接口ID：7314710843818524673 +/// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/workforce_plan_detail/batch +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fworkforce_plan_detail%2fbatch +/// +public record PostCorehrV2WorkforcePlanDetailsBatchResponseDto +{ + /// + /// 编制规划方案 ID + /// 必填：否 + /// 示例值：7128319234123 + /// + [JsonPropertyName("workforce_plan_id")] + public string? WorkforcePlanId { get; set; } + + /// + /// 集中填报项目 ID + /// 必填：否 + /// 示例值：7128319234123 + /// + [JsonPropertyName("centralized_reporting_project_id")] + public string? CentralizedReportingProjectId { get; set; } + + /// + /// 编制规划明细信息 + /// 必填：否 + /// + [JsonPropertyName("items")] + public WorkforcePlanDetail[]? Items { get; set; } + + /// + /// 编制规划明细信息 + /// + public record WorkforcePlanDetail + { + /// + /// 编制规划明细 ID + /// 必填：否 + /// 示例值：123456 + /// + [JsonPropertyName("workforce_plan_detail_id")] + public string? WorkforcePlanDetailId { get; set; } + + /// + /// 部门信息 + /// 必填：否 + /// + [JsonPropertyName("department")] + public DimensionInfo? Department { get; set; } + + /// + /// 部门信息 + /// + public record DimensionInfo + { + /// + /// 部门ID。可通过[批量查询部门V2](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get) 或者[搜索部门信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/search) 获取详情 + /// 必填：是 + /// 示例值：123456 + /// + [JsonPropertyName("id")] + public string Id { get; set; } = string.Empty; + + /// + /// 维度名称 + /// 必填：否 + /// + [JsonPropertyName("name")] + public I18n[]? Names { get; set; } + + /// + /// 维度名称 + /// + public record I18n + { + /// + /// 语言信息，中文是 zh-CN，英文是 en-US + /// 必填：是 + /// 示例值：zh-CN + /// + [JsonPropertyName("lang")] + public string Lang { get; set; } = string.Empty; + + /// + /// 内容 + /// 必填：是 + /// 示例值：张三 + /// + [JsonPropertyName("value")] + public string Value { get; set; } = string.Empty; + } + } + + /// + /// 人员类型信息 + /// 必填：否 + /// + [JsonPropertyName("employee_type")] + public DimensionInfo? EmployeeType { get; set; } + + /// + /// 工作地点信息 + /// 必填：否 + /// + [JsonPropertyName("work_location")] + public DimensionInfo? WorkLocation { get; set; } + + /// + /// 序列信息 + /// 必填：否 + /// + [JsonPropertyName("job_family")] + public DimensionInfo? JobFamily { get; set; } + + /// + /// 职级信息 + /// 必填：否 + /// + [JsonPropertyName("job_level")] + public DimensionInfo? JobLevel { get; set; } + + /// + /// 职务信息 + /// 必填：否 + /// + [JsonPropertyName("job")] + public DimensionInfo? Job { get; set; } + + /// + /// 成本中心信息 + /// 必填：否 + /// + [JsonPropertyName("cost_center")] + public DimensionInfo? CostCenter { get; set; } + + /// + /// 编制规划值 + /// 必填：否 + /// 示例值：10.00 + /// + [JsonPropertyName("workforce_plan")] + public string? WorkforcePlan { get; set; } + + /// + /// 预估在职人数明细 + /// 必填：否 + /// + [JsonPropertyName("estimated_active_individuals_detail")] + public WorkforcePlanEaiDetail[]? EstimatedActiveIndividualsDetails { get; set; } + + /// + /// 预估在职人数明细 + /// + public record WorkforcePlanEaiDetail + { + /// + /// 预估月份 + /// 必填：否 + /// 示例值：2020-10-31 + /// + [JsonPropertyName("date")] + public string? Date { get; set; } + + /// + /// 预估在职人数 + /// 必填：否 + /// 示例值：10.00 + /// + [JsonPropertyName("estimated_active_individuals")] + public string? EstimatedActiveIndividuals { get; set; } + } + } + + /// + /// 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token + /// 必填：否 + /// 示例值：34523459 + /// + [JsonPropertyName("page_token")] + public string? PageToken { get; set; } + + /// + /// 是否还有更多项 + /// 必填：否 + /// 示例值：true + /// + [JsonPropertyName("has_more")] + public bool? HasMore { get; set; } +} diff --git a/src/FeishuNetSdk.csproj b/src/FeishuNetSdk.csproj index 0ccb2d43..3ab2229e 100644 --- a/src/FeishuNetSdk.csproj +++ b/src/FeishuNetSdk.csproj @@ -16,7 +16,7 @@ MIT 适用于飞书开放平台的.Net开发包 LICENSE - 3.0.1 + 3.0.2 diff --git a/src/FeishuPeople.Events/CorehrJobCreatedV1EventBodyDto.cs b/src/FeishuPeople.Events/CorehrJobCreatedV1EventBodyDto.cs index 80126d24..c0b888fb 100644 --- a/src/FeishuPeople.Events/CorehrJobCreatedV1EventBodyDto.cs +++ b/src/FeishuPeople.Events/CorehrJobCreatedV1EventBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.FeishuPeople.Events; /// /// 创建职务 事件体 -/// 飞书人事中「职务被创建」时将触发此事件。{使用示例}(url=/api/tools/api_explore/api_explore_config?project=corehr&version=v1&resource=job&event=created) +/// 飞书人事中「职务被创建」时将触发此事件。注意：触发时间为职务实际生效时间，如在 2022-01-01 创建职务，职务生效时间设置为 2022-05-01，事件将在 2022-05-01 进行推送。{使用示例}(url=/api/tools/api_explore/api_explore_config?project=corehr&version=v1&resource=job&event=created) /// 接口ID：7273083612789260291 /// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job/events/created /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fcorehr-v1%2fjob%2fevents%2fcreated @@ -22,7 +22,7 @@ namespace FeishuNetSdk.FeishuPeople.Events; public record CorehrJobCreatedV1EventBodyDto() : EventBodyDto("corehr.job.created_v1") { /// - /// Job ID + /// 职务 ID，可通过[【查询单个职务】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job/get)获取详细信息 /// 必填：否 /// [JsonPropertyName("job_id")] diff --git a/src/FeishuPeople.Events/CorehrJobUpdatedV1EventBodyDto.cs b/src/FeishuPeople.Events/CorehrJobUpdatedV1EventBodyDto.cs index e58d85a3..0c9682bc 100644 --- a/src/FeishuPeople.Events/CorehrJobUpdatedV1EventBodyDto.cs +++ b/src/FeishuPeople.Events/CorehrJobUpdatedV1EventBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.FeishuPeople.Events; /// /// 更新职务 事件体 -/// 飞书人事中「职务信息被更新」时将触发此事件。{使用示例}(url=/api/tools/api_explore/api_explore_config?project=corehr&version=v1&resource=job&event=updated) +/// 飞书人事中「职务信息被更新」时将触发此事件。注意：触发时间为职务实际生效时间，如在 2022-01-01 更新职务，职务生效时间设置为 2022-05-01，事件将在 2022-05-01 进行推送。{使用示例}(url=/api/tools/api_explore/api_explore_config?project=corehr&version=v1&resource=job&event=updated) /// 接口ID：7273083612789227523 /// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job/events/updated /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fcorehr-v1%2fjob%2fevents%2fupdated @@ -22,7 +22,7 @@ namespace FeishuNetSdk.FeishuPeople.Events; public record CorehrJobUpdatedV1EventBodyDto() : EventBodyDto("corehr.job.updated_v1") { /// - /// Job ID + /// 职务 ID，可通过[【查询单个职务】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job/get)获取详细信息 /// 必填：否 /// [JsonPropertyName("job_id")] diff --git a/src/FeishuPeople/GetCorehrV1JobsByJobIdResponseDto.cs b/src/FeishuPeople/GetCorehrV1JobsByJobIdResponseDto.cs index c760e2db..8cf67db7 100644 --- a/src/FeishuPeople/GetCorehrV1JobsByJobIdResponseDto.cs +++ b/src/FeishuPeople/GetCorehrV1JobsByJobIdResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.FeishuPeople; /// /// 查询单个职务 响应体 -/// 根据 ID 查询单个职务。 +/// 该接口支持通过职务id批量查询当天的职务详情信息，包括职务包含的名称、描述、启用状态等。 /// 接口ID：7017694651621998596 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/job-management/job/get /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fcorehr-v1%2fjob%2fget @@ -62,7 +62,7 @@ public record GetCorehrV1JobsByJobIdResponseDtoJob public record I18n { /// - /// 名称信息的语言 + /// 名称信息的语言，中文用zh-CN，英文用en-US /// 必填：是 /// 示例值：zh-CN /// @@ -101,21 +101,21 @@ public record I18n public I18n[]? JobTitles { get; set; } /// - /// 职务序列 ID 列表，枚举值及详细信息可通过【批量查询职务序列】接口查询获得 + /// 职务序列 ID 列表，枚举值及详细信息可通过[【批量查询序列】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)接口查询获得 /// 必填：否 /// [JsonPropertyName("job_family_id_list")] public string[]? JobFamilyIdList { get; set; } /// - /// 职务级别 ID 列表，枚举值及详细信息可通过【批量查询职务级别】接口查询获得 + /// 职务级别 ID 列表，枚举值及详细信息可通过[【批量查询职级】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)接口查询获得 /// 必填：否 /// [JsonPropertyName("job_level_id_list")] public string[]? JobLevelIdList { get; set; } /// - /// 工时制度 ID，枚举值及详细信息可通过【批量查询工时制度】接口查询获得 + /// 工时制度 ID，枚举值及详细信息可通过[【批量查询工时制度】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/list)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -124,29 +124,33 @@ public record I18n /// /// 生效时间 + /// - 返回格式：YYYY-MM-DD 00:00:00（最小单位到日） + /// - 日期范围:1900-01-01 00:00:00～9999-12-31 23:59:59 /// 必填：是 - /// 示例值：2020-01-0100:00:00 + /// 示例值：2020-01-01 00:00:00 /// [JsonPropertyName("effective_time")] public string EffectiveTime { get; set; } = string.Empty; /// /// 失效时间 + /// - 返回格式：YYYY-MM-DD 00:00:00（最小单位到日） + /// - 日期范围:1900-01-01 00:00:00～9999-12-31 23:59:59 /// 必填：否 - /// 示例值：2021-01-0100:00:00 + /// 示例值：2021-01-01 00:00:00 /// [JsonPropertyName("expiration_time")] public string? ExpirationTime { get; set; } /// - /// 自定义字段 + /// 自定义字段（暂不支持） /// 必填：否 /// [JsonPropertyName("custom_fields")] public ObjectFieldData[]? CustomFields { get; set; } /// - /// 自定义字段 + /// 自定义字段（暂不支持） /// public record ObjectFieldData { diff --git a/src/FeishuPeople/PatchCorehrV1JobFamiliesByJobFamilyIdBodyDto.cs b/src/FeishuPeople/PatchCorehrV1JobFamiliesByJobFamilyIdBodyDto.cs index 1831f50e..d2a82029 100644 --- a/src/FeishuPeople/PatchCorehrV1JobFamiliesByJobFamilyIdBodyDto.cs +++ b/src/FeishuPeople/PatchCorehrV1JobFamiliesByJobFamilyIdBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.FeishuPeople; /// /// 更新序列 请求体 -/// 更新序列。 +/// 可以通过序列ID更新单个序列详情信息，例如序列名称、上级序列ID等。 /// 接口ID：7072646533586927644 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/job-management/job_family/patch /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fcorehr-v1%2fjob_family%2fpatch @@ -22,19 +22,19 @@ namespace FeishuNetSdk.FeishuPeople; public record PatchCorehrV1JobFamiliesByJobFamilyIdBodyDto { /// - /// 名称 + /// 序列名称 /// 必填：否 /// [JsonPropertyName("name")] public I18n[]? Names { get; set; } /// - /// 名称 + /// 序列名称 /// public record I18n { /// - /// 名称信息的语言 + /// 语言信息，中文用zh-CN，英文用en-US /// 必填：是 /// 示例值：zh-CN /// @@ -42,9 +42,11 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 名称信息的内容 + /// 序列名称 + /// - 名称不能包含「/」「；」「;」字符。 + /// - 序列中英文名称会有全局唯一校验 /// 必填：是 - /// 示例值：张三 + /// 示例值：研发序列 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -59,7 +61,8 @@ public record I18n public bool? Active { get; set; } /// - /// 上级序列 ID，枚举值及详细信息可通过【批量查询序列】接口查询获得 + /// 上级序列ID。ID获取方式： + /// - 调用[【新建序列】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/create)[【查询租户的序列信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)等接口可以返回序列ID /// 必填：否 /// 示例值：4698020757495316313 /// @@ -67,23 +70,35 @@ public record I18n public string? ParentId { get; set; } /// - /// 生效时间 + /// 版本生效日期 + /// - 填写格式：YYYY-MM-DD 00:00:00（系统会自动将时分秒改为00:00:00） + /// - 系统默认为填写日期当天的 00:00:00 生效 + /// - 该接口只支持到最小单位为日 + /// - 日期范围要求:1900-01-01 00:00:00～9999-12-31 23:59:59 + /// - 详情可以参考[时间轴介绍](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/about-timeline-version) /// 必填：否 - /// 示例值：2020-05-0100:00:00 + /// 示例值：2020-05-01 00:00:00 /// [JsonPropertyName("effective_time")] public string? EffectiveTime { get; set; } /// - /// 失效时间 + /// 版本生效日期 + /// - 填写格式：YYYY-MM-DD + /// - 系统默认为填写日期当天的 00:00:00 生效 + /// - 该接口只支持到最小单位为日 + /// - 日期范围要求:1900-01-01～9999-12-31 + /// - 详情可以参考[时间轴介绍](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/about-timeline-version) /// 必填：否 - /// 示例值：2020-05-0200:00:00 + /// 示例值：2020-05-02 00:00:00 /// [JsonPropertyName("expiration_time")] public string? ExpirationTime { get; set; } /// - /// 编码 + /// 序列编码 (不能与其他记录的编码重复) + /// - 开启自动编码时，如果不传值会自动生成编码，否则以传入值为准 + /// - 未开启自动编码时，不传值不会自动生成编码 /// 必填：否 /// 示例值：123456 /// @@ -91,19 +106,19 @@ public record I18n public string? Code { get; set; } /// - /// 自定义字段 + /// 自定义字段（该字段暂时不支持） /// 必填：否 /// [JsonPropertyName("custom_fields")] public ObjectFieldData[]? CustomFields { get; set; } /// - /// 自定义字段 + /// 自定义字段（该字段暂时不支持） /// public record ObjectFieldData { /// - /// 字段名 + /// 自定义字段 API Name，即自定义字段的唯一标识 /// 必填：是 /// 示例值：name /// diff --git a/src/FeishuPeople/PatchCorehrV1JobFamiliesByJobFamilyIdResponseDto.cs b/src/FeishuPeople/PatchCorehrV1JobFamiliesByJobFamilyIdResponseDto.cs index a1271d10..cfe199a1 100644 --- a/src/FeishuPeople/PatchCorehrV1JobFamiliesByJobFamilyIdResponseDto.cs +++ b/src/FeishuPeople/PatchCorehrV1JobFamiliesByJobFamilyIdResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.FeishuPeople; /// /// 更新序列 响应体 -/// 更新序列。 +/// 可以通过序列ID更新单个序列详情信息，例如序列名称、上级序列ID等。 /// 接口ID：7072646533586927644 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/job-management/job_family/patch /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fcorehr-v1%2fjob_family%2fpatch @@ -79,7 +79,8 @@ public record I18n public bool Active { get; set; } /// - /// 上级序列 ID，枚举值及详细信息可通过【批量查询序列】接口查询获得 + /// 上级序列ID + /// - 可通过[批量查询序列](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_family/batch_get)获取详情 /// 必填：否 /// 示例值：4698020757495316313 /// @@ -87,23 +88,27 @@ public record I18n public string? ParentId { get; set; } /// - /// 生效时间 + /// 当前版本生效日期 + /// - 返回格式：YYYY-MM-DD 00:00:00（最小单位到日） + /// - 日期范围:1900-01-01 00:00:00～9999-12-31 00:00:00 /// 必填：是 - /// 示例值：2020-05-0100:00:00 + /// 示例值：2020-05-01 00:00:00 /// [JsonPropertyName("effective_time")] public string EffectiveTime { get; set; } = string.Empty; /// - /// 失效时间 + /// 当前版本失效日期 + /// - 返回格式：YYYY-MM-DD 00:00:00（最小单位到日） + /// - 日期范围:1900-01-01 00:00:00～9999-12-31 00:00:00 /// 必填：否 - /// 示例值：2020-05-0200:00:00 + /// 示例值：2020-05-02 00:00:00 /// [JsonPropertyName("expiration_time")] public string? ExpirationTime { get; set; } /// - /// 编码 + /// 序列编码 /// 必填：否 /// 示例值：123456 /// @@ -111,14 +116,14 @@ public record I18n public string? Code { get; set; } /// - /// 自定义字段 + /// 自定义字段（暂不支持该功能，可忽略） /// 必填：否 /// [JsonPropertyName("custom_fields")] public ObjectFieldData[]? CustomFields { get; set; } /// - /// 自定义字段 + /// 自定义字段（暂不支持该功能，可忽略） /// public record ObjectFieldData { diff --git a/src/FeishuPeople/PatchCorehrV1JobLevelsByJobLevelIdBodyDto.cs b/src/FeishuPeople/PatchCorehrV1JobLevelsByJobLevelIdBodyDto.cs index 3c5a7ea7..8b688b1d 100644 --- a/src/FeishuPeople/PatchCorehrV1JobLevelsByJobLevelIdBodyDto.cs +++ b/src/FeishuPeople/PatchCorehrV1JobLevelsByJobLevelIdBodyDto.cs @@ -9,12 +9,12 @@ // // MIT // -// 更新职级 请求体 +// 更新单个职级 请求体 // ************************************************************************ namespace FeishuNetSdk.FeishuPeople; /// -/// 更新职级 请求体 -/// 更新职级。 +/// 更新单个职级 请求体 +/// 该接口可以通过职级ID更新单个职级信息，包括职级数值、名称等信息。 /// 接口ID：7072714700206768130 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/job-management/job_level/patch /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fcorehr-v1%2fjob_level%2fpatch @@ -22,7 +22,8 @@ namespace FeishuNetSdk.FeishuPeople; public record PatchCorehrV1JobLevelsByJobLevelIdBodyDto { /// - /// 职级数值 + /// 职级数值，该字段主要用来在职级大小排序，职级的数值越大，代表职级越高 + /// - 如果不填该字段则不更新 /// 必填：否 /// 示例值：9999 /// @@ -30,7 +31,7 @@ public record PatchCorehrV1JobLevelsByJobLevelIdBodyDto public int? LevelOrder { get; set; } /// - /// 编码 + /// 职级编码。非必填字段，如果非空值会校验全局唯一性，如果传空值则不参与全局校验。 /// 必填：否 /// 示例值：VQzo/BSonp8l6PmcZ+VlDhkd2595LMkhyBAGX6HAlCY= /// @@ -38,19 +39,19 @@ public record PatchCorehrV1JobLevelsByJobLevelIdBodyDto public string? Code { get; set; } /// - /// 名称 + /// 职级名称 /// 必填：否 /// [JsonPropertyName("name")] public I18n[]? Names { get; set; } /// - /// 名称 + /// 职级名称 /// public record I18n { /// - /// 名称信息的语言 + /// 名称信息的语言，中文用zh-CN，英文用en-US /// 必填：是 /// 示例值：zh-CN /// @@ -60,7 +61,7 @@ public record I18n /// /// 名称信息的内容 /// 必填：是 - /// 示例值：张三 + /// 示例值：高级工程师 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -82,14 +83,14 @@ public record I18n public bool? Active { get; set; } /// - /// 自定义字段 + /// 自定义字段（该字段暂时不支持） /// 必填：否 /// [JsonPropertyName("custom_fields")] public ObjectFieldData[]? CustomFields { get; set; } /// - /// 自定义字段 + /// 自定义字段（该字段暂时不支持） /// public record ObjectFieldData { @@ -102,7 +103,7 @@ public record ObjectFieldData public string FieldName { get; set; } = string.Empty; /// - /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", [\"id1\",\"id2\"], "2006-01-02 15:04:05") + /// 字段值，是json转义后的字符串，具体传值方式参见[获取自定义字段的元数据](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide) /// 必填：是 /// 示例值：\"Sandy\" /// diff --git a/src/FeishuPeople/PatchCorehrV1JobLevelsByJobLevelIdResponseDto.cs b/src/FeishuPeople/PatchCorehrV1JobLevelsByJobLevelIdResponseDto.cs index 2668a1de..5880feb6 100644 --- a/src/FeishuPeople/PatchCorehrV1JobLevelsByJobLevelIdResponseDto.cs +++ b/src/FeishuPeople/PatchCorehrV1JobLevelsByJobLevelIdResponseDto.cs @@ -9,12 +9,12 @@ // // MIT // -// 更新职级 响应体 +// 更新单个职级 响应体 // ************************************************************************ namespace FeishuNetSdk.FeishuPeople; /// -/// 更新职级 响应体 -/// 更新职级。 +/// 更新单个职级 响应体 +/// 该接口可以通过职级ID更新单个职级信息，包括职级数值、名称等信息。 /// 接口ID：7072714700206768130 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/job-management/job_level/patch /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fcorehr-v1%2fjob_level%2fpatch @@ -102,19 +102,19 @@ public record I18n public bool Active { get; set; } /// - /// 自定义字段 + /// 自定义字段(该功能暂不支持，可忽略) /// 必填：否 /// [JsonPropertyName("custom_fields")] public ObjectFieldData[]? CustomFields { get; set; } /// - /// 自定义字段 + /// 自定义字段(该功能暂不支持，可忽略) /// public record ObjectFieldData { /// - /// 字段名 + /// 自定义字段 API Name，即自定义字段的唯一标识 /// 必填：是 /// 示例值：name /// @@ -122,9 +122,9 @@ public record ObjectFieldData public string FieldName { get; set; } = string.Empty; /// - /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", [\"id1\",\"id2\"], "2006-01-02 15:04:05") + /// 自定义字段值 /// 必填：是 - /// 示例值：\"Sandy\" + /// 示例值：\"工程师\" /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; diff --git a/src/FeishuPeople/PatchCorehrV1JobsByJobIdBodyDto.cs b/src/FeishuPeople/PatchCorehrV1JobsByJobIdBodyDto.cs index ffe1ac1d..13355e00 100644 --- a/src/FeishuPeople/PatchCorehrV1JobsByJobIdBodyDto.cs +++ b/src/FeishuPeople/PatchCorehrV1JobsByJobIdBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.FeishuPeople; /// /// 更新职务 请求体 -/// 更新职务。 +/// 你可以通过该接口更新一个职务信息。 /// 接口ID：7072588575270944796 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/job-management/job/patch /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fcorehr-v1%2fjob%2fpatch @@ -22,7 +22,9 @@ namespace FeishuNetSdk.FeishuPeople; public record PatchCorehrV1JobsByJobIdBodyDto { /// - /// 编码 + /// 职务编码 (不能与其他记录的编码重复) + /// - 开启自动编码时，如果不传值会自动生成编码，否则以传入值为准 + /// - 未开启自动编码时，不传值不会自动生成编码 /// 必填：否 /// 示例值：JP422119 /// @@ -30,19 +32,23 @@ public record PatchCorehrV1JobsByJobIdBodyDto public string? Code { get; set; } /// - /// 名称 + /// 职务名称 + /// - 名称不能包含「/」「；」「;」字符 + /// - xx中英文名称会有全局唯一校验 /// 必填：否 /// [JsonPropertyName("name")] public I18n[]? Names { get; set; } /// - /// 名称 + /// 职务名称 + /// - 名称不能包含「/」「；」「;」字符 + /// - xx中英文名称会有全局唯一校验 /// public record I18n { /// - /// 名称信息的语言 + /// 语言信息，中文用zh-CN，英文用en-US /// 必填：是 /// 示例值：zh-CN /// @@ -66,7 +72,7 @@ public record I18n public I18n[]? Descriptions { get; set; } /// - /// 是否启用 + /// 是否启用，true为停用，fasle为启用 /// 必填：否 /// 示例值：true /// @@ -81,7 +87,8 @@ public record I18n public I18n[]? JobTitles { get; set; } /// - /// 职务序列 ID 列表，枚举值及详细信息可通过【批量查询职务序列】接口查询获得 + /// 职务序列 ID 列表。ID获取方式： + /// - 调用[【新建序列】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/create)[【查询租户的序列信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)等接口可以返回序列ID /// 必填：否 /// 示例值：7373183781 /// @@ -89,7 +96,8 @@ public record I18n public string[]? JobFamilyIdList { get; set; } /// - /// 职务级别 ID 列表，枚举值及详细信息可通过【批量查询职务级别】接口查询获得 + /// 职务级别 ID 列表。ID获取方式： + /// - 调用[【新建职级】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/create)[【查询租户的职级信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)等接口可以返回职级ID /// 必填：否 /// 示例值：316316317 /// @@ -97,7 +105,7 @@ public record I18n public string[]? JobLevelIdList { get; set; } /// - /// 工时制度 ID，枚举值及详细信息可通过【批量查询工时制度】接口查询获得 + /// 工时制度 ID，枚举值及详细信息可通过[【批量查询工时制度】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/list)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -105,30 +113,38 @@ public record I18n public string? WorkingHoursTypeId { get; set; } /// - /// 生效时间 + /// 版本生效日期 + /// - 填写格式：YYYY-MM-DD 00:00:00（系统会自动将时分秒改为00:00:00） + /// - 系统默认为填写日期当天的 00:00:00 生效 + /// - 该接口只支持到最小单位为日 + /// - 日期范围要求:1900-01-01 00:00:00～9999-12-31 23:59:59 /// 必填：否 - /// 示例值：2020-01-0100:00:00 + /// 示例值：2020-01-01 00:00:00 /// [JsonPropertyName("effective_time")] public string? EffectiveTime { get; set; } /// - /// 失效时间 + /// 版本失效日期 + /// - 填写格式：YYYY-MM-DD 00:00:00（系统会自动将时分秒改为00:00:00） + /// - 本次编辑的记录版本失效的时间， 如果用户在本次操作的生效日期之后修改了对象信息，则系统会将下一次操作的日期作为当前记录的失效时间。 + /// - 系统默认为填写日期当天的 00:00:00 失效 + /// - 日期范围要求:1900-01-01 00:00:00～9999-12-31 23:59:59 /// 必填：否 - /// 示例值：2021-01-0100:00:00 + /// 示例值：2021-01-01 00:00:00 /// [JsonPropertyName("expiration_time")] public string? ExpirationTime { get; set; } /// - /// 自定义字段 + /// 自定义字段（暂不支持该功能，可忽略） /// 必填：否 /// [JsonPropertyName("custom_fields")] public ObjectFieldData[]? CustomFields { get; set; } /// - /// 自定义字段 + /// 自定义字段（暂不支持该功能，可忽略） /// public record ObjectFieldData { diff --git a/src/FeishuPeople/PatchCorehrV1JobsByJobIdResponseDto.cs b/src/FeishuPeople/PatchCorehrV1JobsByJobIdResponseDto.cs index 57bea4d0..9692f7ac 100644 --- a/src/FeishuPeople/PatchCorehrV1JobsByJobIdResponseDto.cs +++ b/src/FeishuPeople/PatchCorehrV1JobsByJobIdResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.FeishuPeople; /// /// 更新职务 响应体 -/// 更新职务。 +/// 你可以通过该接口更新一个职务信息。 /// 接口ID：7072588575270944796 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/job-management/job/patch /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fcorehr-v1%2fjob%2fpatch @@ -101,7 +101,8 @@ public record I18n public I18n[]? JobTitles { get; set; } /// - /// 职务序列 ID 列表，枚举值及详细信息可通过【批量查询职务序列】接口查询获得 + /// 职务序列 ID 列表 + /// - 可通过[批量查询序列](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_family/batch_get)获取详情 /// 必填：否 /// 示例值：7373183781 /// @@ -109,7 +110,8 @@ public record I18n public string[]? JobFamilyIdList { get; set; } /// - /// 职务级别 ID 列表，枚举值及详细信息可通过【批量查询职务级别】接口查询获得 + /// 职务级别 ID 列表 + /// - 可通过[批量查询职级](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_level/batch_get)获取详情 /// 必填：否 /// 示例值：316316317 /// @@ -117,7 +119,7 @@ public record I18n public string[]? JobLevelIdList { get; set; } /// - /// 工时制度 ID，枚举值及详细信息可通过【批量查询工时制度】接口查询获得 + /// 工时制度 ID，枚举值及详细信息可通过[【批量查询工时制度】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/list)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -125,30 +127,34 @@ public record I18n public string? WorkingHoursTypeId { get; set; } /// - /// 生效时间 + /// 当前版本生效日期 + /// - 返回格式：YYYY-MM-DD 00:00:00（最小单位到日） + /// - 日期范围:1900-01-01 00:00:00～9999-12-31 00:00:00 /// 必填：是 - /// 示例值：2020-01-0100:00:00 + /// 示例值：2020-01-01 00:00:00 /// [JsonPropertyName("effective_time")] public string EffectiveTime { get; set; } = string.Empty; /// - /// 失效时间 + /// 当前版本失效日期 + /// - 返回格式：YYYY-MM-DD 00:00:00（最小单位到日） + /// - 日期范围:1900-01-01 00:00:00～9999-12-31 00:00:00 /// 必填：否 - /// 示例值：2021-01-0100:00:00 + /// 示例值：2021-01-01 00:00:00 /// [JsonPropertyName("expiration_time")] public string? ExpirationTime { get; set; } /// - /// 自定义字段 + /// 自定义字段（该功能暂不支持，可忽略） /// 必填：否 /// [JsonPropertyName("custom_fields")] public ObjectFieldData[]? CustomFields { get; set; } /// - /// 自定义字段 + /// 自定义字段（该功能暂不支持，可忽略） /// public record ObjectFieldData { diff --git a/src/FeishuPeople/PostCorehrV1JobFamiliesBodyDto.cs b/src/FeishuPeople/PostCorehrV1JobFamiliesBodyDto.cs index e29657d3..3bf0a933 100644 --- a/src/FeishuPeople/PostCorehrV1JobFamiliesBodyDto.cs +++ b/src/FeishuPeople/PostCorehrV1JobFamiliesBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.FeishuPeople; /// /// 创建序列 请求体 -/// 创建序列。 +/// 可以通过该接口创建单个序列信息，同时该接口会针对该接口的内容做校验。 /// 接口ID：7017707615190925315 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/job-management/job_family/create /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fcorehr-v1%2fjob_family%2fcreate @@ -22,19 +22,19 @@ namespace FeishuNetSdk.FeishuPeople; public record PostCorehrV1JobFamiliesBodyDto { /// - /// 名称 + /// 序列名称 /// 必填：是 /// [JsonPropertyName("name")] public I18n[] Names { get; set; } = Array.Empty(); /// - /// 名称 + /// 序列名称 /// public record I18n { /// - /// 名称信息的语言 + /// 名称信息的语言，中文用zh-CN，英文用en-US /// 必填：是 /// 示例值：zh-CN /// @@ -43,6 +43,8 @@ public record I18n /// /// 名称信息的内容 + /// - 名称不能包含「/」「；」「;」字符 + /// - 序列中英文名称会有全局唯一校验 /// 必填：是 /// 示例值：张三 /// @@ -51,7 +53,7 @@ public record I18n } /// - /// 是否启用 + /// 是否启用，true为启用，false为停用 /// 必填：是 /// 示例值：true /// @@ -59,7 +61,8 @@ public record I18n public bool Active { get; set; } /// - /// 上级序列 ID，枚举值及详细信息可通过【批量查询序列】接口查询获得 + /// 上级序列 ID。ID获取方式： + /// - 调用[【新建序列】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/create)[【查询租户的序列信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)等接口可以返回序列ID /// 必填：否 /// 示例值：4698020757495316313 /// @@ -67,23 +70,32 @@ public record I18n public string? ParentId { get; set; } /// - /// 生效时间 + /// 版本生效日期 + /// - 填写格式：YYYY-MM-DD 00:00:00（系统会自动将时分秒改为00:00:00） + /// - 系统默认为填写日期当天的 00:00:00 生效 + /// - 该接口只支持到最小单位为日 + /// - 日期范围要求:1900-01-01 00:00:00～9999-12-31 23:59:59 + /// - 详情可以参考[时间轴介绍](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/about-timeline-version) /// 必填：是 - /// 示例值：2020-05-0100:00:00 + /// 示例值：2020-05-01 00:00:00 /// [JsonPropertyName("effective_time")] public string EffectiveTime { get; set; } = string.Empty; /// - /// 失效时间 + /// 版本失效日期 + /// - 填写格式：YYYY-MM-DD 00:00:00（系统会自动将时分秒改为00:00:00） + /// - 系统默认为填写日期当天的 00:00:00 失效 + /// - 日期范围要求:1900-01-01 00:00:00～9999-12-31 23:59:59 + /// - 详情可以参考[时间轴介绍](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/about-timeline-version) /// 必填：否 - /// 示例值：2020-05-0200:00:00 + /// 示例值：2020-05-02 00:00:00 /// [JsonPropertyName("expiration_time")] public string? ExpirationTime { get; set; } /// - /// 编码 + /// 编码 (不能与其他记录的编码重复)，当开启自动编码时，该字段会失效 /// 必填：否 /// 示例值：123456 /// @@ -91,14 +103,14 @@ public record I18n public string? Code { get; set; } /// - /// 自定义字段 + /// 自定义字段（该字段暂时不支持） /// 必填：否 /// [JsonPropertyName("custom_fields")] public ObjectFieldData[]? CustomFields { get; set; } /// - /// 自定义字段 + /// 自定义字段（该字段暂时不支持） /// public record ObjectFieldData { @@ -112,6 +124,7 @@ public record ObjectFieldData /// /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", [\"id1\",\"id2\"], "2006-01-02 15:04:05") + /// - 自定义字段类型，详细见[获取自定义字段列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/query) /// 必填：是 /// 示例值：\"Sandy\" /// diff --git a/src/FeishuPeople/PostCorehrV1JobFamiliesResponseDto.cs b/src/FeishuPeople/PostCorehrV1JobFamiliesResponseDto.cs index c2a6eedc..94bc53b5 100644 --- a/src/FeishuPeople/PostCorehrV1JobFamiliesResponseDto.cs +++ b/src/FeishuPeople/PostCorehrV1JobFamiliesResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.FeishuPeople; /// /// 创建序列 响应体 -/// 创建序列。 +/// 可以通过该接口创建单个序列信息，同时该接口会针对该接口的内容做校验。 /// 接口ID：7017707615190925315 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/job-management/job_family/create /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fcorehr-v1%2fjob_family%2fcreate @@ -54,7 +54,7 @@ public record PostCorehrV1JobFamiliesResponseDtoJobFamily public record I18n { /// - /// 名称信息的语言 + /// 名称信息的语言，中文用zh-CN，英文用en-US /// 必填：是 /// 示例值：zh-CN /// @@ -79,7 +79,8 @@ public record I18n public bool Active { get; set; } /// - /// 上级序列 ID，枚举值及详细信息可通过【批量查询序列】接口查询获得 + /// 上级序列 ID + /// - 可通过[批量查询序列](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_family/batch_get)获取详情 /// 必填：否 /// 示例值：4698020757495316313 /// @@ -87,17 +88,23 @@ public record I18n public string? ParentId { get; set; } /// - /// 生效时间 + /// 版本生效日期 + /// - 返回格式：YYYY-MM-DD 00:00:00（最小单位到日） + /// - 日期范围:1900-01-01 00:00:00～9999-12-31 23:59:59 + /// - 详情可以参考[时间轴介绍](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/about-timeline-version) /// 必填：是 - /// 示例值：2020-05-0100:00:00 + /// 示例值：2020-05-01 00:00:00 /// [JsonPropertyName("effective_time")] public string EffectiveTime { get; set; } = string.Empty; /// - /// 失效时间 + /// 版本失效日期 + /// - 返回格式：YYYY-MM-DD 00:00:00（最小单位到日） + /// - 日期范围:1900-01-01 00:00:00～9999-12-31 23:59:59 + /// - 详情可以参考[时间轴介绍](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/about-timeline-version) /// 必填：否 - /// 示例值：2020-05-0200:00:00 + /// 示例值：2020-05-02 00:00:00 /// [JsonPropertyName("expiration_time")] public string? ExpirationTime { get; set; } @@ -111,14 +118,14 @@ public record I18n public string? Code { get; set; } /// - /// 自定义字段 + /// 自定义字段（暂不支持该功能，可忽略） /// 必填：否 /// [JsonPropertyName("custom_fields")] public ObjectFieldData[]? CustomFields { get; set; } /// - /// 自定义字段 + /// 自定义字段（暂不支持该功能，可忽略） /// public record ObjectFieldData { diff --git a/src/FeishuPeople/PostCorehrV1JobLevelsBodyDto.cs b/src/FeishuPeople/PostCorehrV1JobLevelsBodyDto.cs index ce66cafe..c9974378 100644 --- a/src/FeishuPeople/PostCorehrV1JobLevelsBodyDto.cs +++ b/src/FeishuPeople/PostCorehrV1JobLevelsBodyDto.cs @@ -9,12 +9,12 @@ // // MIT // -// 创建职级 请求体 +// 新建职级 请求体 // ************************************************************************ namespace FeishuNetSdk.FeishuPeople; /// -/// 创建职级 请求体 -/// 创建职级 +/// 新建职级 请求体 +/// 使用指定信息创建职级信息，每次调用支持创建1个职级对象，接口内会做相关规则校验。 /// 接口ID：7017707615191154691 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/job-management/job_level/create /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fcorehr-v1%2fjob_level%2fcreate @@ -22,7 +22,7 @@ namespace FeishuNetSdk.FeishuPeople; public record PostCorehrV1JobLevelsBodyDto { /// - /// 职级数值 + /// 职级数值，该字段主要用来在职级大小排序，职级的数值越大，代表职级越高 /// 必填：是 /// 示例值：9999 /// @@ -30,7 +30,7 @@ public record PostCorehrV1JobLevelsBodyDto public int LevelOrder { get; set; } /// - /// 编码 + /// 职级编码。非必填字段，如果非空值会校验全局唯一性，如果传空值则不参与全局校验。 /// 必填：否 /// 示例值：VQzo/BSonp8l6PmcZ+VlDhkd2595LMkhyBAGX6HAlCY= /// @@ -38,19 +38,19 @@ public record PostCorehrV1JobLevelsBodyDto public string? Code { get; set; } /// - /// 名称 + /// 职级名称 /// 必填：是 /// [JsonPropertyName("name")] public I18n[] Names { get; set; } = Array.Empty(); /// - /// 名称 + /// 职级名称 /// public record I18n { /// - /// 名称信息的语言 + /// 名称信息的语言，中文用zh-CN，英文用en-US /// 必填：是 /// 示例值：zh-CN /// @@ -58,9 +58,11 @@ public record I18n public string Lang { get; set; } = string.Empty; /// - /// 名称信息的内容 + /// 名称信息的内容。 + /// - 职级中英文名称会有全局唯一校验 + /// - 名称不能包含「/」「；」「;」字符 /// 必填：是 - /// 示例值：张三 + /// 示例值：初级工程师 /// [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; @@ -74,7 +76,7 @@ public record I18n public I18n[]? Descriptions { get; set; } /// - /// 是否启用 + /// 是否启用，true为启用，false为停用 /// 必填：是 /// 示例值：true /// @@ -82,14 +84,14 @@ public record I18n public bool Active { get; set; } /// - /// 自定义字段 + /// 自定义字段（目前职级暂不支持该功能） /// 必填：否 /// [JsonPropertyName("custom_fields")] public ObjectFieldData[]? CustomFields { get; set; } /// - /// 自定义字段 + /// 自定义字段（目前职级暂不支持该功能） /// public record ObjectFieldData { @@ -102,7 +104,8 @@ public record ObjectFieldData public string FieldName { get; set; } = string.Empty; /// - /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", [\"id1\",\"id2\"], "2006-01-02 15:04:05") + /// 字段值，为 JSON 转义后的字符串。 + /// **注意：具体传值方式参见**[获取自定义字段的元数据](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide) /// 必填：是 /// 示例值：\"Sandy\" /// diff --git a/src/FeishuPeople/PostCorehrV1JobLevelsResponseDto.cs b/src/FeishuPeople/PostCorehrV1JobLevelsResponseDto.cs index 665858f7..038fdb2c 100644 --- a/src/FeishuPeople/PostCorehrV1JobLevelsResponseDto.cs +++ b/src/FeishuPeople/PostCorehrV1JobLevelsResponseDto.cs @@ -9,12 +9,12 @@ // // MIT // -// 创建职级 响应体 +// 新建职级 响应体 // ************************************************************************ namespace FeishuNetSdk.FeishuPeople; /// -/// 创建职级 响应体 -/// 创建职级 +/// 新建职级 响应体 +/// 使用指定信息创建职级信息，每次调用支持创建1个职级对象，接口内会做相关规则校验。 /// 接口ID：7017707615191154691 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/job-management/job_level/create /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fcorehr-v1%2fjob_level%2fcreate @@ -42,7 +42,7 @@ public record PostCorehrV1JobLevelsResponseDtoJobLevel public string? Id { get; set; } /// - /// 职级数值 + /// 职级数值，该字段主要用来在职级大小排序，职级的数值越大，代表职级越高 /// 必填：是 /// 示例值：9999 /// @@ -102,14 +102,14 @@ public record I18n public bool Active { get; set; } /// - /// 自定义字段 + /// 自定义字段(该功能暂不支持，可忽略) /// 必填：否 /// [JsonPropertyName("custom_fields")] public ObjectFieldData[]? CustomFields { get; set; } /// - /// 自定义字段 + /// 自定义字段(该功能暂不支持，可忽略) /// public record ObjectFieldData { @@ -122,7 +122,7 @@ public record ObjectFieldData public string FieldName { get; set; } = string.Empty; /// - /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", [\"id1\",\"id2\"], "2006-01-02 15:04:05") + /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同。如：```("\"123\"", "\"123.23\"", "\"true\"", [\"id1\",\"id2\"], \"2006-01-02 15:04:05\")``` /// 必填：是 /// 示例值：\"Sandy\" /// diff --git a/src/FeishuPeople/PostCorehrV1JobsBodyDto.cs b/src/FeishuPeople/PostCorehrV1JobsBodyDto.cs index c0e8e279..2d32d7a8 100644 --- a/src/FeishuPeople/PostCorehrV1JobsBodyDto.cs +++ b/src/FeishuPeople/PostCorehrV1JobsBodyDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.FeishuPeople; /// /// 创建职务 请求体 -/// 创建职务。 +/// 可以通过该接口新建职务信息。 /// 接口ID：7017707615191040003 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/job-management/job/create /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fcorehr-v1%2fjob%2fcreate @@ -22,7 +22,9 @@ namespace FeishuNetSdk.FeishuPeople; public record PostCorehrV1JobsBodyDto { /// - /// 编码 + /// 职务编码 (不能与其他记录的编码重复) + /// - 开启自动编码时，如果不传值会自动生成编码，否则以传入值为准 + /// - 未开启自动编码时，不传值不会自动生成编码 /// 必填：否 /// 示例值：JP422119 /// @@ -30,19 +32,23 @@ public record PostCorehrV1JobsBodyDto public string? Code { get; set; } /// - /// 名称 + /// 职务名称 + /// - 名称不能包含「/」「；」「;」字符 + /// - 职务中英文名称会有全局唯一校验 /// 必填：是 /// [JsonPropertyName("name")] public I18n[] Names { get; set; } = Array.Empty(); /// - /// 名称 + /// 职务名称 + /// - 名称不能包含「/」「；」「;」字符 + /// - 职务中英文名称会有全局唯一校验 /// public record I18n { /// - /// 名称信息的语言 + /// 语言信息，中文用zh-CN，英文用en-US /// 必填：是 /// 示例值：zh-CN /// @@ -66,7 +72,7 @@ public record I18n public I18n[]? Descriptions { get; set; } /// - /// 是否启用 + /// 是否启用，true为启用，false为停用 /// 必填：是 /// 示例值：true /// @@ -81,7 +87,8 @@ public record I18n public I18n[]? JobTitles { get; set; } /// - /// 职务序列 ID 列表，枚举值及详细信息可通过【批量查询职务序列】接口查询获得 + /// 职务序列 ID 列表 + /// - 可通过[批量查询序列](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_family/batch_get)获取详情 /// 必填：否 /// 示例值：7373183781 /// @@ -89,7 +96,8 @@ public record I18n public string[]? JobFamilyIdList { get; set; } /// - /// 职务级别 ID 列表，枚举值及详细信息可通过【批量查询职务级别】接口查询获得 + /// 职务级别 ID 列表 + /// - 可通过[批量查询序列](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_family/batch_get)获取详情 /// 必填：否 /// 示例值：316316317 /// @@ -97,7 +105,7 @@ public record I18n public string[]? JobLevelIdList { get; set; } /// - /// 工时制度 ID，枚举值及详细信息可通过【批量查询工时制度】接口查询获得 + /// 工时制度 ID，枚举值及详细信息可通过[【批量查询工时制度】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/list)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -105,30 +113,39 @@ public record I18n public string? WorkingHoursTypeId { get; set; } /// - /// 生效时间 + /// 版本生效日期 + /// - 填写格式：YYYY-MM-DD 00:00:00（系统会自动将时分秒改为00:00:00） + /// - 系统默认为填写日期当天的 00:00:00 生效 + /// - 该接口只支持到最小单位为日 + /// - 日期范围要求:1900-01-01 00:00:00～9999-12-31 23:59:59 + /// - 详情可以参考[时间轴介绍](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/about-timeline-version) /// 必填：是 - /// 示例值：2020-01-0100:00:00 + /// 示例值：2020-01-01 00:00:00 /// [JsonPropertyName("effective_time")] public string EffectiveTime { get; set; } = string.Empty; /// - /// 失效时间 + /// 版本失效日期 + /// - 填写格式：YYYY-MM-DD 00:00:00（系统会自动将时分秒改为00:00:00） + /// - 系统默认为填写日期当天的 00:00:00 失效 + /// - 日期范围要求:1900-01-01 00:00:00～9999-12-31 23:59:59 + /// - 详情可以参考[时间轴介绍](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/about-timeline-version) /// 必填：否 - /// 示例值：2021-01-0100:00:00 + /// 示例值：2021-01-01 00:00:00 /// [JsonPropertyName("expiration_time")] public string? ExpirationTime { get; set; } /// - /// 自定义字段 + /// 自定义字段（该功能暂不支持，可忽略） /// 必填：否 /// [JsonPropertyName("custom_fields")] public ObjectFieldData[]? CustomFields { get; set; } /// - /// 自定义字段 + /// 自定义字段（该功能暂不支持，可忽略） /// public record ObjectFieldData { diff --git a/src/FeishuPeople/PostCorehrV1JobsResponseDto.cs b/src/FeishuPeople/PostCorehrV1JobsResponseDto.cs index 2fc92648..05b9b993 100644 --- a/src/FeishuPeople/PostCorehrV1JobsResponseDto.cs +++ b/src/FeishuPeople/PostCorehrV1JobsResponseDto.cs @@ -14,7 +14,7 @@ namespace FeishuNetSdk.FeishuPeople; /// /// 创建职务 响应体 -/// 创建职务。 +/// 可以通过该接口新建职务信息。 /// 接口ID：7017707615191040003 /// 文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/job-management/job/create /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fcorehr-v1%2fjob%2fcreate @@ -42,7 +42,7 @@ public record PostCorehrV1JobsResponseDtoJob public string? Id { get; set; } /// - /// 编码 + /// 职务编码 /// 必填：否 /// 示例值：JP422119 /// @@ -50,14 +50,14 @@ public record PostCorehrV1JobsResponseDtoJob public string? Code { get; set; } /// - /// 名称 + /// 职务名称 /// 必填：是 /// [JsonPropertyName("name")] public I18n[] Names { get; set; } = Array.Empty(); /// - /// 名称 + /// 职务名称 /// public record I18n { @@ -86,7 +86,7 @@ public record I18n public I18n[]? Descriptions { get; set; } /// - /// 是否启用 + /// 是否启用，true为启用，false为停用 /// 必填：是 /// 示例值：true /// @@ -101,7 +101,8 @@ public record I18n public I18n[]? JobTitles { get; set; } /// - /// 职务序列 ID 列表，枚举值及详细信息可通过【批量查询职务序列】接口查询获得 + /// 职务序列 ID 列表 + /// - 可通过[批量查询序列](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_family/batch_get)获取详情 /// 必填：否 /// 示例值：7373183781 /// @@ -109,7 +110,8 @@ public record I18n public string[]? JobFamilyIdList { get; set; } /// - /// 职务级别 ID 列表，枚举值及详细信息可通过【批量查询职务级别】接口查询获得 + /// 职务级别 ID 列表 + /// - 可通过[批量查询职级](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_level/batch_get)获取详情 /// 必填：否 /// 示例值：316316317 /// @@ -117,7 +119,7 @@ public record I18n public string[]? JobLevelIdList { get; set; } /// - /// 工时制度 ID，枚举值及详细信息可通过【批量查询工时制度】接口查询获得 + /// 工时制度 ID，枚举值及详细信息可通过[【批量查询工时制度】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/list)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -125,30 +127,36 @@ public record I18n public string? WorkingHoursTypeId { get; set; } /// - /// 生效时间 + /// 版本生效日期 + /// - 返回格式：YYYY-MM-DD 00:00:00（最小单位到日） + /// - 日期范围:1900-01-01 00:00:00～9999-12-31 23:59:59 + /// - 详情可以参考[时间轴介绍](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/about-timeline-version) /// 必填：是 - /// 示例值：2020-01-0100:00:00 + /// 示例值：2020-01-01 00:00:00 /// [JsonPropertyName("effective_time")] public string EffectiveTime { get; set; } = string.Empty; /// - /// 失效时间 + /// 版本失效日期 + /// - 返回格式：YYYY-MM-DD 00:00:00（最小单位到日） + /// - 日期范围:1900-01-01 00:00:00～9999-12-31 23:59:59 + /// - 详情可以参考[时间轴介绍](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/about-timeline-version) /// 必填：否 - /// 示例值：2021-01-0100:00:00 + /// 示例值：2021-01-01 00:00:00 /// [JsonPropertyName("expiration_time")] public string? ExpirationTime { get; set; } /// - /// 自定义字段 + /// 自定义字段（该功能暂不支持，可忽略） /// 必填：否 /// [JsonPropertyName("custom_fields")] public ObjectFieldData[]? CustomFields { get; set; } /// - /// 自定义字段 + /// 自定义字段（该功能暂不支持，可忽略） /// public record ObjectFieldData { diff --git a/src/Helpdesk/GetHelpdeskV1TicketsByTicketIdResponseDto.cs b/src/Helpdesk/GetHelpdeskV1TicketsByTicketIdResponseDto.cs index d34afa8a..4e1758af 100644 --- a/src/Helpdesk/GetHelpdeskV1TicketsByTicketIdResponseDto.cs +++ b/src/Helpdesk/GetHelpdeskV1TicketsByTicketIdResponseDto.cs @@ -402,7 +402,7 @@ public record CustomizedFieldDisplayItem public long? BotServiceDuration { get; set; } /// - /// 客服解决时长，关单时间距离客服进入时间的间隔，单位秒 + /// 客服解决时长，从首位客服接入服务到工单关闭的用时，单位秒 /// 必填：否 /// 示例值：66 /// @@ -410,7 +410,7 @@ public record CustomizedFieldDisplayItem public long? AgentResolutionTime { get; set; } /// - /// 工单实际处理时间：从客服进入到关单，单位秒 + /// 工单实际处理时长，处理时长=解决时长-工单待定时长（将工单状态修改为待定后的时间），单位秒 /// 必填：否 /// 示例值：68 /// diff --git a/src/Hire/PostHireV1JobsByJobIdUpdateConfigBodyDto.cs b/src/Hire/PostHireV1JobsByJobIdUpdateConfigBodyDto.cs index e5efb08d..0aa2fffd 100644 --- a/src/Hire/PostHireV1JobsByJobIdUpdateConfigBodyDto.cs +++ b/src/Hire/PostHireV1JobsByJobIdUpdateConfigBodyDto.cs @@ -57,7 +57,9 @@ public record PostHireV1JobsByJobIdUpdateConfigBodyDto public int[] UpdateOptionList { get; set; } = Array.Empty(); /// - /// 面试评价表 ID，可通过[获取面试评价表列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/interview_feedback_form/list)接口获取，当`update_option_list`包含`更新面试评价表`时，该参数必填 + /// 面试评价表 ID，可通过[获取面试评价表列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/interview_feedback_form/list)接口获取，当同时满足以下两个条件时，该参数必填： + /// - `update_option_list`包含`更新面试评价表` + /// - 「飞书招聘」-「设置」-「面试轮次类型设置」-「启用面试轮次类型」开关关闭 /// 必填：否 /// 示例值：6960663240925956571 /// @@ -124,14 +126,18 @@ public record JobConfigInterviewRoundConf public string? OnboardRegistrationSchemaId { get; set; } /// - /// 面试轮次类型 ID 列表，当`update_option_list`包含`更新面试评价表`时，该参数必填 + /// 面试轮次类型 ID 列表，当同时满足以下两个条件时，该参数必填： + /// - `update_option_list`包含`更新面试评价表` + /// - 「飞书招聘」-「设置」-「面试轮次类型设置」-「启用面试轮次类型」开关打开 /// 必填：否 /// [JsonPropertyName("interview_round_type_conf_list")] public JobConfigRoundType[]? InterviewRoundTypeConfLists { get; set; } /// - /// 面试轮次类型 ID 列表，当`update_option_list`包含`更新面试评价表`时，该参数必填 + /// 面试轮次类型 ID 列表，当同时满足以下两个条件时，该参数必填： + /// - `update_option_list`包含`更新面试评价表` + /// - 「飞书招聘」-「设置」-「面试轮次类型设置」-「启用面试轮次类型」开关打开 /// public record JobConfigRoundType { diff --git a/src/IFeishuTenantApi.cs b/src/IFeishuTenantApi.cs index dbf3cd5f..fa9b020c 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-09-12 +// Last Modified On : 2024-09-18 // ************************************************************************ // // MIT @@ -9201,7 +9201,7 @@ System.Threading.Tasks.Task PostHelpdeskV1EventsUnsubscribeAsync /// /// 路径参数 /// 必填：是 - /// ticket id + /// 工单 ID。可通过[查询全部工单详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/helpdesk-v1/ticket/list)获取 /// 示例值：123456 /// [HttpGet("/open-apis/helpdesk/v1/tickets/{ticket_id}")] @@ -16946,7 +16946,7 @@ System.Threading.Tasks.Task DeleteCorehrV1EmployeeTypesByEmploye /// 接口ID：7017694651621965828 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/delete /// Authorization：tenant_access_token - /// 删除序列。 + /// 该接口支持通过序列ID删除单个序列信息。 /// 权限要求： /// corehr:corehr /// corehr:job_family:write @@ -16955,7 +16955,8 @@ System.Threading.Tasks.Task DeleteCorehrV1EmployeeTypesByEmploye /// /// 路径参数 /// 必填：是 - /// 需要删除的序列 ID + /// 需要删除的序列 ID。ID获取方式： + /// - 调用[【新建序列】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/create)[【查询租户的序列信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)等接口可以返回序列ID /// 示例值：5425424525 /// [HttpDelete("/open-apis/corehr/v1/job_families/{job_family_id}")] @@ -16967,7 +16968,7 @@ System.Threading.Tasks.Task DeleteCorehrV1JobFamiliesByJobFamily /// 接口ID：7017694651621998596 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job/get /// Authorization：tenant_access_token - /// 根据 ID 查询单个职务。 + /// 该接口支持通过职务id批量查询当天的职务详情信息，包括职务包含的名称、描述、启用状态等。 /// 权限要求： /// corehr:corehr /// corehr:corehr:readonly @@ -17451,7 +17452,7 @@ System.Threading.Tasks.Task DeleteCorehrV1ContractsByContractIdA /// 接口ID：7017707615190925315 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/create /// Authorization：tenant_access_token - /// 创建序列。 + /// 可以通过该接口创建单个序列信息，同时该接口会针对该接口的内容做校验。 /// 权限要求： /// corehr:corehr /// corehr:job_family:write @@ -17765,7 +17766,7 @@ System.Threading.Tasks.Task DeleteCorehrV1ContractsByContractIdA /// 接口ID：7017707615191040003 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job/create /// Authorization：tenant_access_token - /// 创建职务。 + /// 可以通过该接口新建职务信息。 /// 权限要求： /// corehr:corehr /// corehr:job:write @@ -17939,7 +17940,8 @@ System.Threading.Tasks.Task DeleteCorehrV1ContractsByContractIdA /// 接口ID：7017707615191138307 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/delete /// Authorization：tenant_access_token - /// 删除职级 + /// 可以通过该接口通过职级ID删除一个职级对象。 + /// - 删除对象时请确认有无在职员工、待入职单据、职务等关联此对象，如有会导致删除失败。 /// 权限要求： /// corehr:corehr /// corehr:job_level:write @@ -17948,7 +17950,8 @@ System.Threading.Tasks.Task DeleteCorehrV1ContractsByContractIdA /// /// 路径参数 /// 必填：是 - /// 需要删除的职级 ID + /// 需要删除的职级 ID。ID获取方式： + /// - 调用[【新建职级】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/create)[【查询租户的职级信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)等接口可以返回职级ID /// 示例值：5423452542 /// [HttpDelete("/open-apis/corehr/v1/job_levels/{job_level_id}")] @@ -17956,11 +17959,11 @@ System.Threading.Tasks.Task DeleteCorehrV1JobLevelsByJobLevelIdA [PathQuery] string job_level_id); /// - /// 【飞书人事】创建职级 + /// 【飞书人事】新建职级 /// 接口ID：7017707615191154691 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/create /// Authorization：tenant_access_token - /// 创建职级 + /// 使用指定信息创建职级信息，每次调用支持创建1个职级对象，接口内会做相关规则校验。 /// 权限要求： /// corehr:corehr /// corehr:job_level:write @@ -18034,7 +18037,7 @@ System.Threading.Tasks.Task DeleteCorehrV1JobLevelsByJobLevelIdA /// 接口ID：7017707615191203843 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job/delete /// Authorization：tenant_access_token - /// 删除职务。 + /// 你可以通过该接口删除一个职务信息。 /// 权限要求： /// corehr:corehr /// corehr:job:write @@ -18043,7 +18046,9 @@ System.Threading.Tasks.Task DeleteCorehrV1JobLevelsByJobLevelIdA /// /// 路径参数 /// 必填：是 - /// 需要删除的职务 ID + /// 需要删除的职务 ID。ID获取方式： + /// - 调用[【创建职务】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job/create)[【批量查询职务】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/list)等可以返回职务ID + /// - 也可以通过[【事件】创建职务](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job/events/created) [【事件】更新职务](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job/events/updated) 获取ID /// 示例值：67163716371 /// [HttpDelete("/open-apis/corehr/v1/jobs/{job_id}")] @@ -21691,7 +21696,7 @@ System.Threading.Tasks.Task DeleteCorehrV1EmploymentsByEmploymen /// 接口ID：7072588575270944796 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job/patch /// Authorization：tenant_access_token - /// 更新职务。 + /// 你可以通过该接口更新一个职务信息。 /// 权限要求： /// corehr:corehr /// corehr:job:write @@ -21700,7 +21705,9 @@ System.Threading.Tasks.Task DeleteCorehrV1EmploymentsByEmploymen /// /// 路径参数 /// 必填：是 - /// 职务ID + /// 职务ID。ID获取方式： + /// - 调用[【创建职务】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job/create)[【批量查询职务】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/list)等可以返回职务ID + /// - 也可以通过[【事件】创建职务](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job/events/created) [【事件】更新职务](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job/events/updated) 获取ID /// 示例值：1616161616 /// /// @@ -21941,7 +21948,7 @@ System.Threading.Tasks.Task DeleteCorehrV1WorkingHoursTypesByWor /// 接口ID：7072646533586927644 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/patch /// Authorization：tenant_access_token - /// 更新序列。 + /// 可以通过序列ID更新单个序列详情信息，例如序列名称、上级序列ID等。 /// 权限要求： /// corehr:corehr /// corehr:job_family:write @@ -21950,7 +21957,8 @@ System.Threading.Tasks.Task DeleteCorehrV1WorkingHoursTypesByWor /// /// 路径参数 /// 必填：是 - /// 序列ID + /// 序列ID。ID获取方式： + /// - 调用[【新建序列】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/create)[【查询租户的序列信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)等接口可以返回序列ID /// 示例值：1616161616 /// /// @@ -22031,7 +22039,8 @@ System.Threading.Tasks.Task DeleteCorehrV1WorkingHoursTypesByWor /// /// 路径参数 /// 必填：是 - /// 需要删除的地点 ID + /// 需要删除的地点 ID。ID获取方式： + /// - 调用[【创建地点】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/create)[【批量分页查询地点】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)等接口可以返回地点ID /// 示例值：4312443243 /// [HttpDelete("/open-apis/corehr/v1/locations/{location_id}")] @@ -22272,11 +22281,11 @@ System.Threading.Tasks.Task PatchApplicationV6ApplicationsByAppI [PathQuery] int? page_size = 100); /// - /// 【飞书人事】更新职级 + /// 【飞书人事】更新单个职级 /// 接口ID：7072714700206768130 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/patch /// Authorization：tenant_access_token - /// 更新职级。 + /// 该接口可以通过职级ID更新单个职级信息，包括职级数值、名称等信息。 /// 权限要求： /// corehr:corehr /// corehr:job_level:write @@ -22285,7 +22294,8 @@ System.Threading.Tasks.Task PatchApplicationV6ApplicationsByAppI /// /// 路径参数 /// 必填：是 - /// 级别ID + /// 职级ID。ID获取方式： + /// - 调用[【新建职级】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/create)[【查询租户的职级信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)等接口可以返回职级ID /// 示例值：1616161616 /// /// @@ -25676,6 +25686,7 @@ System.Threading.Tasks.Task PostBitableV1AppsByAppTokenRolesByRo /// Authorization：tenant_access_token、user_access_token /// 该接口用于更新表单中的问题项 /// 权限要求： + /// base:form:update /// bitable:app /// /// @@ -25683,34 +25694,34 @@ System.Threading.Tasks.Task PostBitableV1AppsByAppTokenRolesByRo /// 路径参数 /// 必填：是 /// 多维表格文档 Token - /// **示例值**："bascnCMII2ORej2RItqpZZUNMIe" + /// 示例值：bascnCMII2ORej2RItqpZZUNMIe /// /// /// 路径参数 /// 必填：是 /// 表格 ID - /// **示例值**："tblsRc9GRRXKqhvW" + /// 示例值：tblsRc9GRRXKqhvW /// /// /// 路径参数 /// 必填：是 /// 表单 ID - /// **示例值**："vewTpR1urY" + /// 示例值：vewTpR1urY /// /// /// 路径参数 /// 必填：是 /// 表单问题 ID - /// **示例值**："fldjX7dUj5" + /// 示例值：fldjX7dUj5 /// /// 请求体 [HttpPatch("/open-apis/bitable/v1/apps/{app_token}/tables/{table_id}/forms/{form_id}/fields/{field_id}")] - System.Threading.Tasks.Task> PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFieldsByFieldIdAsync( + System.Threading.Tasks.Task> PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFieldsByFieldIdAsync( [PathQuery] string app_token, [PathQuery] string table_id, [PathQuery] string form_id, [PathQuery] string field_id, - [JsonContent] Base.Spec.PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFieldsByFieldIdBodyDto dto); + [JsonContent] Base.PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFieldsByFieldIdBodyDto dto); /// /// 【多维表格】列出表单问题 @@ -25719,6 +25730,7 @@ System.Threading.Tasks.Task PostBitableV1AppsByAppTokenRolesByRo /// Authorization：tenant_access_token、user_access_token /// 列出表单的所有问题项 /// 权限要求： + /// base:form:read /// bitable:app /// bitable:app:readonly /// @@ -26761,6 +26773,7 @@ System.Threading.Tasks.Task PostApprovalV4ApprovalsByApprovalCod /// Authorization：tenant_access_token、user_access_token /// 该接口用于更新表单中的元数据项 /// 权限要求： + /// base:form:update /// bitable:app /// /// @@ -26797,6 +26810,7 @@ System.Threading.Tasks.Task PostApprovalV4ApprovalsByApprovalCod /// Authorization：tenant_access_token、user_access_token /// 获取表单的所有元数据项 /// 权限要求： + /// base:form:read /// bitable:app /// bitable:app:readonly /// @@ -27792,6 +27806,7 @@ System.Threading.Tasks.Task DeleteCorehrV1LeaveGrantingRecordsBy /// Authorization：tenant_access_token、user_access_token /// 根据 app_token，获取多维表格下的所有仪表盘 /// 权限要求： + /// base:dashboard:read /// bitable:app /// bitable:app:readonly /// @@ -31856,8 +31871,9 @@ System.Threading.Tasks.Task PutContactV3FunctionalRolesByRoleIdA /// 接口ID：7205776220394160156 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app/copy /// Authorization：tenant_access_token、user_access_token - /// 复制一个多维表格，可以指定复制到某个有权限的文件夹下 + /// 复制一个多维表格，可以指定复制到某个有权限的文件夹下。 /// 权限要求： + /// base:app:copy /// bitable:app /// /// @@ -33404,7 +33420,8 @@ System.Threading.Tasks.Task DeleteCorehrV2CostCentersByCostCente /// /// 路径参数 /// 必填：是 - /// 成本中心ID；可通过[【搜索成本中心信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search)接口查询获得 + /// 成本ID。ID获取方式： + /// - 调用[【创建成本中心】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/create)[【搜索成本中心】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search)等接口可以返回成本中心ID /// 示例值：6862995757234914824 /// /// 请求体 @@ -33501,7 +33518,7 @@ System.Threading.Tasks.Task DeleteCorehrV2CostCentersByCostCente /// 接口ID：7225452763517206531 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/patch /// Authorization：tenant_access_token - /// 对成本中心进行启用和停用操作，支持单个操作 + /// 该接口支持对单个成本中心进行启用和停用操作。 /// 权限要求： /// corehr:cost_center:write /// @@ -39588,6 +39605,35 @@ System.Threading.Tasks.Task DeleteHireV1TripartiteAgreementsByTr [PathQuery] int page_size = 100, [PathQuery] string? page_token = null); + /// + /// 【飞书人事（企业版）】查询编制规划明细信息 + /// 接口ID：7314710843818524673 + /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/workforce_plan_detail/batch + /// Authorization：tenant_access_token + /// 查询编制规划明细，包括维度信息、编制数和预估在职人数 + /// 权限要求： + /// corehr:workforce_detail:read + /// + /// + /// + /// 必填：否 + /// 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果 + /// 示例值：["123456"] + /// 默认值：null + /// + /// + /// 必填：否 + /// 分页大小 + /// 示例值：100 + /// 默认值：100 + /// + /// 请求体 + [HttpPost("/open-apis/corehr/v2/workforce_plan_details/batch")] + System.Threading.Tasks.Task> PostCorehrV2WorkforcePlanDetailsBatchAsync( + [JsonContent] Corehr.PostCorehrV2WorkforcePlanDetailsBatchBodyDto dto, + [PathQuery] string? page_token = null, + [PathQuery] int? page_size = 100); + /// /// 【消息与群组】解绑标签与群 /// 接口ID：7315032956271263748 @@ -42480,5 +42526,57 @@ System.Threading.Tasks.Task GetBoardV1WhiteboardsByWhiteboa [PathQuery] string? wk_working_hours_type_id = null, [PathQuery] string? wk_job_family_id = null, [PathQuery] string? wk_company_id = null); + + /// + /// 【飞书人事（企业版）】查询部门变更记录 + /// 接口ID：7414100499044646940 + /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/query_recent_change + /// Authorization：tenant_access_token + /// 查询指定时间范围内部门变更记录 + /// 权限要求： + /// corehr:department:read + /// corehr:department:write + /// + /// + /// + /// 必填：是 + /// 分页大小，最大 2000 + /// 示例值：100 + /// 默认值：10 + /// + /// + /// 必填：否 + /// 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果 + /// 示例值：6891251722631890445 + /// 默认值：null + /// + /// + /// 必填：是 + /// 查询的开始时间，格式 "YYYY-MM-DD"，不带时分秒. 系统会以查询的开始时间的 00:00:00 查询。 + /// 示例值：2024-06-01 + /// + /// + /// 必填：是 + /// 查询的结束时间，格式 "YYYY-MM-DD"，不带时分秒，查询日期小于查询的结束时间 + 1 天的 00:00:00。 + /// 示例值：2024-08-01 + /// + /// + /// 必填：否 + /// 此次调用中使用的部门 ID 类型 + /// 示例值：people_corehr_department_id + /// + /// open_department_id：以 open_department_id 来标识部门 + /// department_id：以 department_id 来标识部门 + /// people_corehr_department_id：以 people_corehr_department_id 来标识部门 + /// + /// 默认值：people_corehr_department_id + /// + [HttpGet("/open-apis/corehr/v2/departments/query_recent_change")] + System.Threading.Tasks.Task> GetCorehrV2DepartmentsQueryRecentChangeAsync( + [PathQuery] string start_date, + [PathQuery] string end_date, + [PathQuery] int page_size = 10, + [PathQuery] string? page_token = null, + [PathQuery] string? department_id_type = "people_corehr_department_id"); } diff --git a/src/IFeishuUserApi.cs b/src/IFeishuUserApi.cs index 225268f1..a4fbd32d 100644 --- a/src/IFeishuUserApi.cs +++ b/src/IFeishuUserApi.cs @@ -12222,6 +12222,7 @@ System.Threading.Tasks.Task PostBitableV1AppsByAppTokenRolesByRo /// Authorization：tenant_access_token、user_access_token /// 该接口用于更新表单中的问题项 /// 权限要求： + /// base:form:update /// bitable:app /// /// @@ -12229,36 +12230,36 @@ System.Threading.Tasks.Task PostBitableV1AppsByAppTokenRolesByRo /// 路径参数 /// 必填：是 /// 多维表格文档 Token - /// **示例值**："bascnCMII2ORej2RItqpZZUNMIe" + /// 示例值：bascnCMII2ORej2RItqpZZUNMIe /// /// /// 路径参数 /// 必填：是 /// 表格 ID - /// **示例值**："tblsRc9GRRXKqhvW" + /// 示例值：tblsRc9GRRXKqhvW /// /// /// 路径参数 /// 必填：是 /// 表单 ID - /// **示例值**："vewTpR1urY" + /// 示例值：vewTpR1urY /// /// /// 路径参数 /// 必填：是 /// 表单问题 ID - /// **示例值**："fldjX7dUj5" + /// 示例值：fldjX7dUj5 /// /// 请求体 /// 用户凭证 [HttpPatch("/open-apis/bitable/v1/apps/{app_token}/tables/{table_id}/forms/{form_id}/fields/{field_id}")] - System.Threading.Tasks.Task> PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFieldsByFieldIdAsync( + System.Threading.Tasks.Task> PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFieldsByFieldIdAsync( UserAccessToken access_token, [PathQuery] string app_token, [PathQuery] string table_id, [PathQuery] string form_id, [PathQuery] string field_id, - [JsonContent] Base.Spec.PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFieldsByFieldIdBodyDto dto); + [JsonContent] Base.PatchBitableV1AppsByAppTokenTablesByTableIdFormsByFormIdFieldsByFieldIdBodyDto dto); /// /// 【多维表格】列出表单问题 @@ -12267,6 +12268,7 @@ System.Threading.Tasks.Task PostBitableV1AppsByAppTokenRolesByRo /// Authorization：tenant_access_token、user_access_token /// 列出表单的所有问题项 /// 权限要求： + /// base:form:read /// bitable:app /// bitable:app:readonly /// @@ -12396,6 +12398,7 @@ System.Threading.Tasks.Task PostBitableV1AppsByAppTokenRolesByRo /// Authorization：tenant_access_token、user_access_token /// 该接口用于更新表单中的元数据项 /// 权限要求： + /// base:form:update /// bitable:app /// /// @@ -12434,6 +12437,7 @@ System.Threading.Tasks.Task PostBitableV1AppsByAppTokenRolesByRo /// Authorization：tenant_access_token、user_access_token /// 获取表单的所有元数据项 /// 权限要求： + /// base:form:read /// bitable:app /// bitable:app:readonly /// @@ -12942,6 +12946,7 @@ System.Threading.Tasks.Task PatchSheetsV3SpreadsheetsBySpreadshe /// Authorization：tenant_access_token、user_access_token /// 根据 app_token，获取多维表格下的所有仪表盘 /// 权限要求： + /// base:dashboard:read /// bitable:app /// bitable:app:readonly /// @@ -14270,8 +14275,9 @@ System.Threading.Tasks.Task PostMailV1UserMailboxesByUserMailbox /// 接口ID：7205776220394160156 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app/copy /// Authorization：tenant_access_token、user_access_token - /// 复制一个多维表格，可以指定复制到某个有权限的文件夹下 + /// 复制一个多维表格，可以指定复制到某个有权限的文件夹下。 /// 权限要求： + /// base:app:copy /// bitable:app /// ///