新增

- 【招聘】获取用户角色列表 - 【招聘】查询面试官信息列表 - 【招聘】更新面试官信息 - 【招聘】获取面试速记明细 - 【应用信息】向管理员申请授权 - 【应用信息】查询租户授权状态更新 - 通过地点 ID 批量获取地点信息响应体 - 更新员工状态请求体 - 更新员工状态响应体 - 创建外部面试请求体 - 创建外部面试响应体 - 操作候选人入职请求体 Signed-off-by: Vicente.Yu <^@^>
vicenteyu · Aug 28, 2024 · 63c1379 · 63c1379
1 parent 56bf07c
commit 63c1379
Show file tree

Hide file tree

Showing 104 changed files with 2,442 additions and 985 deletions.
diff --git a/TenantAccessList.md b/TenantAccessList.md
diff --git a/UserAccessList.md b/UserAccessList.md
@@ -707,7 +707,7 @@
 <tr><td colspan="3">PostTaskV2CustomFieldsByCustomFieldGuidOptions</td></tr>
 <tr><td rowspan="2">354</td><td rowspan="2">2023-09-11</td><td>&#10003;</td><td>任务</td><td>更新自定义字段选项</td></tr>
 <tr><td colspan="3">PatchTaskV2CustomFieldsByCustomFieldGuidOptionsByOptionGuid</td></tr>
-<tr><td rowspan="2">355</td><td rowspan="2">2024-08-15</td><td>&#10003;</td><td>邮箱</td><td>查询所有公共邮箱</td></tr>
+<tr><td rowspan="2">355</td><td rowspan="2">2024-08-28</td><td>&#10003;</td><td>邮箱</td><td>查询所有公共邮箱</td></tr>
 <tr><td colspan="3">GetMailV1PublicMailboxes</td></tr>
 <tr><td rowspan="2">356</td><td rowspan="2">2023-11-27</td><td>&#10003;</td><td>搜索</td><td>搜索消息</td></tr>
 <tr><td colspan="3">PostSearchV2Message</td></tr>
@@ -1015,7 +1015,7 @@
 <tr><td colspan="3">PostAilyV1Sessions</td></tr>
 <tr><td rowspan="2">508</td><td rowspan="2">2024-08-22</td><td>&#10003;</td><td>薪酬管理</td><td>批量查询员工薪资档案</td></tr>
 <tr><td colspan="3">PostCompensationV1ArchivesQuery</td></tr>
-<tr><td rowspan="2">509</td><td rowspan="2">2024-07-17</td><td>&#10003;</td><td>飞书人事（企业版）</td><td>添加人员</td></tr>
+<tr><td rowspan="2">509</td><td rowspan="2">2024-08-26</td><td>&#10003;</td><td>飞书人事（企业版）</td><td>添加人员</td></tr>
 <tr><td colspan="3">PostCorehrV2Employees</td></tr>
 <tr><td rowspan="2">510</td><td rowspan="2">2024-07-10</td><td><span style="color:red;">删除</span></td><td>绩效</td><td>获取指标库信息</td></tr>
 <tr><td colspan="3">PostPerformanceV2MetricLibsQuery</td></tr>

