Skip to content

Commit d72bb31

Browse files
author
Vicente.Yu
committed
新增
- 【飞书人事（企业版）】批量查询部门操作日志 变更 - 获取职位设置 响应体 - 更新职位设置 请求体 - 更新职位设置 响应体 - 新建职位 请求体 - 新建职位 响应体 - 批量查询部门版本信息 响应体 - 查询指定生效日期的部门基本信息 响应体 - 批量查询员工任职信息 响应体 - 获取任职信息列表 响应体 - 查询单个任职信息 响应体 - 批量查询任职信息 响应体 - 获取笔试列表 响应体 Signed-off-by: Vicente.Yu <^@^>
1 parent 7de80a6 commit d72bb31

File tree

46 files changed

+789
-255
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

46 files changed

+789
-255
lines changed

‎TenantAccessList.md

Lines changed: 103 additions & 101 deletions
Large diffs are not rendered by default.

‎UserAccessList.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@
2323
<tr><td colspan="3">GetDocxV1DocumentsByDocumentIdRawContent</td></tr>
2424
<tr><td rowspan="2">12</td><td rowspan="2">2024-09-24</td><td>&#10003;</td><td>云文档</td><td>获取文档所有块</td></tr>
2525
<tr><td colspan="3">GetDocxV1DocumentsByDocumentIdBlocks</td></tr>
26-
<tr><td rowspan="2">13</td><td rowspan="2">2024-10-22</td><td>&#10003;</td><td>云文档</td><td>创建文档</td></tr>
26+
<tr><td rowspan="2">13</td><td rowspan="2">2024-12-25</td><td>&#10003;</td><td>云文档</td><td>创建文档</td></tr>
2727
<tr><td colspan="3">PostDocxV1Documents</td></tr>
2828
<tr><td rowspan="2">14</td><td rowspan="2">2024-07-05</td><td>&#10003;</td><td>通讯录</td><td>获取单个职务信息</td></tr>
2929
<tr><td colspan="3">GetContactV3JobTitlesByJobTitleId</td></tr>
@@ -707,7 +707,7 @@
707707
<tr><td colspan="3">PostTaskV2CustomFieldsByCustomFieldGuidOptions</td></tr>
708708
<tr><td rowspan="2">354</td><td rowspan="2">2023-09-11</td><td>&#10003;</td><td>任务</td><td>更新自定义字段选项</td></tr>
709709
<tr><td colspan="3">PatchTaskV2CustomFieldsByCustomFieldGuidOptionsByOptionGuid</td></tr>
710-
<tr><td rowspan="2">355</td><td rowspan="2">2024-12-16</td><td>&#10003;</td><td>邮箱</td><td>查询所有公共邮箱</td></tr>
710+
<tr><td rowspan="2">355</td><td rowspan="2">2024-12-24</td><td>&#10003;</td><td>邮箱</td><td>查询所有公共邮箱</td></tr>
711711
<tr><td colspan="3">GetMailV1PublicMailboxes</td></tr>
712712
<tr><td rowspan="2">356</td><td rowspan="2">2023-11-27</td><td>&#10003;</td><td>搜索</td><td>搜索消息</td></tr>
713713
<tr><td colspan="3">PostSearchV2Message</td></tr>
@@ -763,9 +763,9 @@
763763
<tr><td colspan="3">PostLingoV1FilesUpload</td></tr>
764764
<tr><td rowspan="2">382</td><td rowspan="2">2023-10-25</td><td>&#10003;</td><td>词典</td><td>下载图片</td></tr>
765765
<tr><td colspan="3">GetLingoV1FilesByFileTokenDownload</td></tr>
766-
<tr><td rowspan="2">383</td><td rowspan="2">2024-12-17</td><td>&#10003;</td><td>妙记</td><td>获取妙记统计数据</td></tr>
766+
<tr><td rowspan="2">383</td><td rowspan="2">2024-12-24</td><td>&#10003;</td><td>妙记</td><td>获取妙记统计数据</td></tr>
767767
<tr><td colspan="3">GetMinutesV1MinutesByMinuteTokenStatistics</td></tr>
768-
<tr><td rowspan="2">384</td><td rowspan="2">2024-12-17</td><td>&#10003;</td><td>妙记</td><td>获取妙记信息</td></tr>
768+
<tr><td rowspan="2">384</td><td rowspan="2">2024-12-24</td><td>&#10003;</td><td>妙记</td><td>获取妙记信息</td></tr>
769769
<tr><td colspan="3">GetMinutesV1MinutesByMinuteToken</td></tr>
770770
<tr><td rowspan="2">385</td><td rowspan="2">2023-04-07</td><td>&#10003;</td><td>应用信息</td><td>获取用户自定义常用的应用</td></tr>
771771
<tr><td colspan="3">GetApplicationV5ApplicationsFavourite</td></tr>
@@ -955,7 +955,7 @@
955955
<tr><td colspan="3">GetDriveV2PermissionsByTokenPublic</td></tr>
956956
<tr><td rowspan="2">478</td><td rowspan="2">2024-07-31</td><td>&#10003;</td><td>云文档</td><td>更新云文档权限设置</td></tr>
957957
<tr><td colspan="3">PatchDriveV2PermissionsByTokenPublic</td></tr>
958-
<tr><td rowspan="2">479</td><td rowspan="2">2024-04-09</td><td>&#10003;</td><td>云文档</td><td>获取云文档所有评论</td></tr>
958+
<tr><td rowspan="2">479</td><td rowspan="2">2024-12-25</td><td>&#10003;</td><td>云文档</td><td>获取云文档所有评论</td></tr>
959959
<tr><td colspan="3">GetDriveV1FilesByFileTokenComments</td></tr>
960960
<tr><td rowspan="2">480</td><td rowspan="2">2024-04-09</td><td>&#10003;</td><td>云文档</td><td>添加全文评论</td></tr>
961961
<tr><td colspan="3">PostDriveV1FilesByFileTokenComments</td></tr>
@@ -1015,7 +1015,7 @@
10151015
<tr><td colspan="3">PostAilyV1Sessions</td></tr>
10161016
<tr><td rowspan="2">508</td><td rowspan="2">2024-12-10</td><td>&#10003;</td><td>薪酬管理</td><td>批量查询员工薪资档案</td></tr>
10171017
<tr><td colspan="3">PostCompensationV1ArchivesQuery</td></tr>
1018-
<tr><td rowspan="2">509</td><td rowspan="2">2024-10-09</td><td>&#10003;</td><td>飞书人事（企业版）</td><td>添加人员</td></tr>
1018+
<tr><td rowspan="2">509</td><td rowspan="2">2024-12-27</td><td>&#10003;</td><td>飞书人事（企业版）</td><td>添加人员</td></tr>
10191019
<tr><td colspan="3">PostCorehrV2Employees</td></tr>
10201020
<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>
10211021
<tr><td colspan="3">PostPerformanceV2MetricLibsQuery</td></tr>
@@ -1043,7 +1043,7 @@
10431043
<tr><td colspan="3">GetWikiV2SpacesBySpaceIdMembers</td></tr>
10441044
<tr><td rowspan="2">522</td><td rowspan="2">2024-08-02</td><td>&#10003;</td><td>画板</td><td>获取画板缩略图片</td></tr>
10451045
<tr><td colspan="3">GetBoardV1WhiteboardsByWhiteboardIdDownloadAsImage</td></tr>
1046-
<tr><td rowspan="2">523</td><td rowspan="2">2024-12-16</td><td>&#10003;</td><td>邮箱</td><td>发送邮件</td></tr>
1046+
<tr><td rowspan="2">523</td><td rowspan="2">2024-12-24</td><td>&#10003;</td><td>邮箱</td><td>发送邮件</td></tr>
10471047
<tr><td colspan="3">PostMailV1UserMailboxesByUserMailboxIdMessagesSend</td></tr>
10481048
<tr><td rowspan="2">524</td><td rowspan="2">2024-08-30</td><td><span style="color:red;">删除</span></td><td>公司圈</td><td>查询帖子信息</td></tr>
10491049
<tr><td colspan="3">GetMomentsV1PostsByPostId</td></tr>
@@ -1085,22 +1085,22 @@
10851085
<tr><td colspan="3">GetBitableV1AppsByAppTokenWorkflows</td></tr>
10861086
<tr><td rowspan="2">543</td><td rowspan="2">2024-12-11</td><td>&#10003;</td><td>多维表格</td><td>更新自动化流程状态</td></tr>
10871087
<tr><td colspan="3">PutBitableV1AppsByAppTokenWorkflowsByWorkflowId</td></tr>
1088-
<tr><td rowspan="2">544</td><td rowspan="2">2024-12-19</td><td>新增</td><td>Payroll</td><td>批量查询算薪项</td></tr>
1088+
<tr><td rowspan="2">544</td><td rowspan="2">2024-12-19</td><td>&#10003;</td><td>Payroll</td><td>批量查询算薪项</td></tr>
10891089
<tr><td colspan="3">GetPayrollV1AcctItems</td></tr>
1090-
<tr><td rowspan="2">545</td><td rowspan="2">2024-12-20</td><td>新增</td><td>云文档</td><td>获取云文档的点赞者列表</td></tr>
1090+
<tr><td rowspan="2">545</td><td rowspan="2">2024-12-20</td><td>&#10003;</td><td>云文档</td><td>获取云文档的点赞者列表</td></tr>
10911091
<tr><td colspan="3">GetDriveV2FilesByFileTokenLikes</td></tr>
1092-
<tr><td rowspan="2">546</td><td rowspan="2">2024-12-19</td><td>新增</td><td>云文档</td><td>在群公告中创建块</td></tr>
1092+
<tr><td rowspan="2">546</td><td rowspan="2">2024-12-19</td><td>&#10003;</td><td>云文档</td><td>在群公告中创建块</td></tr>
10931093
<tr><td colspan="3">PostDocxV1ChatsByChatIdAnnouncementBlocksByBlockIdChildren</td></tr>
1094-
<tr><td rowspan="2">547</td><td rowspan="2">2024-12-19</td><td>新增</td><td>云文档</td><td>批量更新群公告块的内容</td></tr>
1094+
<tr><td rowspan="2">547</td><td rowspan="2">2024-12-19</td><td>&#10003;</td><td>云文档</td><td>批量更新群公告块的内容</td></tr>
10951095
<tr><td colspan="3">PatchDocxV1ChatsByChatIdAnnouncementBlocksBatchUpdate</td></tr>
1096-
<tr><td rowspan="2">548</td><td rowspan="2">2024-12-19</td><td>新增</td><td>云文档</td><td>获取群公告块的内容</td></tr>
1096+
<tr><td rowspan="2">548</td><td rowspan="2">2024-12-19</td><td>&#10003;</td><td>云文档</td><td>获取群公告块的内容</td></tr>
10971097
<tr><td colspan="3">GetDocxV1ChatsByChatIdAnnouncementBlocksByBlockId</td></tr>
1098-
<tr><td rowspan="2">549</td><td rowspan="2">2024-12-19</td><td>新增</td><td>云文档</td><td>获取所有子块</td></tr>
1098+
<tr><td rowspan="2">549</td><td rowspan="2">2024-12-19</td><td>&#10003;</td><td>云文档</td><td>获取所有子块</td></tr>
10991099
<tr><td colspan="3">GetDocxV1ChatsByChatIdAnnouncementBlocksByBlockIdChildren</td></tr>
1100-
<tr><td rowspan="2">550</td><td rowspan="2">2024-12-19</td><td>新增</td><td>云文档</td><td>删除群公告中的块</td></tr>
1100+
<tr><td rowspan="2">550</td><td rowspan="2">2024-12-19</td><td>&#10003;</td><td>云文档</td><td>删除群公告中的块</td></tr>
11011101
<tr><td colspan="3">DeleteDocxV1ChatsByChatIdAnnouncementBlocksByBlockIdChildrenBatchDelete</td></tr>
1102-
<tr><td rowspan="2">551</td><td rowspan="2">2024-12-19</td><td>新增</td><td>云文档</td><td>获取群公告基本信息</td></tr>
1102+
<tr><td rowspan="2">551</td><td rowspan="2">2024-12-19</td><td>&#10003;</td><td>云文档</td><td>获取群公告基本信息</td></tr>
11031103
<tr><td colspan="3">GetDocxV1ChatsByChatIdAnnouncement</td></tr>
1104-
<tr><td rowspan="2">552</td><td rowspan="2">2024-12-19</td><td>新增</td><td>云文档</td><td>获取群公告所有块</td></tr>
1104+
<tr><td rowspan="2">552</td><td rowspan="2">2024-12-19</td><td>&#10003;</td><td>云文档</td><td>获取群公告所有块</td></tr>
11051105
<tr><td colspan="3">GetDocxV1ChatsByChatIdAnnouncementBlocks</td></tr>
11061106
</tbody></table>

