From 0d9d14bebadd8539d3012f696631c90c2c3dc81f Mon Sep 17 00:00:00 2001 From: "Vicente.Yu" <^@^> Date: Thu, 23 May 2024 16:58:11 +0800 Subject: [PATCH] =?UTF-8?q?=E3=80=90=E6=9B=B4=E6=96=B0=E4=BB=BB=E8=81=8C?= =?UTF-8?q?=E4=BF=A1=E6=81=AF=E3=80=91=E8=AF=B7=E6=B1=82=E4=BD=93/?= =?UTF-8?q?=E5=93=8D=E5=BA=94=E4=BD=93=20=E6=9B=B4=E6=96=B0=20=E3=80=90?= =?UTF-8?q?=E5=88=9B=E5=BB=BA=E4=BB=BB=E8=81=8C=E4=BF=A1=E6=81=AF=E3=80=91?= =?UTF-8?q?=E8=AF=B7=E6=B1=82=E4=BD=93/=E5=93=8D=E5=BA=94=E4=BD=93=20?= =?UTF-8?q?=E6=9B=B4=E6=96=B0=20=E3=80=90=E9=A3=9E=E4=B9=A6=E4=BA=BA?= =?UTF-8?q?=E4=BA=8B=E3=80=91=20=E6=96=B0=E5=A2=9E=E6=8E=A5=E5=8F=A3=20-?= =?UTF-8?q?=20=E6=89=B9=E9=87=8F=E6=9F=A5=E8=AF=A2=E7=94=A8=E6=88=B7?= =?UTF-8?q?=E6=8E=88=E6=9D=83=20-=20=E6=9F=A5=E8=AF=A2=E5=8D=95=E4=B8=AA?= =?UTF-8?q?=E7=94=A8=E6=88=B7=E6=8E=88=E6=9D=83=20-=20=E6=89=B9=E9=87=8F?= =?UTF-8?q?=E6=9F=A5=E8=AF=A2=E9=83=A8=E9=97=A8=E7=89=88=E6=9C=AC=E4=BF=A1?= =?UTF-8?q?=E6=81=AF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Vicente.Yu <^@^> --- TenantAccessList.md | 24 +- UserAccessList.md | 6 +- ...yAppIdAppVersionsByVersionIdResponseDto.cs | 70 ++- ...rV2DepartmentsQueryMultiTimelineBodyDto.cs | 48 ++ ...epartmentsQueryMultiTimelineResponseDto.cs | 203 ++++++++ ...CorehrV2DepartmentsQueryTimelineBodyDto.cs | 2 +- ...hrV2DepartmentsQueryTimelineResponseDto.cs | 76 +++ ...hrV1AuthorizationsGetByParamResponseDto.cs | 424 +++++++++++++++++ ...tCorehrV1AuthorizationsQueryResponseDto.cs | 432 ++++++++++++++++++ ...atchCorehrV1CompaniesByCompanyIdBodyDto.cs | 103 +---- ...PatchCorehrV1JobDatasByJobDataIdBodyDto.cs | 83 ++-- ...hCorehrV1JobDatasByJobDataIdResponseDto.cs | 88 ++-- .../PostCorehrV1JobDatasBodyDto.cs | 72 +-- .../PostCorehrV1JobDatasResponseDto.cs | 88 ++-- src/IFeishuTenantApi.cs | 157 ++++++- 15 files changed, 1613 insertions(+), 263 deletions(-) create mode 100644 src/Corehr/PostCorehrV2DepartmentsQueryMultiTimelineBodyDto.cs create mode 100644 src/Corehr/PostCorehrV2DepartmentsQueryMultiTimelineResponseDto.cs create mode 100644 src/FeishuPeople/GetCorehrV1AuthorizationsGetByParamResponseDto.cs create mode 100644 src/FeishuPeople/GetCorehrV1AuthorizationsQueryResponseDto.cs diff --git a/TenantAccessList.md b/TenantAccessList.md index ea0cdda1..eaa06b8f 100644 --- a/TenantAccessList.md +++ b/TenantAccessList.md @@ -1133,7 +1133,7 @@ GetApplicationV6ApplicationsUnderauditlist 5672023-09-12✓应用信息获取应用信息 GetApplicationV6ApplicationsByAppId -5682023-07-21✓应用信息获取应用版本信息 +5682024-05-23✓应用信息获取应用版本信息 GetApplicationV6ApplicationsByAppIdAppVersionsByVersionId 5692023-07-14✓通讯录更新序列 PutContactV3JobFamiliesByJobFamilyId @@ -1361,11 +1361,11 @@ DeleteImV1MessagesByMessageId 6812024-02-06✓飞书人事下载文件 GetCorehrV1FilesById -6822024-02-06✓飞书人事创建任职信息 +6822024-05-23✓飞书人事创建任职信息 PostCorehrV1JobDatas 6832024-02-06✓飞书人事删除任职信息 DeleteCorehrV1JobDatasByJobDataId -6842024-02-06✓飞书人事更新任职信息 +6842024-05-23✓飞书人事更新任职信息 PatchCorehrV1JobDatasByJobDataId 6852024-04-19✓飞书人事查询单个任职信息 GetCorehrV1JobDatasByJobDataId @@ -1539,7 +1539,7 @@ PostHireV1JobsCombinedCreate 7702024-01-22✓招聘获取职位信息 GetHireV1JobsByJobId -7712023-11-02✓招聘获取职位设置 +7712024-05-23✓招聘获取职位设置 GetHireV1JobsByJobIdConfig 7722024-03-28✓招聘更新职位 PostHireV1JobsByJobIdCombinedUpdate @@ -1547,7 +1547,7 @@ PostHireV1JobsByJobIdUpdateConfig 7742023-11-02✓招聘获取职位类别列表 GetHireV1JobTypes -7752024-03-01✓招聘创建招聘需求 +7752024-05-23✓招聘创建招聘需求 PostHireV1JobRequirements 7762024-01-22✓招聘获取招聘需求信息 PostHireV1JobRequirementsSearch @@ -1787,9 +1787,9 @@ GetLingoV1FilesByFileTokenDownload 8942024-04-26✓安全合规获取OpenAPI审计日志数据 PostSecurityAndComplianceV1OpenapiLogsListData -8952024-05-21✓妙记获取妙记统计数据 +8952024-05-22✓妙记获取妙记统计数据 GetMinutesV1MinutesByMinuteTokenStatistics -8962024-05-21✓妙记获取妙记信息 +8962024-05-22✓妙记获取妙记信息 GetMinutesV1MinutesByMinuteToken 8972023-06-29✓工作台获取工作台访问数据 PostWorkplaceV1WorkplaceAccessDataSearch @@ -1989,7 +1989,7 @@ GetBotV3Info 9952024-03-08✓词典删除免审词条 DeleteLingoV1EntitiesByEntityId -9962024-05-10✓飞书人事更新公司 +9962024-05-23✓飞书人事更新公司 PatchCorehrV1CompaniesByCompanyId 9972024-04-02✓飞书人事（企业版）查询流程实例列表 GetCorehrV2Processes @@ -2099,7 +2099,7 @@ PostCorehrV2PreHiresSearch 10502024-04-17✓消息与群组更新 URL 预览 PostImV2UrlPreviewsBatchUpdate -10512024-04-22✓飞书人事（企业版）查询指定生效日期的部门基本信息 +10512024-05-23✓飞书人事（企业版）查询指定生效日期的部门基本信息 PostCorehrV2DepartmentsQueryTimeline 10522024-04-29✓飞书人事（企业版）更新待入职信息（推荐） PatchCorehrV2PreHiresByPreHireId @@ -2127,4 +2127,10 @@ GetCompensationV1Plans 10642024-05-11✓飞书人事（企业版）查询职等 PostCorehrV2JobGradesQuery +10652024-05-23✓飞书人事批量查询用户授权 +GetCorehrV1AuthorizationsQuery +10662024-05-23✓飞书人事查询单个用户授权 +GetCorehrV1AuthorizationsGetByParam +10672024-05-23新增飞书人事（企业版）批量查询部门版本信息 +PostCorehrV2DepartmentsQueryMultiTimeline diff --git a/UserAccessList.md b/UserAccessList.md index 7f5d82c0..2133ad24 100644 --- a/UserAccessList.md +++ b/UserAccessList.md @@ -763,9 +763,9 @@ PostLingoV1FilesUpload 3822023-10-25✓词典下载图片 GetLingoV1FilesByFileTokenDownload -3832024-05-21✓妙记获取妙记统计数据 +3832024-05-22✓妙记获取妙记统计数据 GetMinutesV1MinutesByMinuteTokenStatistics -3842024-05-21✓妙记获取妙记信息 +3842024-05-22✓妙记获取妙记信息 GetMinutesV1MinutesByMinuteToken 3852023-04-07✓应用信息获取用户自定义常用的应用 GetApplicationV5ApplicationsFavourite @@ -963,7 +963,7 @@ PostJssdkTicketGet 4822023-11-24删除词典删除免审词条 DeleteLingoV1EntitiesByEntityId -4832024-05-10✓飞书人事更新公司 +4832024-05-23✓飞书人事更新公司 PatchCorehrV1CompaniesByCompanyId 4842024-04-10✓日历回复日程 PostCalendarV4CalendarsByCalendarIdEventsByEventIdReply diff --git a/src/Application/GetApplicationV6ApplicationsByAppIdAppVersionsByVersionIdResponseDto.cs b/src/Application/GetApplicationV6ApplicationsByAppIdAppVersionsByVersionIdResponseDto.cs index 04499fc4..91bf5320 100644 --- a/src/Application/GetApplicationV6ApplicationsByAppIdAppVersionsByVersionIdResponseDto.cs +++ b/src/Application/GetApplicationV6ApplicationsByAppIdAppVersionsByVersionIdResponseDto.cs @@ -32,6 +32,7 @@ public record ApplicationAppVersion /// 在开发者后台填入的应用版本号 /// 必填：否 /// 示例值：1.0.0 + /// 最小长度：1 /// [JsonPropertyName("version")] public string? Version { get; set; } @@ -48,6 +49,7 @@ public record ApplicationAppVersion /// 应用默认名称 /// 必填：否 /// 示例值：应用名称 + /// 最小长度：1 /// [JsonPropertyName("app_name")] public string? AppName { get; set; } @@ -64,6 +66,7 @@ public record ApplicationAppVersion /// 应用默认描述 /// 必填：否 /// 示例值：应用描述 + /// 最小长度：1 /// [JsonPropertyName("description")] public string? Description { get; set; } @@ -122,6 +125,7 @@ public record AppScope /// /// 应用的国际化信息列表 /// 必填：否 + /// 最小长度：1 /// [JsonPropertyName("i18n")] public AppI18nInfo[]? I18ns { get; set; } @@ -139,6 +143,19 @@ public record AppI18nInfo /// zh_cn：中文 /// en_us：英文 /// ja_jp：日文 + /// zh_hk：繁体中文(中国香港) + /// zh_tw：繁体中文(中国台湾) + /// id_id：印度尼西亚语 + /// ms_my：马来语 + /// de_de：德语 + /// es_es：西班牙语 + /// fr_fr：法语 + /// it_it：意大利语 + /// pt_br：葡萄牙语(巴西) + /// vi_vn：越南语 + /// ru_ru：俄语 + /// th_th：泰语 + /// ko_kr：韩语 /// /// [JsonPropertyName("i18n_key")] @@ -148,6 +165,7 @@ public record AppI18nInfo /// 应用国际化名称 /// 必填：否 /// 示例值：应用名称 + /// 最小长度：1 /// [JsonPropertyName("name")] public string? Name { get; set; } @@ -156,6 +174,7 @@ public record AppI18nInfo /// 应用国际化描述（副标题） /// 必填：否 /// 示例值：应用描述 + /// 最小长度：1 /// [JsonPropertyName("description")] public string? Description { get; set; } @@ -244,8 +263,8 @@ public record AppAbilityGadget /// 必填：否 /// 示例值：1 /// 可选值： - /// 1：sidebar模式 - /// 2：pc模式 + /// 1：sidebar 模式 + /// 2：pc 模式 /// 4：主导航模式 /// /// @@ -271,6 +290,7 @@ public record AppAbilityGadget /// pc 的小程序版本号 /// 必填：否 /// 示例值：1.0.0 + /// 最小长度：1 /// [JsonPropertyName("pc_version")] public string? PcVersion { get; set; } @@ -279,6 +299,7 @@ public record AppAbilityGadget /// 移动端小程序版本号 /// 必填：否 /// 示例值：1.0.0 + /// 最小长度：1 /// [JsonPropertyName("mobile_version")] public string? MobileVersion { get; set; } @@ -287,6 +308,7 @@ public record AppAbilityGadget /// 移动端兼容的最低飞书版本 /// 必填：否 /// 示例值：2.0 + /// 最小长度：1 /// [JsonPropertyName("mobile_min_lark_version")] public string? MobileMinLarkVersion { get; set; } @@ -295,6 +317,7 @@ public record AppAbilityGadget /// pc 端兼容的最低飞书版本 /// 必填：否 /// 示例值：2.0 + /// 最小长度：1 /// [JsonPropertyName("pc_min_lark_version")] public string? PcMinLarkVersion { get; set; } @@ -399,6 +422,7 @@ public record NavigateMeta /// 主导航小程序版本号 /// 必填：否 /// 示例值：1.0.0 + /// 最小长度：1 /// [JsonPropertyName("version")] public string? Version { get; set; } @@ -451,6 +475,7 @@ public record AppAbilityCloudDoc /// /// 国际化信息 /// 必填：否 + /// 最小长度：1 /// [JsonPropertyName("i18n")] public CloudDocI18nInfo[]? I18ns { get; set; } @@ -542,6 +567,7 @@ public record DocsBlock /// /// block 的国际化信息 /// 必填：否 + /// 最小长度：1 /// [JsonPropertyName("i18n")] public BlockI18nInfo[]? I18ns { get; set; } @@ -568,6 +594,7 @@ public record BlockI18nInfo /// 名称 /// 必填：否 /// 示例值：名称 + /// 最小长度：1 /// [JsonPropertyName("name")] public string? Name { get; set; } @@ -621,6 +648,7 @@ public record AppAbilityMessageAction /// /// 国际化信息 /// 必填：否 + /// 最小长度：1 /// [JsonPropertyName("i18n")] public MessageActionI18nInfo[]? I18ns { get; set; } @@ -647,6 +675,7 @@ public record MessageActionI18nInfo /// 国际化名称 /// 必填：否 /// 示例值：名称 + /// 最小长度：1 /// [JsonPropertyName("name")] public string? Name { get; set; } @@ -773,5 +802,42 @@ public record AppVisibleList public AppVisibleList? InvisibleList { get; set; } } } + + /// + /// 应用已订阅事件详情列表 + /// 必填：否 + /// + [JsonPropertyName("event_infos")] + public Event[]? EventInfos { get; set; } + + /// + /// 应用已订阅事件详情列表 + /// + public record Event + { + /// + /// 事件类型，事件唯一标识 + /// 必填：否 + /// 示例值：im.chat.updated_v1 + /// + [JsonPropertyName("event_type")] + public string? EventType { get; set; } + + /// + /// 事件名称 + /// 必填：否 + /// 示例值：群配置修改事件 + /// + [JsonPropertyName("event_name")] + public string? EventName { get; set; } + + /// + /// 事件描述 + /// 必填：否 + /// 示例值：群聊名称、头像、描述以及群编辑权限、群分享权限等被修改时推送事件 + /// + [JsonPropertyName("event_description")] + public string? EventDescription { get; set; } + } } } diff --git a/src/Corehr/PostCorehrV2DepartmentsQueryMultiTimelineBodyDto.cs b/src/Corehr/PostCorehrV2DepartmentsQueryMultiTimelineBodyDto.cs new file mode 100644 index 00000000..1db79145 --- /dev/null +++ b/src/Corehr/PostCorehrV2DepartmentsQueryMultiTimelineBodyDto.cs @@ -0,0 +1,48 @@ +namespace FeishuNetSdk.Corehr; +/// +/// 批量查询部门版本信息 请求体 +/// 批量查询部门版本信息 +/// 接口ID：7372158581884911618 +/// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/query_multi_timeline +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fdepartment%2fquery_multi_timeline +/// +public record PostCorehrV2DepartmentsQueryMultiTimelineBodyDto +{ + /// + /// 部门 ID 列表，可请求[搜索部门信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/search)获取。 + /// 必填：是 + /// 最大长度：10 + /// 最小长度：1 + /// + [JsonPropertyName("department_ids")] + public string[] DepartmentIds { get; set; } = Array.Empty(); + + /// + /// 生效日期开始(包含) + /// 必填：否 + /// 示例值：2024-01-01 + /// 最大长度：10 + /// 最小长度：10 + /// + [JsonPropertyName("effective_date_start")] + public string? EffectiveDateStart { get; set; } + + /// + /// 生效日期结束(包含) + /// 必填：否 + /// 示例值：2024-12-31 + /// 最大长度：10 + /// 最小长度：10 + /// + [JsonPropertyName("effective_date_end")] + public string? EffectiveDateEnd { get; set; } + + /// + /// 返回数据的字段列表，可选["department_name", "code", "active", "parent_department_id", "manager", "description", "effective_date"], 以及自定义字段field_name + /// 必填：否 + /// 最大长度：100 + /// 最小长度：0 + /// + [JsonPropertyName("fields")] + public string[]? Fields { get; set; } +} diff --git a/src/Corehr/PostCorehrV2DepartmentsQueryMultiTimelineResponseDto.cs b/src/Corehr/PostCorehrV2DepartmentsQueryMultiTimelineResponseDto.cs new file mode 100644 index 00000000..88b395e9 --- /dev/null +++ b/src/Corehr/PostCorehrV2DepartmentsQueryMultiTimelineResponseDto.cs @@ -0,0 +1,203 @@ +namespace FeishuNetSdk.Corehr; +/// +/// 批量查询部门版本信息 响应体 +/// 批量查询部门版本信息 +/// 接口ID：7372158581884911618 +/// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/query_multi_timeline +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fdepartment%2fquery_multi_timeline +/// +public record PostCorehrV2DepartmentsQueryMultiTimelineResponseDto +{ + /// + /// 部门信息 + /// 必填：否 + /// + [JsonPropertyName("items")] + public DepartmentTimeline[]? Items { get; set; } + + /// + /// 部门信息 + /// + public record DepartmentTimeline + { + /// + /// 部门 ID + /// 必填：否 + /// 示例值：4719456877659520852 + /// + [JsonPropertyName("id")] + public string? Id { get; set; } + + /// + /// 部门版本 ID + /// 必填：否 + /// 示例值：7238516215202170412 + /// + [JsonPropertyName("version_id")] + public string? VersionId { get; set; } + + /// + /// 部门名称 + /// 必填：否 + /// 最大长度：2 + /// 最小长度：0 + /// + [JsonPropertyName("names")] + public I18n[]? Names { get; set; } + + /// + /// 部门名称 + /// + public record I18n + { + /// + /// 语言 + /// 必填：是 + /// 示例值：zh-CN + /// + [JsonPropertyName("lang")] + public string Lang { get; set; } = string.Empty; + + /// + /// 内容 + /// 必填：是 + /// 示例值：张三 + /// + [JsonPropertyName("value")] + public string Value { get; set; } = string.Empty; + } + + /// + /// 上级部门 ID + /// 必填：否 + /// 示例值：4719456877659520111 + /// + [JsonPropertyName("parent_department_id")] + public string? ParentDepartmentId { get; set; } + + /// + /// 部门负责人雇佣 ID，枚举值及详细信息可通过【查询员工信息】接口查询获得 + /// 必填：否 + /// 示例值：6893013238632416777 + /// + [JsonPropertyName("manager")] + public string? Manager { get; set; } + + /// + /// 编码 + /// 必填：否 + /// 示例值：D00000456 + /// + [JsonPropertyName("code")] + public string? Code { get; set; } + + /// + /// 生效日期 + /// 必填：否 + /// 示例值：2020-05-01 + /// + [JsonPropertyName("effective_date")] + public string? EffectiveDate { get; set; } + + /// + /// 是否启用 + /// 必填：否 + /// 示例值：true + /// + [JsonPropertyName("active")] + public bool? Active { get; set; } + + /// + /// 描述 + /// 必填：否 + /// 最大长度：2 + /// 最小长度：0 + /// + [JsonPropertyName("descriptions")] + public I18n[]? Descriptions { get; set; } + + /// + /// 自定义字段 + /// 必填：否 + /// 最大长度：50 + /// 最小长度：0 + /// + [JsonPropertyName("custom_fields")] + public CustomFieldData[]? CustomFields { get; set; } + + /// + /// 自定义字段 + /// + public record CustomFieldData + { + /// + /// 自定义字段 apiname，即自定义字段的唯一标识 + /// 必填：是 + /// 示例值：name + /// + [JsonPropertyName("custom_api_name")] + public string CustomApiName { get; set; } = string.Empty; + + /// + /// 自定义字段名称 + /// 必填：否 + /// + [JsonPropertyName("name")] + public CustomName? Name { get; set; } + + /// + /// 自定义字段名称 + /// + public record CustomName + { + /// + /// 中文 + /// 必填：否 + /// 示例值：自定义姓名 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 英文 + /// 必填：否 + /// 示例值：Custom Name + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 自定义字段类型 + /// 必填：否 + /// 示例值：1 + /// + [JsonPropertyName("type")] + public int? Type { get; set; } + + /// + /// 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同（如 123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05"） + /// 必填：是 + /// 示例值：\"231\" + /// + [JsonPropertyName("value")] + public string Value { get; set; } = string.Empty; + } + } + + /// + /// 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token + /// 必填：否 + /// 示例值：eVQrYzJBNDNONlk4VFZBZVlSdzlKdFJ4bVVHVExENDNKVHoxaVdiVnViQT0= + /// + [JsonPropertyName("page_token")] + public string? PageToken { get; set; } + + /// + /// 是否还有更多项 + /// 必填：否 + /// 示例值：true + /// + [JsonPropertyName("has_more")] + public bool? HasMore { get; set; } +} diff --git a/src/Corehr/PostCorehrV2DepartmentsQueryTimelineBodyDto.cs b/src/Corehr/PostCorehrV2DepartmentsQueryTimelineBodyDto.cs index c79f808b..75c314a5 100644 --- a/src/Corehr/PostCorehrV2DepartmentsQueryTimelineBodyDto.cs +++ b/src/Corehr/PostCorehrV2DepartmentsQueryTimelineBodyDto.cs @@ -9,7 +9,7 @@ namespace FeishuNetSdk.Corehr; public record PostCorehrV2DepartmentsQueryTimelineBodyDto { /// - /// 部门 ID 列表 + /// 部门 ID 列表，可请求[搜索部门信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/search)获取。 /// 必填：是 /// 最大长度：100 /// 最小长度：0 diff --git a/src/Corehr/PostCorehrV2DepartmentsQueryTimelineResponseDto.cs b/src/Corehr/PostCorehrV2DepartmentsQueryTimelineResponseDto.cs index 0ea68154..851f02aa 100644 --- a/src/Corehr/PostCorehrV2DepartmentsQueryTimelineResponseDto.cs +++ b/src/Corehr/PostCorehrV2DepartmentsQueryTimelineResponseDto.cs @@ -28,6 +28,14 @@ public record DepartmentTimeline [JsonPropertyName("id")] public string? Id { get; set; } + /// + /// 部门版本 ID + /// 必填：否 + /// 示例值：7238516215202170412 + /// + [JsonPropertyName("version_id")] + public string? VersionId { get; set; } + /// /// 部门名称 /// 必填：否 @@ -107,5 +115,73 @@ public record I18n /// [JsonPropertyName("descriptions")] public I18n[]? Descriptions { get; set; } + + /// + /// 自定义字段 + /// 必填：否 + /// 最大长度：50 + /// 最小长度：0 + /// + [JsonPropertyName("custom_fields")] + public CustomFieldData[]? CustomFields { get; set; } + + /// + /// 自定义字段 + /// + public record CustomFieldData + { + /// + /// 自定义字段 apiname，即自定义字段的唯一标识 + /// 必填：是 + /// 示例值：name + /// + [JsonPropertyName("custom_api_name")] + public string CustomApiName { get; set; } = string.Empty; + + /// + /// 自定义字段名称 + /// 必填：否 + /// + [JsonPropertyName("name")] + public CustomName? Name { get; set; } + + /// + /// 自定义字段名称 + /// + public record CustomName + { + /// + /// 中文 + /// 必填：否 + /// 示例值：自定义姓名 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 英文 + /// 必填：否 + /// 示例值：Custom Name + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 自定义字段类型 + /// 必填：否 + /// 示例值：1 + /// + [JsonPropertyName("type")] + public int? Type { get; set; } + + /// + /// 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同（如 123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05"） + /// 必填：是 + /// 示例值：\"231\" + /// + [JsonPropertyName("value")] + public string Value { get; set; } = string.Empty; + } } } diff --git a/src/FeishuPeople/GetCorehrV1AuthorizationsGetByParamResponseDto.cs b/src/FeishuPeople/GetCorehrV1AuthorizationsGetByParamResponseDto.cs new file mode 100644 index 00000000..d2645fc0 --- /dev/null +++ b/src/FeishuPeople/GetCorehrV1AuthorizationsGetByParamResponseDto.cs @@ -0,0 +1,424 @@ +namespace FeishuNetSdk.FeishuPeople; +/// +/// 查询单个用户授权 响应体 +/// 查询「飞书人事」-「权限设置」中的单个用户授权信息。 +/// 接口ID：7372022997609922562 +/// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/authorization/get_by_param +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fcorehr-v1%2fauthorization%2fget_by_param +/// +public record GetCorehrV1AuthorizationsGetByParamResponseDto +{ + /// + /// 角色授权信息 + /// 必填：否 + /// + [JsonPropertyName("role_authorization")] + public GetCorehrV1AuthorizationsGetByParamResponseDtoRoleAuthorization? RoleAuthorization { get; set; } + + /// + /// 角色授权信息 + /// + public record GetCorehrV1AuthorizationsGetByParamResponseDtoRoleAuthorization + { + /// + /// 雇员 ID + /// 必填：是 + /// 示例值：6967639606963471902 + /// + [JsonPropertyName("employment_id")] + public string EmploymentId { get; set; } = string.Empty; + + /// + /// 授权列表 + /// 必填：是 + /// + [JsonPropertyName("permission_detail_list")] + public PermissionDetail[] PermissionDetailLists { get; set; } = Array.Empty(); + + /// + /// 授权列表 + /// + public record PermissionDetail + { + /// + /// 角色 + /// 必填：否 + /// + [JsonPropertyName("role")] + public SecurityGroup? Role { get; set; } + + /// + /// 角色 + /// + public record SecurityGroup + { + /// + /// 角色 ID + /// 必填：是 + /// 示例值：7034393015968122400 + /// + [JsonPropertyName("id")] + public string Id { get; set; } = string.Empty; + + /// + /// 角色 code，通常用于与其他系统进行交互 + /// 必填：是 + /// 示例值：department_manager + /// + [JsonPropertyName("code")] + public string Code { get; set; } = string.Empty; + + /// + /// 角色名称 + /// 必填：否 + /// + [JsonPropertyName("name")] + public SecurityGroupName? Name { get; set; } + + /// + /// 角色名称 + /// + public record SecurityGroupName + { + /// + /// 中文 + /// 必填：否 + /// 示例值：cn + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 英文 + /// 必填：否 + /// 示例值：en + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 角色描述 + /// 必填：否 + /// + [JsonPropertyName("description")] + public NameSuffix? Description { get; set; } + + /// + /// 角色描述 + /// + public record NameSuffix + { + /// + /// 中文 + /// 必填：否 + /// 示例值：cn + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 英文 + /// 必填：否 + /// 示例值：en + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 组织管理维度 + /// 必填：否 + /// + [JsonPropertyName("org_truncation")] + public OrgTruncation[]? OrgTruncations { get; set; } + + /// + /// 组织管理维度 + /// + public record OrgTruncation + { + /// + /// 组织名称 + /// 必填：否 + /// 示例值：department + /// + [JsonPropertyName("org_key")] + public string? OrgKey { get; set; } + + /// + /// 下钻类型 + /// 必填：否 + /// 示例值：0 + /// 最大值：100 + /// 最小值：0 + /// + [JsonPropertyName("type")] + public int? Type { get; set; } + + /// + /// 下钻深度 + /// 必填：否 + /// 示例值：0 + /// 最大值：100 + /// 最小值：0 + /// + [JsonPropertyName("depth")] + public int? Depth { get; set; } + } + } + + /// + /// 「按组织架构管理」角色的数据范围。 + /// 「不按组织架构管理」的角色返回 null + /// 必填：否 + /// + [JsonPropertyName("assigned_organization_list")] + public AssignedOrganization[][]? AssignedOrganizationLists { get; set; } + + /// + /// 「按组织架构管理」角色的数据范围。 + /// 「不按组织架构管理」的角色返回 null + /// + public record AssignedOrganization + { + /// + /// 管理对象key，例如：department（部门）、work_location（工作城市） + /// 必填：是 + /// 示例值：department + /// + [JsonPropertyName("org_key")] + public string OrgKey { get; set; } = string.Empty; + + /// + /// 管理对象名称 + /// 必填：否 + /// + [JsonPropertyName("org_name")] + public Name? OrgName { get; set; } + + /// + /// 管理对象名称 + /// + public record Name + { + /// + /// 中文 + /// 必填：否 + /// 示例值：cn + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 英文 + /// 必填：否 + /// 示例值：en + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 管理对象id列表，例如：["6966974245293393415","6967286219029874189"] + /// 必填：是 + /// + [JsonPropertyName("org_id_list")] + public string[] OrgIdList { get; set; } = Array.Empty(); + } + + /// + /// 「不按组织架构管理」角色的数据范围。 + /// 「按组织架构管理」的角色返回 null + /// 必填：否 + /// + [JsonPropertyName("grantor_rule_list")] + public PermissionSecurityGroup[]? GrantorRuleLists { get; set; } + + /// + /// 「不按组织架构管理」角色的数据范围。 + /// 「按组织架构管理」的角色返回 null + /// + public record PermissionSecurityGroup + { + /// + /// 权限实体 + /// 必填：否 + /// + [JsonPropertyName("rule_dimension")] + public PermissionSecurityGroupRuleDimension? RuleDimension { get; set; } + + /// + /// 权限实体 + /// + public record PermissionSecurityGroupRuleDimension + { + /// + /// 权限实体的 key，例如：user（员工）、department（部门） + /// 必填：否 + /// 示例值：员工 + /// + [JsonPropertyName("entity_key")] + public string? EntityKey { get; set; } + + /// + /// 维度名称，例如：员工、部门 + /// 必填：否 + /// + [JsonPropertyName("entity_name")] + public Name? EntityName { get; set; } + + /// + /// 维度名称，例如：员工、部门 + /// + public record Name + { + /// + /// 中文 + /// 必填：否 + /// 示例值：cn + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 英文 + /// 必填：否 + /// 示例值：en + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + } + + /// + /// 数据范围 + /// - 0：无数据权限 + /// - 1：全部数据权限 + /// - 2：被授权的用户自己 + /// - 3：按规则指定范围 + /// 必填：否 + /// 示例值：1 + /// + [JsonPropertyName("rule_type")] + public int? RuleType { get; set; } + + /// + /// 数据范围表达式 + /// 必填：否 + /// + [JsonPropertyName("expression")] + public FilterExpression? Expression { get; set; } + + /// + /// 数据范围表达式 + /// + public record FilterExpression + { + /// + /// 筛选条件 + /// 必填：否 + /// 最大长度：100 + /// 最小长度：0 + /// + [JsonPropertyName("conditions")] + public FilterCondition[]? Conditions { get; set; } + + /// + /// 筛选条件 + /// + public record FilterCondition + { + /// + /// 左值 + /// 必填：否 + /// + [JsonPropertyName("left")] + public FilterRuleValue? Left { get; set; } + + /// + /// 左值 + /// + public record FilterRuleValue + { + /// + /// 左值数据类型 + /// 必填：否 + /// 示例值：1 + /// + [JsonPropertyName("type")] + public int? Type { get; set; } + + /// + /// 规则值 + /// 必填：否 + /// 示例值：a + /// + [JsonPropertyName("value")] + public string? Value { get; set; } + + /// + /// 下钻值 + /// 必填：否 + /// 示例值：1 + /// + [JsonPropertyName("lookup_value")] + public string? LookupValue { get; set; } + + /// + /// 下钻类型 + /// 必填：否 + /// 示例值：user + /// + [JsonPropertyName("lookup_type")] + public string? LookupType { get; set; } + } + + /// + /// 右值 + /// 必填：否 + /// + [JsonPropertyName("right")] + public FilterRuleValue? Right { get; set; } + + /// + /// 操作符 + /// 必填：否 + /// 示例值：1 + /// 最大值：100 + /// 最小值：0 + /// + [JsonPropertyName("operator")] + public int? Operator { get; set; } + + /// + /// 右值类型 + /// 必填：否 + /// 示例值：1 + /// 最大值：100 + /// 最小值：0 + /// + [JsonPropertyName("right_value_type")] + public int? RightValueType { get; set; } + } + + /// + /// 筛选条件间的逻辑关系 + /// 必填：否 + /// 示例值：1 and 2 + /// + [JsonPropertyName("expression")] + public string? Expression { get; set; } + } + } + + /// + /// 更新时间 + /// 必填：否 + /// 示例值：1641883226867361 + /// + [JsonPropertyName("update_time")] + public string? UpdateTime { get; set; } + } + } +} diff --git a/src/FeishuPeople/GetCorehrV1AuthorizationsQueryResponseDto.cs b/src/FeishuPeople/GetCorehrV1AuthorizationsQueryResponseDto.cs new file mode 100644 index 00000000..605ae083 --- /dev/null +++ b/src/FeishuPeople/GetCorehrV1AuthorizationsQueryResponseDto.cs @@ -0,0 +1,432 @@ +namespace FeishuNetSdk.FeishuPeople; +/// +/// 批量查询用户授权 响应体 +/// 批量查询「飞书人事」-「权限设置」中的用户授权信息。 +/// 接口ID：7372022997609906178 +/// 文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/authorization/query +/// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fcorehr-v1%2fauthorization%2fquery +/// +public record GetCorehrV1AuthorizationsQueryResponseDto +{ + /// + /// 查询的用户授权信息 + /// 必填：否 + /// + [JsonPropertyName("items")] + public RoleAuthorization[]? Items { get; set; } + + /// + /// 查询的用户授权信息 + /// + public record RoleAuthorization + { + /// + /// 雇员 ID + /// 必填：是 + /// 示例值：6967639606963471902 + /// + [JsonPropertyName("employment_id")] + public string EmploymentId { get; set; } = string.Empty; + + /// + /// 授权列表 + /// 必填：是 + /// + [JsonPropertyName("permission_detail_list")] + public PermissionDetail[] PermissionDetailLists { get; set; } = Array.Empty(); + + /// + /// 授权列表 + /// + public record PermissionDetail + { + /// + /// 角色 + /// 必填：否 + /// + [JsonPropertyName("role")] + public SecurityGroup? Role { get; set; } + + /// + /// 角色 + /// + public record SecurityGroup + { + /// + /// 角色ID + /// 必填：是 + /// 示例值：7034393015968122400 + /// + [JsonPropertyName("id")] + public string Id { get; set; } = string.Empty; + + /// + /// 角色code + /// 必填：是 + /// 示例值：department_manager + /// + [JsonPropertyName("code")] + public string Code { get; set; } = string.Empty; + + /// + /// 角色名称 + /// 必填：否 + /// + [JsonPropertyName("name")] + public SecurityGroupName? Name { get; set; } + + /// + /// 角色名称 + /// + public record SecurityGroupName + { + /// + /// 中文 + /// 必填：否 + /// 示例值：cn + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 英文 + /// 必填：否 + /// 示例值：en + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 角色描述 + /// 必填：否 + /// + [JsonPropertyName("description")] + public NameSuffix? Description { get; set; } + + /// + /// 角色描述 + /// + public record NameSuffix + { + /// + /// 中文 + /// 必填：否 + /// 示例值：cn + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 英文 + /// 必填：否 + /// 示例值：en + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 组织管理维度 + /// 必填：否 + /// + [JsonPropertyName("org_truncation")] + public OrgTruncation[]? OrgTruncations { get; set; } + + /// + /// 组织管理维度 + /// + public record OrgTruncation + { + /// + /// 组织名称 + /// 必填：否 + /// 示例值：department + /// + [JsonPropertyName("org_key")] + public string? OrgKey { get; set; } + + /// + /// 下钻类型 + /// 必填：否 + /// 示例值：0 + /// 最大值：100 + /// 最小值：0 + /// + [JsonPropertyName("type")] + public int? Type { get; set; } + + /// + /// 下钻深度 + /// 必填：否 + /// 示例值：0 + /// 最大值：100 + /// 最小值：0 + /// + [JsonPropertyName("depth")] + public int? Depth { get; set; } + } + } + + /// + /// 指定管理对象列表，如果该值为null，则使用设置数据权限 + /// 必填：否 + /// + [JsonPropertyName("assigned_organization_list")] + public AssignedOrganization[][]? AssignedOrganizationLists { get; set; } + + /// + /// 指定管理对象列表，如果该值为null，则使用设置数据权限 + /// + public record AssignedOrganization + { + /// + /// 管理对象key + /// 必填：是 + /// 示例值：department + /// + [JsonPropertyName("org_key")] + public string OrgKey { get; set; } = string.Empty; + + /// + /// 管理对象名称 + /// 必填：否 + /// + [JsonPropertyName("org_name")] + public Name? OrgName { get; set; } + + /// + /// 管理对象名称 + /// + public record Name + { + /// + /// 中文 + /// 必填：否 + /// 示例值：cn + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 英文 + /// 必填：否 + /// 示例值：en + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 管理对象id列表 + /// 必填：是 + /// + [JsonPropertyName("org_id_list")] + public string[] OrgIdList { get; set; } = Array.Empty(); + } + + /// + /// 设置数据权限，如果该值为null，则使用指定管理对象列表 + /// 必填：否 + /// + [JsonPropertyName("grantor_rule_list")] + public PermissionSecurityGroup[]? GrantorRuleLists { get; set; } + + /// + /// 设置数据权限，如果该值为null，则使用指定管理对象列表 + /// + public record PermissionSecurityGroup + { + /// + /// 管理维度 + /// 必填：否 + /// + [JsonPropertyName("rule_dimension")] + public PermissionSecurityGroupRuleDimension? RuleDimension { get; set; } + + /// + /// 管理维度 + /// + public record PermissionSecurityGroupRuleDimension + { + /// + /// 维度的key + /// 必填：否 + /// 示例值：员工 + /// + [JsonPropertyName("entity_key")] + public string? EntityKey { get; set; } + + /// + /// 维度名称 + /// 必填：否 + /// + [JsonPropertyName("entity_name")] + public Name? EntityName { get; set; } + + /// + /// 维度名称 + /// + public record Name + { + /// + /// 中文 + /// 必填：否 + /// 示例值：cn + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 英文 + /// 必填：否 + /// 示例值：en + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + } + + /// + /// 管理类型 + /// 必填：否 + /// 示例值：1 + /// + [JsonPropertyName("rule_type")] + public int? RuleType { get; set; } + + /// + /// 规则 + /// 必填：否 + /// + [JsonPropertyName("expression")] + public FilterExpression? Expression { get; set; } + + /// + /// 规则 + /// + public record FilterExpression + { + /// + /// 规则 + /// 必填：否 + /// 最大长度：100 + /// 最小长度：0 + /// + [JsonPropertyName("conditions")] + public FilterCondition[]? Conditions { get; set; } + + /// + /// 规则 + /// + public record FilterCondition + { + /// + /// 左值 + /// 必填：否 + /// + [JsonPropertyName("left")] + public FilterRuleValue? Left { get; set; } + + /// + /// 左值 + /// + public record FilterRuleValue + { + /// + /// 规则值类型 + /// 必填：否 + /// 示例值：1 + /// + [JsonPropertyName("type")] + public int? Type { get; set; } + + /// + /// 规则值 + /// 必填：否 + /// 示例值：a + /// + [JsonPropertyName("value")] + public string? Value { get; set; } + + /// + /// 下钻值 + /// 必填：否 + /// 示例值：1 + /// + [JsonPropertyName("lookup_value")] + public string? LookupValue { get; set; } + + /// + /// 下钻类型 + /// 必填：否 + /// 示例值：user + /// + [JsonPropertyName("lookup_type")] + public string? LookupType { get; set; } + } + + /// + /// 右值 + /// 必填：否 + /// + [JsonPropertyName("right")] + public FilterRuleValue? Right { get; set; } + + /// + /// 操作符 + /// 必填：否 + /// 示例值：1 + /// 最大值：100 + /// 最小值：0 + /// + [JsonPropertyName("operator")] + public int? Operator { get; set; } + + /// + /// 右值类型 + /// 必填：否 + /// 示例值：1 + /// 最大值：100 + /// 最小值：0 + /// + [JsonPropertyName("right_value_type")] + public int? RightValueType { get; set; } + } + + /// + /// 表达式 + /// 必填：否 + /// 示例值：1 and 2 + /// + [JsonPropertyName("expression")] + public string? Expression { get; set; } + } + } + + /// + /// 更新时间 + /// 必填：否 + /// 示例值：1641883226867361 + /// + [JsonPropertyName("update_time")] + public string? UpdateTime { get; set; } + } + } + + /// + /// 是否还有更多项 + /// 必填：否 + /// 示例值：true + /// + [JsonPropertyName("has_more")] + public bool? HasMore { get; set; } + + /// + /// 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token + /// 必填：否 + /// 示例值：1234452132 + /// + [JsonPropertyName("page_token")] + public string? PageToken { get; set; } +} diff --git a/src/FeishuPeople/PatchCorehrV1CompaniesByCompanyIdBodyDto.cs b/src/FeishuPeople/PatchCorehrV1CompaniesByCompanyIdBodyDto.cs index 38a71a85..16f8d8a7 100644 --- a/src/FeishuPeople/PatchCorehrV1CompaniesByCompanyIdBodyDto.cs +++ b/src/FeishuPeople/PatchCorehrV1CompaniesByCompanyIdBodyDto.cs @@ -10,10 +10,10 @@ public record PatchCorehrV1CompaniesByCompanyIdBodyDto { /// /// 层级关系，内层字段见实体 - /// 必填：是 + /// 必填：否 /// [JsonPropertyName("hiberarchy_common")] - public PatchCorehrV1CompaniesByCompanyIdBodyDtoHiberarchyCommon HiberarchyCommon { get; set; } = new(); + public PatchCorehrV1CompaniesByCompanyIdBodyDtoHiberarchyCommon? HiberarchyCommon { get; set; } /// /// 层级关系，内层字段见实体 @@ -30,10 +30,10 @@ public record PatchCorehrV1CompaniesByCompanyIdBodyDtoHiberarchyCommon /// /// 名称 - /// 必填：是 + /// 必填：否 /// [JsonPropertyName("name")] - public I18n[] Names { get; set; } = Array.Empty(); + public I18n[]? Names { get; set; } /// /// 名称 @@ -57,50 +57,21 @@ public record I18n public string Value { get; set; } = string.Empty; } - /// - /// 组织类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)组织类型（organization_type）枚举定义部分获得 - /// 必填：否 - /// - [JsonPropertyName("type")] - public Enum? Type { get; set; } - - /// - /// 组织类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)组织类型（organization_type）枚举定义部分获得 - /// - public record Enum - { - /// - /// 枚举值 - /// 必填：是 - /// 示例值：phone_type - /// - [JsonPropertyName("enum_name")] - public string EnumName { get; set; } = string.Empty; - } - /// /// 是否启用该公司 - /// 必填：是 + /// 必填：否 /// 示例值：true /// [JsonPropertyName("active")] - public bool Active { get; set; } + public bool? Active { get; set; } /// /// 生效时间 - /// 必填：否 + /// 必填：是 /// 示例值：2020-05-01 00:00:00 /// [JsonPropertyName("effective_time")] - public string? EffectiveTime { get; set; } - - /// - /// 失效时间 - /// 必填：否 - /// 示例值：2020-05-02 00:00:00 - /// - [JsonPropertyName("expiration_time")] - public string? ExpirationTime { get; set; } + public string EffectiveTime { get; set; } = string.Empty; /// /// 编码 @@ -116,35 +87,6 @@ public record Enum /// [JsonPropertyName("description")] public I18n[]? Descriptions { get; set; } - - /// - /// 自定义字段 - /// 必填：否 - /// - [JsonPropertyName("custom_fields")] - public ObjectFieldData[]? CustomFields { get; set; } - - /// - /// 自定义字段 - /// - public record ObjectFieldData - { - /// - /// 字段名 - /// 必填：是 - /// 示例值：name - /// - [JsonPropertyName("field_name")] - 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; - } } /// @@ -252,35 +194,6 @@ public record I18n [JsonPropertyName("primary_manager")] public I18n[]? PrimaryManagers { get; set; } - /// - /// 自定义字段 - /// 必填：否 - /// - [JsonPropertyName("custom_fields")] - public ObjectFieldData[]? CustomFields { get; set; } - - /// - /// 自定义字段 - /// - public record ObjectFieldData - { - /// - /// 字段名 - /// 必填：是 - /// 示例值：name - /// - [JsonPropertyName("field_name")] - 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/PatchCorehrV1JobDatasByJobDataIdBodyDto.cs b/src/FeishuPeople/PatchCorehrV1JobDatasByJobDataIdBodyDto.cs index 163a968b..8dc512ac 100644 --- a/src/FeishuPeople/PatchCorehrV1JobDatasByJobDataIdBodyDto.cs +++ b/src/FeishuPeople/PatchCorehrV1JobDatasByJobDataIdBodyDto.cs @@ -9,7 +9,17 @@ namespace FeishuNetSdk.FeishuPeople; public record PatchCorehrV1JobDatasByJobDataIdBodyDto { /// - /// 职务级别 ID，枚举值及详细信息可通过【查询单个职务级别】接口查询获得 + /// 任职记录版本 ID + /// - ID 不为空时，将更新指定版本的任职记录内容 + /// - ID 为空时，将新增一个版本 + /// 必填：否 + /// 示例值：6890452208593372697 + /// + [JsonPropertyName("version_id")] + public string? VersionId { get; set; } + + /// + /// 职务级别 ID，枚举值及详细信息可通过[【查询单个职级】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/get)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -17,7 +27,15 @@ public record PatchCorehrV1JobDatasByJobDataIdBodyDto public string? JobLevelId { get; set; } /// - /// 人员类型 ID，枚举值及详细信息可通过【查询单个人员类型】接口查询获得 + /// 职等 ID，枚举值及详细信息可通过[【查询职等】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_grade/query)接口查询获得 + /// 必填：否 + /// 示例值：6890452208593372679 + /// + [JsonPropertyName("job_grade_id")] + public string? JobGradeId { get; set; } + + /// + /// 人员类型 ID，枚举值及详细信息可通过[【查询单个人员类型】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/employee_type/get)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -25,7 +43,7 @@ public record PatchCorehrV1JobDatasByJobDataIdBodyDto public string? EmployeeTypeId { get; set; } /// - /// 工时制度 ID，枚举值及详细信息可通过【查询单个工时制度】接口查询获得 + /// 工时制度 ID，枚举值及详细信息可通过[【查询单个工时制度】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/get)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -33,7 +51,7 @@ public record PatchCorehrV1JobDatasByJobDataIdBodyDto public string? WorkingHoursTypeId { get; set; } /// - /// 工作地点 ID，枚举值及详细信息可通过【查询单个地点】接口查询获得 + /// 工作地点 ID，枚举值及详细信息可通过[【查询单个地点】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/get)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -41,7 +59,7 @@ public record PatchCorehrV1JobDatasByJobDataIdBodyDto public string? WorkLocationId { get; set; } /// - /// 部门 ID，枚举值及详细信息可通过【查询单个部门】接口查询获得 + /// 部门 ID，枚举值及详细信息可通过[【查询单个部门】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/department/get)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -49,7 +67,7 @@ public record PatchCorehrV1JobDatasByJobDataIdBodyDto public string? DepartmentId { get; set; } /// - /// 职务 ID，枚举值及详细信息可通过【查询单个职务】接口查询获得 + /// 职务 ID，枚举值及详细信息可通过[【查询单个职务】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job/get)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -81,7 +99,7 @@ public record PatchCorehrV1JobDatasByJobDataIdBodyDto public bool? PrimaryJobData { get; set; } /// - /// 雇佣 ID + /// 雇佣 ID，详细信息可以通过[【搜索员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search)接口查询获得 /// 必填：否 /// 示例值：6893014062142064135 /// @@ -91,7 +109,7 @@ public record PatchCorehrV1JobDatasByJobDataIdBodyDto /// /// 生效时间 /// 必填：否 - /// 示例值：2020-05-0100:00:00 + /// 示例值：2020-05-01 00:00:00 /// [JsonPropertyName("effective_time")] public string? EffectiveTime { get; set; } @@ -99,13 +117,14 @@ public record PatchCorehrV1JobDatasByJobDataIdBodyDto /// /// 失效时间 /// 必填：否 - /// 示例值：2020-05-0200:00:00 + /// 示例值：2020-05-02 00:00:00 /// [JsonPropertyName("expiration_time")] public string? ExpirationTime { get; set; } /// - /// 职务序列 ID，枚举值及详细信息可通过【查询单个职务序列】接口查询获得 + /// 职务序列 ID，枚举值及详细信息可通过[【查询单个序列】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/get) + /// 接口查询获得 /// 必填：否 /// 示例值：1245678 /// @@ -115,6 +134,7 @@ public record PatchCorehrV1JobDatasByJobDataIdBodyDto /// /// 任职原因，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant) 任职原因（assignment_start_reason）枚举定义部分获得。请注意，「任职原因」不允许填写为「onboarding」，当上一个任职版本的「任职原因」为「onboarding」时，「任职原因」必填。 /// 必填：否 + /// 示例值：onboarding /// [JsonPropertyName("assignment_start_reason")] public Enum? AssignmentStartReason { get; set; } @@ -142,7 +162,7 @@ public record Enum public string? ProbationExpectedEndDate { get; set; } /// - /// 实线主管的任职记录ID + /// 直属上级的任职记录 ID，详细信息可通过[【批量查询员工任职信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employees-job_data/batch_get)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -150,7 +170,7 @@ public record Enum public string? DirectManagerId { get; set; } /// - /// 虚线主管的任职记录ID + /// 虚线上级的任职记录 ID，详细信息可通过[【批量查询员工任职信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employees-job_data/batch_get)接口查询获得 /// 必填：否 /// 示例值：["6971723901730686501"] /// @@ -158,7 +178,7 @@ public record Enum public string[]? DottedLineManagerIdList { get; set; } /// - /// 第二实线主管的任职记录ID + /// 第二直属上级的任职记录 ID，详细信息可通过[【批量查询员工任职信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employees-job_data/batch_get)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -178,7 +198,7 @@ public record Enum public record SupportCostCenterItem { /// - /// 支持的成本中心id + /// 支持的成本中心 ID，详细信息可通过[【搜索成本中心信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search)接口查询获得 /// 必填：否 /// 示例值：6950635856373745165 /// @@ -195,31 +215,24 @@ public record SupportCostCenterItem } /// - /// 自定义字段 + /// 排班类型 /// 必填：否 /// - [JsonPropertyName("custom_fields")] - public ObjectFieldData[]? CustomFields { get; set; } + [JsonPropertyName("work_shift")] + public Enum? WorkShift { get; set; } /// - /// 自定义字段 + /// 薪资类型 + /// 必填：否 /// - public record ObjectFieldData - { - /// - /// 字段名 - /// 必填：是 - /// 示例值：name - /// - [JsonPropertyName("field_name")] - public string FieldName { get; set; } = string.Empty; + [JsonPropertyName("compensation_type")] + public Enum? CompensationType { get; set; } - /// - /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", [\"id1\",\"id2\"], "2006-01-02 15:04:05") - /// 必填：是 - /// 示例值：\"Sandy\" - /// - [JsonPropertyName("value")] - public string Value { get; set; } = string.Empty; - } + /// + /// 任职公司 ID，详细信息可通过[【查询单个公司】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/get)接口查询获得 + /// 必填：否 + /// 示例值：6890452208593372680 + /// + [JsonPropertyName("service_company")] + public string? ServiceCompany { get; set; } } diff --git a/src/FeishuPeople/PatchCorehrV1JobDatasByJobDataIdResponseDto.cs b/src/FeishuPeople/PatchCorehrV1JobDatasByJobDataIdResponseDto.cs index 07986f97..43c86b7a 100644 --- a/src/FeishuPeople/PatchCorehrV1JobDatasByJobDataIdResponseDto.cs +++ b/src/FeishuPeople/PatchCorehrV1JobDatasByJobDataIdResponseDto.cs @@ -29,7 +29,15 @@ public record PatchCorehrV1JobDatasByJobDataIdResponseDtoJobData public string? Id { get; set; } /// - /// 职务级别 ID，枚举值及详细信息可通过【查询单个职务级别】接口查询获得 + /// 任职记录版本 ID + /// 必填：否 + /// 示例值：6890452208593372697 + /// + [JsonPropertyName("version_id")] + public string? VersionId { get; set; } + + /// + /// 职务级别 ID，枚举值及详细信息可通过[【查询单个职级】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/get)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -37,7 +45,15 @@ public record PatchCorehrV1JobDatasByJobDataIdResponseDtoJobData public string? JobLevelId { get; set; } /// - /// 人员类型 ID，枚举值及详细信息可通过【查询单个人员类型】接口查询获得 + /// 职等 ID，枚举值及详细信息可通过[【查询职等】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_grade/query)接口查询获得 + /// 必填：否 + /// 示例值：6890452208593372679 + /// + [JsonPropertyName("job_grade_id")] + public string? JobGradeId { get; set; } + + /// + /// 人员类型 ID，枚举值及详细信息可通过[【查询单个人员类型】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/employee_type/get)接口查询获得 /// 必填：是 /// 示例值：6890452208593372679 /// @@ -45,7 +61,7 @@ public record PatchCorehrV1JobDatasByJobDataIdResponseDtoJobData public string EmployeeTypeId { get; set; } = string.Empty; /// - /// 工时制度 ID，枚举值及详细信息可通过【查询单个工时制度】接口查询获得 + /// 工时制度 ID，枚举值及详细信息可通过[【查询单个工时制度】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/get)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -53,7 +69,7 @@ public record PatchCorehrV1JobDatasByJobDataIdResponseDtoJobData public string? WorkingHoursTypeId { get; set; } /// - /// 工作地点 ID，枚举值及详细信息可通过【查询单个地点】接口查询获得 + /// 工作地点 ID，枚举值及详细信息可通过[【查询单个地点】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/get)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -61,7 +77,7 @@ public record PatchCorehrV1JobDatasByJobDataIdResponseDtoJobData public string? WorkLocationId { get; set; } /// - /// 部门 ID，枚举值及详细信息可通过【查询单个部门】接口查询获得 + /// 部门 ID，枚举值及详细信息可通过[【查询单个部门】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/department/get)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -69,7 +85,7 @@ public record PatchCorehrV1JobDatasByJobDataIdResponseDtoJobData public string? DepartmentId { get; set; } /// - /// 职务 ID，枚举值及详细信息可通过【查询单个职务】接口查询获得 + /// 职务 ID，枚举值及详细信息可通过[【查询单个职务】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job/get)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -101,7 +117,7 @@ public record PatchCorehrV1JobDatasByJobDataIdResponseDtoJobData public bool PrimaryJobData { get; set; } /// - /// 雇佣 ID + /// 雇佣 ID，详细信息可以通过[【搜索员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search)接口查询获得 /// 必填：是 /// 示例值：6893014062142064135 /// @@ -111,7 +127,7 @@ public record PatchCorehrV1JobDatasByJobDataIdResponseDtoJobData /// /// 生效时间 /// 必填：是 - /// 示例值：2020-05-0100:00:00 + /// 示例值：2020-05-01 00:00:00 /// [JsonPropertyName("effective_time")] public string EffectiveTime { get; set; } = string.Empty; @@ -119,13 +135,13 @@ public record PatchCorehrV1JobDatasByJobDataIdResponseDtoJobData /// /// 失效时间 /// 必填：否 - /// 示例值：2020-05-0200:00:00 + /// 示例值：2020-05-02 00:00:00 /// [JsonPropertyName("expiration_time")] public string? ExpirationTime { get; set; } /// - /// 职务序列 ID，枚举值及详细信息可通过【查询单个职务序列】接口查询获得 + /// 职务序列 ID，枚举值及详细信息可通过[【查询单个序列】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/get)接口查询获得 /// 必填：否 /// 示例值：1245678 /// @@ -135,6 +151,7 @@ public record PatchCorehrV1JobDatasByJobDataIdResponseDtoJobData /// /// 任职原因，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)任职原因（assignment_start_reason）枚举定义部分获得 /// 必填：否 + /// 示例值：onboarding /// [JsonPropertyName("assignment_start_reason")] public Enum? AssignmentStartReason { get; set; } @@ -199,7 +216,7 @@ public record I18n public int? WeeklyWorkingHours { get; set; } /// - /// 实线主管的任职记录ID + /// 直属上级的任职记录 ID，详细信息可通过[【批量查询员工任职信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employees-job_data/batch_get)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -207,7 +224,7 @@ public record I18n public string? DirectManagerId { get; set; } /// - /// 虚线主管的任职记录ID + /// 虚线上级的任职记录 ID，详细信息可通过[【批量查询员工任职信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employees-job_data/batch_get)接口查询获得 /// 必填：否 /// 示例值：["6971723901730686501"] /// @@ -215,7 +232,7 @@ public record I18n public string[]? DottedLineManagerIdList { get; set; } /// - /// 第二实线主管的任职记录ID + /// 第二直属上级的任职记录 ID，详细信息可通过[【批量查询员工任职信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employees-job_data/batch_get)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -235,7 +252,7 @@ public record I18n public record SupportCostCenterItem { /// - /// 支持的成本中心id + /// 支持的成本中心 ID，详细信息可通过[【搜索成本中心信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search)接口查询获得 /// 必填：否 /// 示例值：6950635856373745165 /// @@ -252,32 +269,33 @@ public record SupportCostCenterItem } /// - /// 自定义字段 + /// 周工作时长 /// 必填：否 + /// 示例值：37.5 /// - [JsonPropertyName("custom_fields")] - public ObjectFieldData[]? CustomFields { get; set; } + [JsonPropertyName("weekly_working_hours_v2")] + public float? WeeklyWorkingHoursV2 { get; set; } /// - /// 自定义字段 + /// 排班类型 + /// 必填：否 /// - public record ObjectFieldData - { - /// - /// 字段名 - /// 必填：是 - /// 示例值：name - /// - [JsonPropertyName("field_name")] - public string FieldName { get; set; } = string.Empty; + [JsonPropertyName("work_shift")] + public Enum? WorkShift { get; set; } - /// - /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", [\"id1\",\"id2\"], "2006-01-02 15:04:05") - /// 必填：是 - /// 示例值：\"Sandy\" - /// - [JsonPropertyName("value")] - public string Value { get; set; } = string.Empty; - } + /// + /// 薪资类型 + /// 必填：否 + /// + [JsonPropertyName("compensation_type")] + public Enum? CompensationType { get; set; } + + /// + /// 任职公司 + /// 必填：否 + /// 示例值：6890452208593372680 + /// + [JsonPropertyName("service_company")] + public string? ServiceCompany { get; set; } } } diff --git a/src/FeishuPeople/PostCorehrV1JobDatasBodyDto.cs b/src/FeishuPeople/PostCorehrV1JobDatasBodyDto.cs index 0f6f466e..233614e3 100644 --- a/src/FeishuPeople/PostCorehrV1JobDatasBodyDto.cs +++ b/src/FeishuPeople/PostCorehrV1JobDatasBodyDto.cs @@ -9,7 +9,7 @@ namespace FeishuNetSdk.FeishuPeople; public record PostCorehrV1JobDatasBodyDto { /// - /// 职务级别 ID，枚举值及详细信息可通过【查询单个职务级别】接口查询获得 + /// 职务级别 ID，枚举值及详细信息可通过[【查询单个职级】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/get)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -17,7 +17,15 @@ public record PostCorehrV1JobDatasBodyDto public string? JobLevelId { get; set; } /// - /// 人员类型 ID，枚举值及详细信息可通过【查询单个人员类型】接口查询获得 + /// 职等 ID，枚举值及详细信息可通过[【查询职等】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_grade/query)接口查询获得 + /// 必填：否 + /// 示例值：6890452208593372679 + /// + [JsonPropertyName("job_grade_id")] + public string? JobGradeId { get; set; } + + /// + /// 人员类型 ID，枚举值及详细信息可通过[【查询单个人员类型】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/employee_type/get)接口查询获得 /// 必填：是 /// 示例值：6890452208593372679 /// @@ -25,7 +33,7 @@ public record PostCorehrV1JobDatasBodyDto public string EmployeeTypeId { get; set; } = string.Empty; /// - /// 工时制度 ID，枚举值及详细信息可通过【查询单个工时制度】接口查询获得 + /// 工时制度 ID，枚举值及详细信息可通过[【查询单个工时制度】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/get)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -33,7 +41,7 @@ public record PostCorehrV1JobDatasBodyDto public string? WorkingHoursTypeId { get; set; } /// - /// 工作地点 ID，枚举值及详细信息可通过【查询单个地点】接口查询获得 + /// 工作地点 ID，枚举值及详细信息可通过[【查询单个地点】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/get)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -41,7 +49,7 @@ public record PostCorehrV1JobDatasBodyDto public string? WorkLocationId { get; set; } /// - /// 部门 ID，枚举值及详细信息可通过【查询单个部门】接口查询获得 + /// 部门 ID，枚举值及详细信息可通过[【查询单个部门】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/department/get)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -49,7 +57,7 @@ public record PostCorehrV1JobDatasBodyDto public string? DepartmentId { get; set; } /// - /// 职务 ID，枚举值及详细信息可通过【查询单个职务】接口查询获得 + /// 职务 ID，枚举值及详细信息可通过[【查询单个职务】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job/get)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -81,7 +89,7 @@ public record PostCorehrV1JobDatasBodyDto public bool PrimaryJobData { get; set; } /// - /// 雇佣 ID + /// 雇佣 ID，详细信息可以通过[【搜索员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search)接口查询获得 /// 必填：是 /// 示例值：6893014062142064135 /// @@ -91,7 +99,7 @@ public record PostCorehrV1JobDatasBodyDto /// /// 生效时间 /// 必填：是 - /// 示例值：2020-05-0100:00:00 + /// 示例值：2020-05-01 00:00:00 /// [JsonPropertyName("effective_time")] public string EffectiveTime { get; set; } = string.Empty; @@ -99,13 +107,13 @@ public record PostCorehrV1JobDatasBodyDto /// /// 失效时间 /// 必填：否 - /// 示例值：2020-05-0200:00:00 + /// 示例值：2020-05-02 00:00:00 /// [JsonPropertyName("expiration_time")] public string? ExpirationTime { get; set; } /// - /// 职务序列 ID，枚举值及详细信息可通过【查询单个职务序列】接口查询获得 + /// 职务序列 ID，枚举值及详细信息可通过[【查询单个序列】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/get)接口查询获得 /// 必填：否 /// 示例值：1245678 /// @@ -115,6 +123,7 @@ public record PostCorehrV1JobDatasBodyDto /// /// 任职原因，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)任职原因（assignment_start_reason）枚举定义部分获得，这里只支持填写"onboarding" /// 必填：是 + /// 示例值：onboarding /// [JsonPropertyName("assignment_start_reason")] public Enum AssignmentStartReason { get; set; } = new(); @@ -142,7 +151,7 @@ public record Enum public string? ProbationExpectedEndDate { get; set; } /// - /// 实线主管的任职记录ID + /// 直属上级的任职记录 ID，详细信息可通过[【批量查询员工任职信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employees-job_data/batch_get)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -150,7 +159,7 @@ public record Enum public string? DirectManagerId { get; set; } /// - /// 虚线主管的任职记录ID + /// 虚线上级的任职记录 ID，详细信息可通过[【批量查询员工任职信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employees-job_data/batch_get)接口查询获得 /// 必填：否 /// 示例值：["6971723901730686501"] /// @@ -158,7 +167,7 @@ public record Enum public string[]? DottedLineManagerIdList { get; set; } /// - /// 第二实线主管的任职记录ID + /// 第二直属上级的任职记录 ID，详细信息可通过[【批量查询员工任职信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employees-job_data/batch_get)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -178,7 +187,7 @@ public record Enum public record SupportCostCenterItem { /// - /// 支持的成本中心id + /// 支持的成本中心 ID，详细信息可通过[【搜索成本中心信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search)接口查询获得 /// 必填：否 /// 示例值：6950635856373745165 /// @@ -195,31 +204,24 @@ public record SupportCostCenterItem } /// - /// 自定义字段 + /// 排班类型 /// 必填：否 /// - [JsonPropertyName("custom_fields")] - public ObjectFieldData[]? CustomFields { get; set; } + [JsonPropertyName("work_shift")] + public Enum? WorkShift { get; set; } /// - /// 自定义字段 + /// 薪资类型 + /// 必填：否 /// - public record ObjectFieldData - { - /// - /// 字段名 - /// 必填：是 - /// 示例值：name - /// - [JsonPropertyName("field_name")] - public string FieldName { get; set; } = string.Empty; + [JsonPropertyName("compensation_type")] + public Enum? CompensationType { get; set; } - /// - /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", [\"id1\",\"id2\"], "2006-01-02 15:04:05") - /// 必填：是 - /// 示例值：\"Sandy\" - /// - [JsonPropertyName("value")] - public string Value { get; set; } = string.Empty; - } + /// + /// 任职公司 ID，详细信息可通过[【查询单个公司】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/get)接口查询获得 + /// 必填：否 + /// 示例值：6890452208593372680 + /// + [JsonPropertyName("service_company")] + public string? ServiceCompany { get; set; } } diff --git a/src/FeishuPeople/PostCorehrV1JobDatasResponseDto.cs b/src/FeishuPeople/PostCorehrV1JobDatasResponseDto.cs index fd53af31..8175cee9 100644 --- a/src/FeishuPeople/PostCorehrV1JobDatasResponseDto.cs +++ b/src/FeishuPeople/PostCorehrV1JobDatasResponseDto.cs @@ -29,7 +29,15 @@ public record PostCorehrV1JobDatasResponseDtoJobData public string? Id { get; set; } /// - /// 职务级别 ID，枚举值及详细信息可通过【查询单个职务级别】接口查询获得 + /// 任职记录版本 ID + /// 必填：否 + /// 示例值：6890452208593372697 + /// + [JsonPropertyName("version_id")] + public string? VersionId { get; set; } + + /// + /// 职务级别 ID，枚举值及详细信息可通过[【查询单个职级】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/get)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -37,7 +45,15 @@ public record PostCorehrV1JobDatasResponseDtoJobData public string? JobLevelId { get; set; } /// - /// 人员类型 ID，枚举值及详细信息可通过【查询单个人员类型】接口查询获得 + /// 职等 ID，枚举值及详细信息可通过[【查询职等】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_grade/query)接口查询获得 + /// 必填：否 + /// 示例值：6890452208593372679 + /// + [JsonPropertyName("job_grade_id")] + public string? JobGradeId { get; set; } + + /// + /// 人员类型 ID，枚举值及详细信息可通过[【查询单个人员类型】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/employee_type/get)接口查询获得 /// 必填：是 /// 示例值：6890452208593372679 /// @@ -45,7 +61,7 @@ public record PostCorehrV1JobDatasResponseDtoJobData public string EmployeeTypeId { get; set; } = string.Empty; /// - /// 工时制度 ID，枚举值及详细信息可通过【查询单个工时制度】接口查询获得 + /// 工时制度 ID，枚举值及详细信息可通过[【查询单个工时制度】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/get)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -53,7 +69,7 @@ public record PostCorehrV1JobDatasResponseDtoJobData public string? WorkingHoursTypeId { get; set; } /// - /// 工作地点 ID，枚举值及详细信息可通过【查询单个地点】接口查询获得 + /// 工作地点 ID，枚举值及详细信息可通过[【查询单个地点】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/get)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -61,7 +77,7 @@ public record PostCorehrV1JobDatasResponseDtoJobData public string? WorkLocationId { get; set; } /// - /// 部门 ID，枚举值及详细信息可通过【查询单个部门】接口查询获得 + /// 部门 ID，枚举值及详细信息可通过[【查询单个部门】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/department/get)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -69,7 +85,7 @@ public record PostCorehrV1JobDatasResponseDtoJobData public string? DepartmentId { get; set; } /// - /// 职务 ID，枚举值及详细信息可通过【查询单个职务】接口查询获得 + /// 职务 ID，枚举值及详细信息可通过[【查询单个职务】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job/get)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -101,7 +117,7 @@ public record PostCorehrV1JobDatasResponseDtoJobData public bool PrimaryJobData { get; set; } /// - /// 雇佣 ID + /// 雇佣 ID，详细信息可以通过[【搜索员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search)接口查询获得 /// 必填：是 /// 示例值：6893014062142064135 /// @@ -111,7 +127,7 @@ public record PostCorehrV1JobDatasResponseDtoJobData /// /// 生效时间 /// 必填：是 - /// 示例值：2020-05-0100:00:00 + /// 示例值：2020-05-01 00:00:00 /// [JsonPropertyName("effective_time")] public string EffectiveTime { get; set; } = string.Empty; @@ -119,13 +135,13 @@ public record PostCorehrV1JobDatasResponseDtoJobData /// /// 失效时间 /// 必填：否 - /// 示例值：2020-05-0200:00:00 + /// 示例值：2020-05-02 00:00:00 /// [JsonPropertyName("expiration_time")] public string? ExpirationTime { get; set; } /// - /// 职务序列 ID，枚举值及详细信息可通过【查询单个职务序列】接口查询获得 + /// 职务序列 ID，枚举值及详细信息可通过[【查询单个序列】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/get)接口查询获得 /// 必填：否 /// 示例值：1245678 /// @@ -135,6 +151,7 @@ public record PostCorehrV1JobDatasResponseDtoJobData /// /// 任职原因，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)任职原因（assignment_start_reason）枚举定义部分获得 /// 必填：否 + /// 示例值：onboarding /// [JsonPropertyName("assignment_start_reason")] public Enum? AssignmentStartReason { get; set; } @@ -199,7 +216,7 @@ public record I18n public int? WeeklyWorkingHours { get; set; } /// - /// 实线主管的任职记录ID + /// 直属上级的任职记录 ID，详细信息可通过[【批量查询员工任职信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employees-job_data/batch_get)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -207,7 +224,7 @@ public record I18n public string? DirectManagerId { get; set; } /// - /// 虚线主管的任职记录ID + /// 虚线上级的任职记录 ID，详细信息可通过[【批量查询员工任职信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employees-job_data/batch_get)接口查询获得 /// 必填：否 /// 示例值：["6971723901730686501"] /// @@ -215,7 +232,7 @@ public record I18n public string[]? DottedLineManagerIdList { get; set; } /// - /// 第二实线主管的任职记录ID + /// 第二直属上级的任职记录 ID，详细信息可通过[【批量查询员工任职信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employees-job_data/batch_get)接口查询获得 /// 必填：否 /// 示例值：6890452208593372679 /// @@ -235,7 +252,7 @@ public record I18n public record SupportCostCenterItem { /// - /// 支持的成本中心id + /// 支持的成本中心 ID，详细信息可通过[【搜索成本中心信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search)接口查询获得 /// 必填：否 /// 示例值：6950635856373745165 /// @@ -252,32 +269,33 @@ public record SupportCostCenterItem } /// - /// 自定义字段 + /// 周工作时长 /// 必填：否 + /// 示例值：37.5 /// - [JsonPropertyName("custom_fields")] - public ObjectFieldData[]? CustomFields { get; set; } + [JsonPropertyName("weekly_working_hours_v2")] + public float? WeeklyWorkingHoursV2 { get; set; } /// - /// 自定义字段 + /// 排班类型 + /// 必填：否 /// - public record ObjectFieldData - { - /// - /// 字段名 - /// 必填：是 - /// 示例值：name - /// - [JsonPropertyName("field_name")] - public string FieldName { get; set; } = string.Empty; + [JsonPropertyName("work_shift")] + public Enum? WorkShift { get; set; } - /// - /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", [\"id1\",\"id2\"], "2006-01-02 15:04:05") - /// 必填：是 - /// 示例值：\"Sandy\" - /// - [JsonPropertyName("value")] - public string Value { get; set; } = string.Empty; - } + /// + /// 薪资类型 + /// 必填：否 + /// + [JsonPropertyName("compensation_type")] + public Enum? CompensationType { get; set; } + + /// + /// 任职公司 + /// 必填：否 + /// 示例值：6890452208593372680 + /// + [JsonPropertyName("service_company")] + public string? ServiceCompany { get; set; } } } diff --git a/src/IFeishuTenantApi.cs b/src/IFeishuTenantApi.cs index 3d59d24a..b2e5128f 100644 --- a/src/IFeishuTenantApi.cs +++ b/src/IFeishuTenantApi.cs @@ -13310,8 +13310,8 @@ System.Threading.Tasks.Task DeleteCorehrV1JobDatasByJobDataIdAsy /// /// /// 必填：否 - /// 根据client_token是否一致来判断是否为同一请求 - /// 示例值：12454646 + /// 操作的唯一标识，用于幂等的进行更新操作，格式为标准的 UUIDV4。此值为空表示将发起一次新的请求，此值非空表示幂等的进行更新操作。 + /// 示例值："fe599b60-450f-46ff-b2ef-9f6675625b97" /// 默认值：null /// /// @@ -13331,9 +13331,9 @@ System.Threading.Tasks.Task DeleteCorehrV1JobDatasByJobDataIdAsy /// 此次调用中使用的部门 ID 类型 /// 示例值：open_department_id /// - /// open_department_id：以 open_department_id 来标识部门 - /// department_id：以 department_id 来标识部门 - /// people_corehr_department_id：以 people_corehr_department_id 来标识部门 + /// open_department_id：【飞书】用来在具体某个应用中标识一个部门，同一个 department_id 在不同应用中的 open_department_id 相同。 + /// department_id：【飞书】用来标识租户内一个唯一的部门。 + /// people_corehr_department_id：【飞书人事】用来标识「飞书人事」中的部门。 /// /// 默认值：people_corehr_department_id /// @@ -16704,8 +16704,8 @@ System.Threading.Tasks.Task DeleteCorehrV1EmploymentsByEmploymen /// /// /// 必填：否 - /// 根据client_token是否一致来判断是否为同一请求 - /// 示例值：12454646 + /// 操作的唯一标识，用于幂等的进行更新操作，格式为标准的 UUIDV4。此值为空表示将发起一次新的请求，此值非空表示幂等的进行更新操作。 + /// 示例值："fe599b60-450f-46ff-b2ef-9f6675625b97" /// 默认值：null /// /// @@ -16725,9 +16725,9 @@ System.Threading.Tasks.Task DeleteCorehrV1EmploymentsByEmploymen /// 此次调用中使用的部门 ID 类型 /// 示例值：open_department_id /// - /// open_department_id：以 open_department_id 来标识部门 - /// department_id：以 department_id 来标识部门 - /// people_corehr_department_id：以 people_corehr_department_id 来标识部门 + /// open_department_id：【飞书】用来在具体某个应用中标识一个部门，同一个 department_id 在不同应用中的 open_department_id 相同。 + /// department_id：【飞书】用来标识租户内一个唯一的部门。 + /// people_corehr_department_id：【飞书人事】用来标识「飞书人事」中的部门。 /// /// 默认值：people_corehr_department_id /// @@ -30659,9 +30659,9 @@ System.Threading.Tasks.Task PostApaasV1ApprovalTasksByApprovalTa /// 此次调用中使用的部门 ID 类型 /// 示例值：people_corehr_department_id /// - /// open_department_id：以 open_department_id 来标识部门 - /// department_id：以 department_id 来标识部门 - /// people_corehr_department_id：以 people_corehr_department_id 来标识部门 + /// open_department_id：【飞书】用来在具体某个应用中标识一个部门，同一个department_id 在不同应用中的 open_department_id 相同。 + /// department_id：【飞书】用来标识租户内一个唯一的部门。 + /// people_corehr_department_id：【飞书人事】用来标识「飞书人事」中的部门。 /// /// 默认值：people_corehr_department_id /// @@ -30788,5 +30788,136 @@ System.Threading.Tasks.Task DeleteCorehrV2PreHiresByPreHireIdAsy [JsonContent] Corehr.PostCorehrV2JobGradesQueryBodyDto dto, [PathQuery] int page_size = 10, [PathQuery] string? page_token = null); + + /// + /// 【飞书人事】批量查询用户授权 + /// 接口ID：7372022997609906178 + /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/authorization/query + /// Authorization：tenant_access_token + /// 批量查询「飞书人事」-「权限设置」中的用户授权信息。 + /// + /// + /// 必填：否 + /// 员工ID列表，最大100个（不传则默认查询全部员工） + /// 默认值：null + /// + /// + /// 必填：否 + /// 角色 ID 列表，最大 100 个 + /// 默认值：null + /// + /// + /// 必填：否 + /// 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果 + /// 示例值：6969864184272078374 + /// 默认值：null + /// + /// + /// 必填：否 + /// 每页获取记录数量，最大100 + /// 示例值：100 + /// 默认值：10 + /// + /// + /// 必填：否 + /// 用户 ID 类型 + /// 示例值：people_corehr_id + /// + /// open_id：标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。[了解更多：如何获取 Open ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid) + /// union_id：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。[了解更多：如何获取 Union ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-union-id) + /// user_id：标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。[了解更多：如何获取 User ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-user-id) + /// people_corehr_id：以飞书人事的 ID 来识别用户 + /// + /// 默认值：people_corehr_id + /// + [HttpGet("/open-apis/corehr/v1/authorizations/query")] + System.Threading.Tasks.Task> GetCorehrV1AuthorizationsQueryAsync( + [PathQuery] string[]? employment_id_list = null, + [PathQuery] string[]? role_id_list = null, + [PathQuery] string? page_token = null, + [PathQuery] int? page_size = 10, + [PathQuery] string? user_id_type = "people_corehr_id"); + + /// + /// 【飞书人事】查询单个用户授权 + /// 接口ID：7372022997609922562 + /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/authorization/get_by_param + /// Authorization：tenant_access_token + /// 查询「飞书人事」-「权限设置」中的单个用户授权信息。 + /// + /// + /// 必填：是 + /// 被授权用户的 ID，默认为飞书人事中的 ==employment_id==。你也可以使用 user_id_type 中声明的另外 3 种 ID。 + /// > + /// 如果你需要使用工号，可以使用 [ID转换服务](https://open.larkoffice.com/document/server-docs/corehr-v1/common_data-id/search?appId=cli_9c04f2177d799101) 换取 ==employment_id== + /// 示例值：67489937334909845 + /// + /// + /// 必填：否 + /// 用户 ID 类型 + /// 示例值：people_corehr_id + /// + /// open_id：标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。[了解更多：如何获取 Open ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid) + /// union_id：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。[了解更多：如何获取 Union ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-union-id) + /// user_id：标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。[了解更多：如何获取 User ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-user-id) + /// people_corehr_id：以飞书人事的 ID 来识别用户 + /// + /// 默认值：people_corehr_id + /// + [HttpGet("/open-apis/corehr/v1/authorizations/get_by_param")] + System.Threading.Tasks.Task> GetCorehrV1AuthorizationsGetByParamAsync( + [PathQuery] string employment_id, + [PathQuery] string? user_id_type = "people_corehr_id"); + + /// + /// 【飞书人事（企业版）】批量查询部门版本信息 + /// 接口ID：7372158581884911618 + /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/query_multi_timeline + /// Authorization：tenant_access_token + /// 批量查询部门版本信息 + /// + /// + /// 必填：是 + /// 分页大小，最大 100 + /// 示例值：100 + /// 默认值：10 + /// + /// + /// 必填：否 + /// 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果 + /// 示例值：6891251722631890445 + /// 默认值：null + /// + /// + /// 必填：否 + /// 用户 ID 类型 + /// 示例值：people_corehr_id + /// + /// open_id：标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。[了解更多：如何获取 Open ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid) + /// union_id：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。[了解更多：如何获取 Union ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-union-id) + /// user_id：标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。[了解更多：如何获取 User ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-user-id) + /// people_corehr_id：以飞书人事的 ID 来识别用户 + /// + /// 默认值：people_corehr_id + /// + /// + /// 必填：否 + /// 此次调用中使用的部门 ID 类型 + /// 示例值：people_corehr_department_id + /// + /// open_department_id：【飞书】用来在具体某个应用中标识一个部门，同一个department_id 在不同应用中的 open_department_id 相同。 + /// department_id：【飞书】用来标识租户内一个唯一的部门。 + /// people_corehr_department_id：【飞书人事】用来标识「飞书人事」中的部门。 + /// + /// 默认值：people_corehr_department_id + /// + /// 请求体 + [HttpPost("/open-apis/corehr/v2/departments/query_multi_timeline")] + System.Threading.Tasks.Task> PostCorehrV2DepartmentsQueryMultiTimelineAsync( + [JsonContent] Corehr.PostCorehrV2DepartmentsQueryMultiTimelineBodyDto dto, + [PathQuery] int page_size = 10, + [PathQuery] string? page_token = null, + [PathQuery] string? user_id_type = "people_corehr_id", + [PathQuery] string? department_id_type = "people_corehr_department_id"); }