diff --git a/src/Application/GetApplicationV6ScopesResponseDto.cs b/src/Application/GetApplicationV6ScopesResponseDto.cs
@@ -0,0 +1,56 @@
+// ************************************************************************
+// Assembly         : FeishuNetSdk
+// Author           : yxr
+// Created          : 2024-08-28
+//
+// Last Modified By : yxr
+// Last Modified On : 2024-08-28
+// ************************************************************************
+// <copyright file="GetApplicationV6ScopesResponseDto.cs" company="Vicente Yu">
+//     MIT
+// </copyright>
+// <summary>查询租户授权状态 响应体</summary>
+// ************************************************************************
+namespace FeishuNetSdk.Application;
+/// <summary>
+/// 查询租户授权状态 响应体
+/// <para>调用该接口查询当前应用向租户申请授权的状态。</para>
+/// <para>接口ID：7406972061036445700</para>
+/// <para>文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/scope/list</para>
+/// <para>JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fapplication-v6%2fscope%2flist</para>
+/// </summary>
+public record GetApplicationV6ScopesResponseDto
+{
+    /// <summary>
+    /// <para>租户对当前应用所需权限的授予情况。</para>
+    /// <para>必填：否</para>
+    /// </summary>
+    [JsonPropertyName("scopes")]
+    public Scope[]? Scopes { get; set; }
+
+    /// <summary>
+    /// <para>租户对当前应用所需权限的授予情况。</para>
+    /// </summary>
+    public record Scope
+    {
+        /// <summary>
+        /// <para>权限名称。取值示例 `user.phone:readonly`。</para>
+        /// <para>必填：是</para>
+        /// <para>示例值：user.phone:readonly</para>
+        /// </summary>
+        [JsonPropertyName("scope_name")]
+        public string ScopeName { get; set; } = string.Empty;
+
+        /// <summary>
+        /// <para>权限授予状态。</para>
+        /// <para>必填：是</para>
+        /// <para>示例值：1</para>
+        /// <para>可选值：<list type="bullet">
+        /// <item>1：已授权</item>
+        /// <item>2：未授权</item>
+        /// </list></para>
+        /// </summary>
+        [JsonPropertyName("grant_status")]
+        public int GrantStatus { get; set; }
+    }
+}
diff --git a/src/Attendance/PostAttendanceV1GroupsBodyDto.cs b/src/Attendance/PostAttendanceV1GroupsBodyDto.cs
@@ -24,14 +24,14 @@ namespace FeishuNetSdk.Attendance;
 public record PostAttendanceV1GroupsBodyDto
 {
     /// <summary>
-    /// <para>6921319402260496386</para>
+    /// <para>考勤组信息</para>
     /// <para>必填：是</para>
     /// </summary>
     [JsonPropertyName("group")]
     public PostAttendanceV1GroupsBodyDtoGroup Group { get; set; } = new();
 
     /// <summary>
-    /// <para>6921319402260496386</para>
+    /// <para>考勤组信息</para>
     /// </summary>
     public record PostAttendanceV1GroupsBodyDtoGroup
     {
@@ -452,7 +452,7 @@ public record Location
         public int GroupType { get; set; }
 
         /// <summary>
-        /// <para>班次 ID 列表。当考勤类型参数（group_type）设置为固定班制时，必填该参数，且必须填够 7 个（从周一至周日）。班次 ID 可以通过[查询所有班次](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/shift/list) 和[按名称查询班次](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/shift/query) 获取</para>
+        /// <para>班次 ID 列表。当考勤类型参数（group_type）设置为固定班制时，必填该参数，且必须填够 7 个（从周一至周日）。班次 ID 可以通过[查询所有班次](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/shift/list) 和[按名称查询班次](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/shift/query) 获取。休息日填0</para>
         /// <para>必填：是</para>
         /// <para>示例值：6921319402260496386</para>
         /// </summary>

diff --git a/src/Attendance/PostAttendanceV1GroupsResponseDto.cs b/src/Attendance/PostAttendanceV1GroupsResponseDto.cs
@@ -24,14 +24,14 @@ namespace FeishuNetSdk.Attendance;
 public record PostAttendanceV1GroupsResponseDto
 {
     /// <summary>
-    /// <para>6921319402260496386</para>
+    /// <para>考勤组信息</para>
     /// <para>必填：否</para>
     /// </summary>
     [JsonPropertyName("group")]
     public PostAttendanceV1GroupsResponseDtoGroup? Group { get; set; }
 
     /// <summary>
-    /// <para>6921319402260496386</para>
+    /// <para>考勤组信息</para>
     /// </summary>
     public record PostAttendanceV1GroupsResponseDtoGroup
     {

diff --git a/src/Attendance/PostAttendanceV1UserSettingsModifyBodyDto.cs b/src/Attendance/PostAttendanceV1UserSettingsModifyBodyDto.cs
@@ -42,7 +42,7 @@ public record PostAttendanceV1UserSettingsModifyBodyDtoUserSetting
         public string UserId { get; set; } = string.Empty;
 
         /// <summary>
-        /// <para>人脸照片文件 ID，获取方式：[文件上传](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/file/upload)</para>
+        /// <para>人脸照片文件 ID，获取方式：[上传用户人脸识别照片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/file/upload)</para>
         /// <para>必填：是</para>
         /// <para>示例值：xxxxxb306842b1c189bc5212eefxxxxx</para>
         /// </summary>

diff --git a/src/Attendance/PostAttendanceV1UserSettingsModifyResponseDto.cs b/src/Attendance/PostAttendanceV1UserSettingsModifyResponseDto.cs
@@ -42,7 +42,7 @@ public record PostAttendanceV1UserSettingsModifyResponseDtoUserSetting
         public string UserId { get; set; } = string.Empty;
 
         /// <summary>
-        /// <para>人脸照片文件 ID，获取方式：[文件上传](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/file/upload)</para>
+        /// <para>人脸照片文件 ID</para>
         /// <para>必填：是</para>
         /// <para>示例值：xxxxxb306842b1c189bc5212eefxxxxx</para>
         /// </summary>

diff --git a/src/Corehr/DeleteCorehrV2CostCentersByCostCenterIdBodyDto.cs b/src/Corehr/DeleteCorehrV2CostCentersByCostCenterIdBodyDto.cs
@@ -14,7 +14,7 @@
 namespace FeishuNetSdk.Corehr;
 /// <summary>
 /// 删除成本中心 请求体
-/// <para>删除成本中心</para>
+/// <para>删除成本中心记录</para>
 /// <para>接口ID：7225452763517157379</para>
 /// <para>文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/organization-management/cost_center/delete</para>
 /// <para>JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fcost_center%2fdelete</para>

diff --git a/src/Corehr/DeleteCorehrV2CostCentersByCostCenterIdVersionsByVersionIdBodyDto.cs b/src/Corehr/DeleteCorehrV2CostCentersByCostCenterIdVersionsByVersionIdBodyDto.cs
@@ -9,12 +9,12 @@
 // <copyright file="DeleteCorehrV2CostCentersByCostCenterIdVersionsByVersionIdBodyDto.cs" company="Vicente Yu">
 //     MIT
 // </copyright>
-// <summary>删除成本中心版本 请求体</summary>
+// <summary>撤销成本中心版本 请求体</summary>
 // ************************************************************************
 namespace FeishuNetSdk.Corehr;
 /// <summary>
-/// 删除成本中心版本 请求体
-/// <para>撤销成本中心版本</para>
+/// 撤销成本中心版本 请求体
+/// <para>该接口支持通过成本中心的版本ID撤销成本中心版本信息</para>
 /// <para>接口ID：7225452763517124611</para>
 /// <para>文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/organization-management/cost_center/cost_center-version/delete</para>
 /// <para>JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fcost_center-version%2fdelete</para>

diff --git a/src/Corehr/PatchCorehrV2CostCentersByCostCenterIdVersionsByVersionIdBodyDto.cs b/src/Corehr/PatchCorehrV2CostCentersByCostCenterIdVersionsByVersionIdBodyDto.cs
@@ -9,12 +9,12 @@
 // <copyright file="PatchCorehrV2CostCentersByCostCenterIdVersionsByVersionIdBodyDto.cs" company="Vicente Yu">
 //     MIT
 // </copyright>
-// <summary>更新成本中心版本 请求体</summary>
+// <summary>更正成本中心版本 请求体</summary>
 // ************************************************************************
 namespace FeishuNetSdk.Corehr;
 /// <summary>
-/// 更新成本中心版本 请求体
-/// <para>更正成本中心版本</para>
+/// 更正成本中心版本 请求体
+/// <para>对成本中心的版本记录进行更正，可更正的字段包括：名称，上级成本中心，成本中心负责人列表，成本中心的描述，生效时间</para>
 /// <para>接口ID：7225452763517190147</para>
 /// <para>文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/organization-management/cost_center/cost_center-version/patch</para>
 /// <para>JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fcost_center-version%2fpatch</para>
@@ -34,7 +34,7 @@ public record PatchCorehrV2CostCentersByCostCenterIdVersionsByVersionIdBodyDto
     public record I18n
     {
         /// <summary>
-        /// <para>语言</para>
+        /// <para>信息的语言，支持中文和英文。中文用zh-CN；英文用en-US</para>
         /// <para>必填：是</para>
         /// <para>示例值：zh-CN</para>
         /// </summary>
@@ -44,22 +44,22 @@ public record I18n
         /// <summary>
         /// <para>内容</para>
         /// <para>必填：是</para>
-        /// <para>示例值：张三</para>
+        /// <para>示例值：基础架构</para>
         /// </summary>
         [JsonPropertyName("value")]
         public string Value { get; set; } = string.Empty;
     }
 
     /// <summary>
-    /// <para>上级成本中心ID</para>
+    /// <para>上级成本中心ID，可通过[【搜索成本中心信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search)接口查询获得</para>
     /// <para>必填：否</para>
     /// <para>示例值：6862995757234914824</para>
     /// </summary>
     [JsonPropertyName("parent_cost_center_id")]
     public string? ParentCostCenterId { get; set; }
 
     /// <summary>
-    /// <para>成本中心负责人ID 列表</para>
+    /// <para>成本中心负责人ID 列表，可通过[【搜索员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search)接口获取</para>
     /// <para>必填：否</para>
     /// </summary>
     [JsonPropertyName("managers")]
@@ -74,6 +74,10 @@ public record I18n
 
     /// <summary>
     /// <para>生效时间</para>
+    /// <para>- 填写格式：YYYY-MM-DD</para>
+    /// <para>- 系统默认为填写日期当天的 00:00:00 生效</para>
+    /// <para>- 该接口只支持到最小单位为日</para>
+    /// <para>- 日期范围要求:1900-01-01 ～9999-12-31</para>
     /// <para>必填：是</para>
     /// <para>示例值：2020-01-01</para>
     /// </summary>

diff --git a/src/Corehr/PatchCorehrV2CostCentersByCostCenterIdVersionsByVersionIdResponseDto.cs b/src/Corehr/PatchCorehrV2CostCentersByCostCenterIdVersionsByVersionIdResponseDto.cs
@@ -9,12 +9,12 @@
 // <copyright file="PatchCorehrV2CostCentersByCostCenterIdVersionsByVersionIdResponseDto.cs" company="Vicente Yu">
 //     MIT
 // </copyright>
-// <summary>更新成本中心版本 响应体</summary>
+// <summary>更正成本中心版本 响应体</summary>
 // ************************************************************************
 namespace FeishuNetSdk.Corehr;
 /// <summary>
-/// 更新成本中心版本 响应体
-/// <para>更正成本中心版本</para>
+/// 更正成本中心版本 响应体
+/// <para>对成本中心的版本记录进行更正，可更正的字段包括：名称，上级成本中心，成本中心负责人列表，成本中心的描述，生效时间</para>
 /// <para>接口ID：7225452763517190147</para>
 /// <para>文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/organization-management/cost_center/cost_center-version/patch</para>
 /// <para>JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fcost_center-version%2fpatch</para>
@@ -62,7 +62,7 @@ public record CostCenterVersion
         public record I18n
         {
             /// <summary>
-            /// <para>语言</para>
+            /// <para>信息的语言，支持中文和英文。中文用zh-CN；英文用en-US</para>
             /// <para>必填：是</para>
             /// <para>示例值：zh-CN</para>
             /// </summary>
@@ -72,7 +72,7 @@ public record I18n
             /// <summary>
             /// <para>内容</para>
             /// <para>必填：是</para>
-            /// <para>示例值：张三</para>
+            /// <para>示例值：基础架构</para>
             /// </summary>
             [JsonPropertyName("value")]
             public string Value { get; set; } = string.Empty;
@@ -87,15 +87,15 @@ public record I18n
         public string? Code { get; set; }
 
         /// <summary>
-        /// <para>上级成本中心ID</para>
+        /// <para>上级成本中心ID，详细信息可通过[【搜索成本中心信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search)接口查询获得</para>
         /// <para>必填：否</para>
         /// <para>示例值：6862995757234914824</para>
         /// </summary>
         [JsonPropertyName("parent_cost_center_id")]
         public string? ParentCostCenterId { get; set; }
 
         /// <summary>
-        /// <para>成本中心负责人ID 列表</para>
+        /// <para>成本中心负责人ID 列表，详细信息可通过[【搜索员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search)接口获取</para>
         /// <para>必填：否</para>
         /// </summary>
         [JsonPropertyName("managers")]
@@ -110,14 +110,18 @@ public record I18n
 
         /// <summary>
         /// <para>生效时间</para>
+        /// <para>- 返回格式：YYYY-MM-DD（最小单位到日）</para>
+        /// <para>- 日期范围:1900-01-01 ～9999-12-31</para>
         /// <para>必填：是</para>
         /// <para>示例值：2020-01-01</para>
         /// </summary>
         [JsonPropertyName("effective_time")]
         public string EffectiveTime { get; set; } = string.Empty;
 
         /// <summary>
-        /// <para>过期时间</para>
+        /// <para>失效时间</para>
+        /// <para>- 返回格式：YYYY-MM-DD（最小单位到日）</para>
+        /// <para>- 日期范围:1900-01-01～9999-12-31</para>
         /// <para>必填：否</para>
         /// <para>示例值：2020-01-01</para>
         /// </summary>

diff --git a/src/Corehr/PostCorehrV2ContractsSearchResponseDto.cs b/src/Corehr/PostCorehrV2ContractsSearchResponseDto.cs
@@ -132,7 +132,7 @@ public record I18n
         public string? FirstPartyCompanyId { get; set; }
 
         /// <summary>
-        /// <para>合同签约人员ID，详细信息可通过[【查询个人信息接口】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/person/get)接口查询获得</para>
+        /// <para>合同签约员工ID，详细信息可通过接口文档[【批量查询员工信息接口】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)接口查询获得</para>
         /// <para>必填：否</para>
         /// <para>示例值：7088589447189022252</para>
         /// </summary>

diff --git a/src/Corehr/PostCorehrV2CostCentersBodyDto.cs b/src/Corehr/PostCorehrV2CostCentersBodyDto.cs
@@ -14,27 +14,29 @@
 namespace FeishuNetSdk.Corehr;
 /// <summary>
 /// 创建成本中心 请求体
-/// <para>创建成本中心</para>
+/// <para>单个创建成本中心；可定义成本中心的名称，父级成本中心，成本中心负责人，生效时间等</para>
 /// <para>接口ID：7225452763517140995</para>
 /// <para>文档地址：https://open.feishu.cn/document/server-docs/corehr-v1/organization-management/cost_center/create</para>
 /// <para>JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fcost_center%2fcreate</para>
 /// </summary>
 public record PostCorehrV2CostCentersBodyDto
 {
     /// <summary>
-    /// <para>成本中心名称。名称不能包含「/」「；」「;」符号，名称长度不能超过 255 个字符</para>
+    /// <para>- 名称不能包含「/」「；」「;」字符</para>
+    /// <para>- 成本中心中英文名称会有全局唯一校验</para>
     /// <para>必填：是</para>
     /// </summary>
     [JsonPropertyName("name")]
     public I18n[] Names { get; set; } = Array.Empty<I18n>();
 
     /// <summary>
-    /// <para>成本中心名称。名称不能包含「/」「；」「;」符号，名称长度不能超过 255 个字符</para>
+    /// <para>- 名称不能包含「/」「；」「;」字符</para>
+    /// <para>- 成本中心中英文名称会有全局唯一校验</para>
     /// </summary>
     public record I18n
     {
         /// <summary>
-        /// <para>语言</para>
+        /// <para>名称信息的语言，支持中文和英文。中文用zh-CN；英文用en-US</para>
         /// <para>必填：是</para>
         /// <para>示例值：zh-CN</para>
         /// </summary>
@@ -44,30 +46,31 @@ public record I18n
         /// <summary>
         /// <para>内容</para>
         /// <para>必填：是</para>
-        /// <para>示例值：张三</para>
+        /// <para>示例值：基础架构相关</para>
         /// </summary>
         [JsonPropertyName("value")]
         public string Value { get; set; } = string.Empty;
     }
 
     /// <summary>
-    /// <para>编码</para>
+    /// <para>- 编码 (不能与其他记录的编码重复)；当开启自动编码时，该字段将无效</para>
     /// <para>必填：否</para>
     /// <para>示例值：MDPD00000023</para>
     /// </summary>
     [JsonPropertyName("code")]
     public string? Code { get; set; }
 
     /// <summary>
-    /// <para>上级成本中心ID</para>
+    /// <para>上级成本中心ID，详细信息可通过[【搜索成本中心信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search)接口查询获得</para>
     /// <para>必填：否</para>
     /// <para>示例值：6862995757234914824</para>
     /// </summary>
     [JsonPropertyName("parent_cost_center_id")]
     public string? ParentCostCenterId { get; set; }
 
     /// <summary>
-    /// <para>成本中心负责人ID 列表</para>
+    /// <para>成本中心负责人ID 列表；</para>
+    /// <para>详细信息可通过[【搜索员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search)接口获取</para>
     /// <para>必填：否</para>
     /// </summary>
     [JsonPropertyName("managers")]
@@ -81,7 +84,7 @@ public record I18n
     public I18n[]? Descriptions { get; set; }
 
     /// <summary>
-    /// <para>生效时间</para>
+    /// <para>生效时间；该接口最知好吃到最小单位为日</para>
     /// <para>必填：是</para>
     /// <para>示例值：2020-01-01</para>
     /// </summary>