‎src/Attendance/PostAttendanceV1UserApprovalsBodyDto.cs

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -370,10 +370,10 @@ public record UserOvertimeWork
370370
/// <para>必填：是</para>
371371
/// <para>示例值：1</para>
372372
/// <para>可选值：<list type="bullet">
373-
/// <item>0：不关联加班规则</item>
373+
/// <item>0：仅记录</item>
374374
/// <item>1：调休</item>
375375
/// <item>2：加班费</item>
376-
/// <item>3：关联加班规则，没有调休或加班费</item>
376+
/// <item>3：【该可选值已废弃】</item>
377377
/// </list></para>
378378
/// </summary>
379379
[JsonPropertyName("type")]

‎src/Ccm/GetDriveV1FilesByFileTokenCommentsResponseDto.cs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -308,7 +308,7 @@ public record ReplyElementPerson
308308
public record ReplyExtra
309309
{
310310
/// <summary>
311-
/// <para>评论中的图片 Token list</para>
311+
/// <para>评论中的图片 Token list。暂不支持通过接口下载图片。</para>
312312
/// <para>必填：否</para>
313313
/// </summary>
314314
[JsonPropertyName("image_list")]

‎src/Ccm/PostDocxV1DocumentsResponseDto.cs

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,8 @@ public record PostDocxV1DocumentsResponseDto
3434
public record PostDocxV1DocumentsResponseDtoDocument
3535
{
3636
/// <summary>
37-
/// <para>文档的唯一标识。点击[这里](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/document-docx/docx-overview)了解如何获取文档的 `document_id`</para>
37+
/// <para>文档的唯一标识。你可以将 `https://sample.feishu.cn/docx/` 与该标识拼接，并将 sample 替换为实际域名，生成文档的 URL 链接。如 `https://sample.feishu.cn/docx/doxbcmEtbFrbbq10nPNu8gabcef`。</para>
38+
/// <para>![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/f8dac29d8ea3f01f5a651e0445193213_W0CZqRcbHM.png?height=639&amp;lazyload=true&amp;width=2161)</para>
3839
/// <para>必填：否</para>
3940
/// <para>示例值：doxbcmEtbFrbbq10nPNu8gabcef</para>
4041
/// <para>最大长度：27</para>

‎src/Corehr/PostCorehrV2DepartmentsQueryMultiTimelineBodyDto.cs

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@
1414
namespace FeishuNetSdk.Corehr;
1515
/// <summary>
1616
/// 批量查询部门版本信息 请求体
17-
/// <para>批量查询部门版本信息</para>
17+
/// <para>根据部门ID列表，批量查询开始结束时间内的所有部门版本信息，含部门名称、部门类型、上级、编码、负责人、是否启用、描述等信息</para>
1818
/// <para>接口ID：7372158581884911618</para>
1919
/// <para>文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/query_multi_timeline</para>
2020
/// <para>JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fdepartment%2fquery_multi_timeline</para>
@@ -51,7 +51,7 @@ public record PostCorehrV2DepartmentsQueryMultiTimelineBodyDto
5151
public string? EffectiveDateEnd { get; set; }
5252

5353
/// <summary>
54-
/// <para>返回数据的字段列表，可选["department_name", "code", "active", "parent_department_id", "manager", "description", "effective_date"], 以及自定义字段field_name</para>
54+
/// <para>返回数据的字段列表，可选["department_name", "sub_type", "code", "active", "parent_department_id", "manager", "description", "effective_date"], 以及自定义字段field_name</para>
5555
/// <para>必填：否</para>
5656
/// <para>最大长度：100</para>
5757
/// <para>最小长度：0</para>

‎src/Corehr/PostCorehrV2DepartmentsQueryMultiTimelineResponseDto.cs

Lines changed: 64 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
// Created : 2024-06-24
55
//
66
// Last Modified By : yxr
7-
// Last Modified On : 2024-06-24
7+
// Last Modified On : 2024-12-27
88
// ************************************************************************
99
// <copyright file="PostCorehrV2DepartmentsQueryMultiTimelineResponseDto.cs" company="Vicente Yu">
1010
// MIT
@@ -14,7 +14,7 @@
1414
namespace FeishuNetSdk.Corehr;
1515
/// <summary>
1616
/// 批量查询部门版本信息 响应体
17-
/// <para>批量查询部门版本信息</para>
17+
/// <para>根据部门ID列表，批量查询开始结束时间内的所有部门版本信息，含部门名称、部门类型、上级、编码、负责人、是否启用、描述等信息</para>
1818
/// <para>接口ID：7372158581884911618</para>
1919
/// <para>文档地址：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/query_multi_timeline</para>
2020
/// <para>JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fcorehr-v2%2fdepartment%2fquery_multi_timeline</para>
@@ -64,32 +64,84 @@ public record DepartmentTimeline
6464
public record I18n
6565
{
6666
/// <summary>
67-
/// <para>语言</para>
67+
/// <para>语言，中文用zh-CN，英文用en-US</para>
6868
/// <para>必填：是</para>
6969
/// <para>示例值：zh-CN</para>
7070
/// </summary>
7171
[JsonPropertyName("lang")]
7272
public string Lang { get; set; } = string.Empty;
7373

7474
/// <summary>
75-
/// <para>内容</para>
75+
/// <para>文本内容</para>
7676
/// <para>必填：是</para>
77-
/// <para>示例值：张三</para>
77+
/// <para>示例值：中文示例</para>
7878
/// </summary>
7979
[JsonPropertyName("value")]
8080
public string Value { get; set; } = string.Empty;
8181
}
8282

8383
/// <summary>
84-
/// <para>上级部门 ID</para>
84+
/// <para>部门类型</para>
85+
/// <para>- 通过[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)查询获取。请求参数：object_api_name=department；custom_api_name=subtype。</para>
86+
/// <para>必填：否</para>
87+
/// </summary>
88+
[JsonPropertyName("sub_type")]
89+
public Enum? SubType { get; set; }
90+
91+
/// <summary>
92+
/// <para>部门类型</para>
93+
/// <para>- 通过[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)查询获取。请求参数：object_api_name=department；custom_api_name=subtype。</para>
94+
/// </summary>
95+
public record Enum
96+
{
97+
/// <summary>
98+
/// <para>枚举值</para>
99+
/// <para>必填：是</para>
100+
/// <para>示例值：phone_type</para>
101+
/// </summary>
102+
[JsonPropertyName("enum_name")]
103+
public string EnumName { get; set; } = string.Empty;
104+
105+
/// <summary>
106+
/// <para>枚举多语展示</para>
107+
/// <para>必填：否</para>
108+
/// </summary>
109+
[JsonPropertyName("display")]
110+
public I18n[]? Displies { get; set; }
111+
112+
/// <summary>
113+
/// <para>枚举多语展示</para>
114+
/// </summary>
115+
public record I18n
116+
{
117+
/// <summary>
118+
/// <para>语言编码（IETF BCP 47）</para>
119+
/// <para>必填：是</para>
120+
/// <para>示例值：zh-CN</para>
121+
/// </summary>
122+
[JsonPropertyName("lang")]
123+
public string Lang { get; set; } = string.Empty;
124+
125+
/// <summary>
126+
/// <para>文本内容</para>
127+
/// <para>必填：是</para>
128+
/// <para>示例值：中文示例</para>
129+
/// </summary>
130+
[JsonPropertyName("value")]
131+
public string Value { get; set; } = string.Empty;
132+
}
133+
}
134+
135+
/// <summary>
136+
/// <para>上级部门 ID ，详细信息可通过[【查询单个部门】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/department/get)接口获得</para>
85137
/// <para>必填：否</para>
86138
/// <para>示例值：4719456877659520111</para>
87139
/// </summary>
88140
[JsonPropertyName("parent_department_id")]
89141
public string? ParentDepartmentId { get; set; }
90142

91143
/// <summary>
92-
/// <para>部门负责人雇佣 ID，枚举值及详细信息可通过【查询员工信息】接口查询获得</para>
144+
/// <para>部门负责人雇佣 ID，枚举值及详细信息可通过[【搜索员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search)接口查询获得</para>
93145
/// <para>必填：否</para>
94146
/// <para>示例值：6893013238632416777</para>
95147
/// </summary>
@@ -106,6 +158,8 @@ public record I18n
106158

107159
/// <summary>
108160
/// <para>生效日期</para>
161+
/// <para>- 返回格式：YYYY-MM-DD（最小单位到日）</para>
162+
/// <para>- 日期范围:1900-01-01～9999-12-31</para>
109163
/// <para>必填：否</para>
110164
/// <para>示例值：2020-05-01</para>
111165
/// </summary>
@@ -130,7 +184,7 @@ public record I18n
130184
public I18n[]? Descriptions { get; set; }
131185

132186
/// <summary>
133-
/// <para>自定义字段</para>
187+
/// <para>自定义字段类型，详细见[获取自定义字段列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/query)</para>
134188
/// <para>必填：否</para>
135189
/// <para>最大长度：50</para>
136190
/// <para>最小长度：0</para>
@@ -139,7 +193,7 @@ public record I18n
139193
public CustomFieldData[]? CustomFields { get; set; }
140194

141195
/// <summary>
142-
/// <para>自定义字段</para>
196+
/// <para>自定义字段类型，详细见[获取自定义字段列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/query)</para>
143197
/// </summary>
144198
public record CustomFieldData
145199
{
@@ -181,7 +235,7 @@ public record CustomName
181235
}
182236

183237
/// <summary>
184-
/// <para>自定义字段类型</para>
238+
/// <para>自定义字段类型，详细见[获取自定义字段列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/query)</para>
185239
/// <para>必填：否</para>
186240
/// <para>示例值：1</para>
187241
/// </summary>

0 commit comments

Comments
 (0)