feat(work): 新增安全管理获取操作日志相关接口

2026-03-10 00:13:36 +08:00 · 2024-09-29 11:14:32 +08:00
parent 905103a611
commit 5d7859f77d
13 changed files with 552 additions and 5 deletions
--- a/src/SKIT.FlurlHttpClient.Wechat.Work/Extensions/WechatWorkClientExecuteCgibinSecurityExtensions.cs
+++ b/src/SKIT.FlurlHttpClient.Wechat.Work/Extensions/WechatWorkClientExecuteCgibinSecurityExtensions.cs
@@ -9,6 +9,29 @@ namespace SKIT.FlurlHttpClient.Wechat.Work
 {
    public static class WechatWorkClientExecuteCgibinSecurityExtensions
    {
+        /// <summary>
+        /// <para>异步调用 [GET] /cgi-bin/security/get_server_domain_ip 接口。</para>
+        /// <para>
+        /// REF: <br/>
+        /// <![CDATA[ https://developer.work.weixin.qq.com/document/path/93221 ]]>
+        /// </para>
+        /// </summary>
+        /// <param name="client"></param>
+        /// <param name="request"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public static async Task<Models.CgibinSecurityGetServerDomainIpResponse> ExecuteCgibinSecurityGetServerDomainIpAsync(this WechatWorkClient client, Models.CgibinSecurityGetServerDomainIpRequest request, CancellationToken cancellationToken = default)
+        {
+            if (client is null) throw new ArgumentNullException(nameof(client));
+            if (request is null) throw new ArgumentNullException(nameof(request));
+
+            IFlurlRequest flurlReq = client
+                .CreateFlurlRequest(request, HttpMethod.Get, "cgi-bin", "security", "get_server_domain_ip")
+                .SetQueryParam("access_token", request.AccessToken);
+
+            return await client.SendFlurlRequestAsJsonAsync<Models.CgibinSecurityGetServerDomainIpResponse>(flurlReq, data: request, cancellationToken: cancellationToken).ConfigureAwait(false);
+        }
+
        /// <summary>
        /// <para>异步调用 [POST] /cgi-bin/security/get_file_oper_record 接口。</para>
        /// <para>
@@ -33,26 +56,72 @@ namespace SKIT.FlurlHttpClient.Wechat.Work
        }

        /// <summary>
-        /// <para>异步调用 [GET] /cgi-bin/security/get_server_domain_ip 接口。</para>
+        /// <para>异步调用 [POST] /cgi-bin/security/get_screen_oper_record 接口。</para>
        /// <para>
        /// REF: <br/>
-        /// <![CDATA[ https://developer.work.weixin.qq.com/document/path/93221 ]]>
+        /// <![CDATA[ https://developer.work.weixin.qq.com/document/path/100128 ]]>
        /// </para>
        /// </summary>
        /// <param name="client"></param>
        /// <param name="request"></param>
        /// <param name="cancellationToken"></param>
        /// <returns></returns>
-        public static async Task<Models.CgibinSecurityGetServerDomainIpResponse> ExecuteCgibinSecurityGetServerDomainIpAsync(this WechatWorkClient client, Models.CgibinSecurityGetServerDomainIpRequest request, CancellationToken cancellationToken = default)
+        public static async Task<Models.CgibinSecurityGetScreenOperateRecordResponse> ExecuteCgibinSecurityGetScreenOperateRecordAsync(this WechatWorkClient client, Models.CgibinSecurityGetScreenOperateRecordRequest request, CancellationToken cancellationToken = default)
        {
            if (client is null) throw new ArgumentNullException(nameof(client));
            if (request is null) throw new ArgumentNullException(nameof(request));

            IFlurlRequest flurlReq = client
-                .CreateFlurlRequest(request, HttpMethod.Get, "cgi-bin", "security", "get_server_domain_ip")
+                .CreateFlurlRequest(request, HttpMethod.Post, "cgi-bin", "security", "get_screen_oper_record")
                .SetQueryParam("access_token", request.AccessToken);

-            return await client.SendFlurlRequestAsJsonAsync<Models.CgibinSecurityGetServerDomainIpResponse>(flurlReq, data: request, cancellationToken: cancellationToken).ConfigureAwait(false);
+            return await client.SendFlurlRequestAsJsonAsync<Models.CgibinSecurityGetScreenOperateRecordResponse>(flurlReq, data: request, cancellationToken: cancellationToken).ConfigureAwait(false);
+        }
+
+        /// <summary>
+        /// <para>异步调用 [POST] /cgi-bin/security/member_oper_log/list 接口。</para>
+        /// <para>
+        /// REF: <br/>
+        /// <![CDATA[ https://developer.work.weixin.qq.com/document/path/100178 ]]>
+        /// </para>
+        /// </summary>
+        /// <param name="client"></param>
+        /// <param name="request"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public static async Task<Models.CgibinSecurityMemberOperateLogListResponse> ExecuteCgibinSecurityMemberOperateLogListAsync(this WechatWorkClient client, Models.CgibinSecurityMemberOperateLogListRequest request, CancellationToken cancellationToken = default)
+        {
+            if (client is null) throw new ArgumentNullException(nameof(client));
+            if (request is null) throw new ArgumentNullException(nameof(request));
+
+            IFlurlRequest flurlReq = client
+                .CreateFlurlRequest(request, HttpMethod.Post, "cgi-bin", "security", "member_oper_log", "list")
+                .SetQueryParam("access_token", request.AccessToken);
+
+            return await client.SendFlurlRequestAsJsonAsync<Models.CgibinSecurityMemberOperateLogListResponse>(flurlReq, data: request, cancellationToken: cancellationToken).ConfigureAwait(false);
+        }
+
+        /// <summary>
+        /// <para>异步调用 [POST] /cgi-bin/security/admin_oper_log/list 接口。</para>
+        /// <para>
+        /// REF: <br/>
+        /// <![CDATA[ https://developer.work.weixin.qq.com/document/path/100179 ]]>
+        /// </para>
+        /// </summary>
+        /// <param name="client"></param>
+        /// <param name="request"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public static async Task<Models.CgibinSecurityAdministratorOperateLogListResponse> ExecuteCgibinSecurityAdministratorOperateLogListAsync(this WechatWorkClient client, Models.CgibinSecurityAdministratorOperateLogListRequest request, CancellationToken cancellationToken = default)
+        {
+            if (client is null) throw new ArgumentNullException(nameof(client));
+            if (request is null) throw new ArgumentNullException(nameof(request));
+
+            IFlurlRequest flurlReq = client
+                .CreateFlurlRequest(request, HttpMethod.Post, "cgi-bin", "security", "admin_oper_log", "list")
+                .SetQueryParam("access_token", request.AccessToken);
+
+            return await client.SendFlurlRequestAsJsonAsync<Models.CgibinSecurityAdministratorOperateLogListResponse>(flurlReq, data: request, cancellationToken: cancellationToken).ConfigureAwait(false);
        }

        #region TrustDevice
--- a/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinSecurity/CgibinSecurityAdministratorOperateLogListRequest.cs
+++ b/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinSecurity/CgibinSecurityAdministratorOperateLogListRequest.cs
@@ -0,0 +1,50 @@
+namespace SKIT.FlurlHttpClient.Wechat.Work.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /cgi-bin/security/admin_oper_log/list 接口的请求。</para>
+    /// </summary>
+    public class CgibinSecurityAdministratorOperateLogListRequest : WechatWorkRequest
+    {
+        /// <summary>
+        /// 获取或设置开始时间戳。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("start_time")]
+        [System.Text.Json.Serialization.JsonPropertyName("start_time")]
+        public long StartTimestamp { get; set; }
+
+        /// <summary>
+        /// 获取或设置结束时间戳。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("end_time")]
+        [System.Text.Json.Serialization.JsonPropertyName("end_time")]
+        public long EndTimestamp { get; set; }
+
+        /// <summary>
+        /// 获取或设置操作者 UserId。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("userid")]
+        [System.Text.Json.Serialization.JsonPropertyName("userid")]
+        public string? UserId { get; set; }
+
+        /// <summary>
+        /// 获取或设置操作类型。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("oper_type")]
+        [System.Text.Json.Serialization.JsonPropertyName("oper_type")]
+        public int? OperateType { get; set; }
+
+        /// <summary>
+        /// 获取或设置分页每页数量。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("limit")]
+        [System.Text.Json.Serialization.JsonPropertyName("limit")]
+        public int? Limit { get; set; }
+
+        /// <summary>
+        /// 获取或设置翻页标记。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("cursor")]
+        [System.Text.Json.Serialization.JsonPropertyName("cursor")]
+        public string? Cursor { get; set; }
+    }
+}
--- a/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinSecurity/CgibinSecurityAdministratorOperateLogListResponse.cs
+++ b/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinSecurity/CgibinSecurityAdministratorOperateLogListResponse.cs
@@ -0,0 +1,77 @@
+namespace SKIT.FlurlHttpClient.Wechat.Work.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /cgi-bin/security/admin_oper_log/list 接口的响应。</para>
+    /// </summary>
+    public class CgibinSecurityAdministratorOperateLogListResponse : WechatWorkResponse
+    {
+        public static class Types
+        {
+            public class Record
+            {
+                /// <summary>
+                /// 获取或设置操作者 UserId。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("userid")]
+                [System.Text.Json.Serialization.JsonPropertyName("userid")]
+                public string UserId { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置操作类型。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("oper_type")]
+                [System.Text.Json.Serialization.JsonPropertyName("oper_type")]
+                public int OperateType { get; set; }
+
+                /// <summary>
+                /// 获取或设置时间戳。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("time")]
+                [System.Text.Json.Serialization.JsonPropertyName("time")]
+                public long Timestamp { get; set; }
+
+                /// <summary>
+                /// 获取或设置操作行为类型。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("detail_type")]
+                [System.Text.Json.Serialization.JsonPropertyName("detail_type")]
+                public int DetailType { get; set; }
+
+                /// <summary>
+                /// 获取或设置相关数据。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("detail_info")]
+                [System.Text.Json.Serialization.JsonPropertyName("detail_info")]
+                public string? DetailInfo { get; set; }
+
+                /// <summary>
+                /// 获取或设置操作者 IP。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("ip")]
+                [System.Text.Json.Serialization.JsonPropertyName("ip")]
+                public string? Ip { get; set; }
+            }
+        }
+
+        /// <summary>
+        /// 获取或设置操作记录列表。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("record_list")]
+        [System.Text.Json.Serialization.JsonPropertyName("record_list")]
+        public Types.Record[] RecordList { get; set; } = default!;
+
+        /// <summary>
+        /// 获取或设置是否还有更多数据。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("has_more")]
+        [System.Text.Json.Serialization.JsonPropertyName("has_more")]
+        public bool HasMore { get; set; }
+
+        /// <summary>
+        /// 获取或设置翻页标记。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("next_cursor")]
+        [System.Text.Json.Serialization.JsonPropertyName("next_cursor")]
+        public string? NextCursor { get; set; }
+    }
+}
--- a/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinSecurity/CgibinSecurityGetScreenOperateRecordRequest.cs
+++ b/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinSecurity/CgibinSecurityGetScreenOperateRecordRequest.cs
@@ -0,0 +1,59 @@
+using System.Collections.Generic;
+
+namespace SKIT.FlurlHttpClient.Wechat.Work.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /cgi-bin/security/get_screen_oper_record 接口的请求。</para>
+    /// </summary>
+    public class CgibinSecurityGetScreenOperateRecordRequest : WechatWorkRequest
+    {
+        /// <summary>
+        /// 获取或设置开始时间戳。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("start_time")]
+        [System.Text.Json.Serialization.JsonPropertyName("start_time")]
+        public long StartTimestamp { get; set; }
+
+        /// <summary>
+        /// 获取或设置结束时间戳。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("end_time")]
+        [System.Text.Json.Serialization.JsonPropertyName("end_time")]
+        public long EndTimestamp { get; set; }
+
+        /// <summary>
+        /// 获取或设置操作者 UserId 列表。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("userid_list")]
+        [System.Text.Json.Serialization.JsonPropertyName("userid_list")]
+        public IList<string>? UserIdList { get; set; }
+
+        /// <summary>
+        /// 获取或设置操作者部门 ID 列表。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("department_id_list")]
+        [System.Text.Json.Serialization.JsonPropertyName("department_id_list")]
+        public IList<long>? DepartmentIdList { get; set; }
+
+        /// <summary>
+        /// 获取或设置截屏内容类型。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("screen_shot_type")]
+        [System.Text.Json.Serialization.JsonPropertyName("screen_shot_type")]
+        public int? ScreenshotType { get; set; }
+
+        /// <summary>
+        /// 获取或设置分页每页数量。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("limit")]
+        [System.Text.Json.Serialization.JsonPropertyName("limit")]
+        public int? Limit { get; set; }
+
+        /// <summary>
+        /// 获取或设置翻页标记。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("cursor")]
+        [System.Text.Json.Serialization.JsonPropertyName("cursor")]
+        public string? Cursor { get; set; }
+    }
+}
--- a/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinSecurity/CgibinSecurityGetScreenOperateRecordResponse.cs
+++ b/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinSecurity/CgibinSecurityGetScreenOperateRecordResponse.cs
@@ -0,0 +1,77 @@
+namespace SKIT.FlurlHttpClient.Wechat.Work.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /cgi-bin/security/get_screen_oper_record 接口的响应。</para>
+    /// </summary>
+    public class CgibinSecurityGetScreenOperateRecordResponse : WechatWorkResponse
+    {
+        public static class Types
+        {
+            public class Record
+            {
+                /// <summary>
+                /// 获取或设置操作者 UserId。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("userid")]
+                [System.Text.Json.Serialization.JsonPropertyName("userid")]
+                public string UserId { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置操作者部门 ID。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("department_id")]
+                [System.Text.Json.Serialization.JsonPropertyName("department_id")]
+                public long DepartmentId { get; set; }
+
+                /// <summary>
+                /// 获取或设置截屏内容类型。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("screen_shot_type")]
+                [System.Text.Json.Serialization.JsonPropertyName("screen_shot_type")]
+                public int ScreenshotType { get; set; }
+
+                /// <summary>
+                /// 获取或设置截屏内容。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("screen_shot_content")]
+                [System.Text.Json.Serialization.JsonPropertyName("screen_shot_content")]
+                public string ScreenshotContent { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置时间戳。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("time")]
+                [System.Text.Json.Serialization.JsonPropertyName("time")]
+                public long Timestamp { get; set; }
+
+                /// <summary>
+                /// 获取或设置用户的操作系统。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("system")]
+                [System.Text.Json.Serialization.JsonPropertyName("system")]
+                public string? System { get; set; }
+            }
+        }
+
+        /// <summary>
+        /// 获取或设置操作记录列表。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("record_list")]
+        [System.Text.Json.Serialization.JsonPropertyName("record_list")]
+        public Types.Record[] RecordList { get; set; } = default!;
+
+        /// <summary>
+        /// 获取或设置是否还有更多数据。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("has_more")]
+        [System.Text.Json.Serialization.JsonPropertyName("has_more")]
+        public bool HasMore { get; set; }
+
+        /// <summary>
+        /// 获取或设置翻页标记。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("next_cursor")]
+        [System.Text.Json.Serialization.JsonPropertyName("next_cursor")]
+        public string? NextCursor { get; set; }
+    }
+}
--- a/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinSecurity/CgibinSecurityMemberOperateLogListRequest.cs
+++ b/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinSecurity/CgibinSecurityMemberOperateLogListRequest.cs
@@ -0,0 +1,50 @@
+namespace SKIT.FlurlHttpClient.Wechat.Work.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /cgi-bin/security/member_oper_log/list 接口的请求。</para>
+    /// </summary>
+    public class CgibinSecurityMemberOperateLogListRequest : WechatWorkRequest
+    {
+        /// <summary>
+        /// 获取或设置开始时间戳。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("start_time")]
+        [System.Text.Json.Serialization.JsonPropertyName("start_time")]
+        public long StartTimestamp { get; set; }
+
+        /// <summary>
+        /// 获取或设置结束时间戳。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("end_time")]
+        [System.Text.Json.Serialization.JsonPropertyName("end_time")]
+        public long EndTimestamp { get; set; }
+
+        /// <summary>
+        /// 获取或设置操作者 UserId。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("userid")]
+        [System.Text.Json.Serialization.JsonPropertyName("userid")]
+        public string? UserId { get; set; }
+
+        /// <summary>
+        /// 获取或设置操作类型。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("oper_type")]
+        [System.Text.Json.Serialization.JsonPropertyName("oper_type")]
+        public int? OperateType { get; set; }
+
+        /// <summary>
+        /// 获取或设置分页每页数量。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("limit")]
+        [System.Text.Json.Serialization.JsonPropertyName("limit")]
+        public int? Limit { get; set; }
+
+        /// <summary>
+        /// 获取或设置翻页标记。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("cursor")]
+        [System.Text.Json.Serialization.JsonPropertyName("cursor")]
+        public string? Cursor { get; set; }
+    }
+}
--- a/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinSecurity/CgibinSecurityMemberOperateLogListResponse.cs
+++ b/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinSecurity/CgibinSecurityMemberOperateLogListResponse.cs
@@ -0,0 +1,70 @@
+namespace SKIT.FlurlHttpClient.Wechat.Work.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /cgi-bin/security/member_oper_log/list 接口的响应。</para>
+    /// </summary>
+    public class CgibinSecurityMemberOperateLogListResponse : WechatWorkResponse
+    {
+        public static class Types
+        {
+            public class Record
+            {
+                /// <summary>
+                /// 获取或设置操作者 UserId。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("userid")]
+                [System.Text.Json.Serialization.JsonPropertyName("userid")]
+                public string UserId { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置操作类型。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("oper_type")]
+                [System.Text.Json.Serialization.JsonPropertyName("oper_type")]
+                public int OperateType { get; set; }
+
+                /// <summary>
+                /// 获取或设置时间戳。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("time")]
+                [System.Text.Json.Serialization.JsonPropertyName("time")]
+                public long Timestamp { get; set; }
+
+                /// <summary>
+                /// 获取或设置相关数据。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("detail_info")]
+                [System.Text.Json.Serialization.JsonPropertyName("detail_info")]
+                public string? DetailInfo { get; set; }
+
+                /// <summary>
+                /// 获取或设置操作者 IP。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("ip")]
+                [System.Text.Json.Serialization.JsonPropertyName("ip")]
+                public string? Ip { get; set; }
+            }
+        }
+
+        /// <summary>
+        /// 获取或设置操作记录列表。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("record_list")]
+        [System.Text.Json.Serialization.JsonPropertyName("record_list")]
+        public Types.Record[] RecordList { get; set; } = default!;
+
+        /// <summary>
+        /// 获取或设置是否还有更多数据。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("has_more")]
+        [System.Text.Json.Serialization.JsonPropertyName("has_more")]
+        public bool HasMore { get; set; }
+
+        /// <summary>
+        /// 获取或设置翻页标记。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("next_cursor")]
+        [System.Text.Json.Serialization.JsonPropertyName("next_cursor")]
+        public string? NextCursor { get; set; }
+    }
+}