feat(work): 新增 OA 导出汇报文档接口

src/SKIT.FlurlHttpClient.Wechat.Work/Extensions/WechatWorkClientExecuteCgibinOAExtensions.cs

@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Net.Http;
 using System.Threading;
 using System.Threading.Tasks;
@@ -240,6 +240,46 @@ namespace SKIT.FlurlHttpClient.Wechat.Work
 
             return await client.SendRequestWithJsonAsync<Models.CgibinOAJournalGetStatListResponse>(flurlReq, data: request, cancellationToken: cancellationToken);
         }
+
+        /// <summary>
+        /// <para>异步调用 [POST] /cgi-bin/oa/journal/export_doc 接口。</para>
+        /// <para>REF: https://developer.work.weixin.qq.com/document/path/96108 </para>
+        /// </summary>
+        /// <param name="client"></param>
+        /// <param name="request"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public static async Task<Models.CgibinOAJournalExportDocumentResponse> ExecuteCgibinOAJournalExportDocumentAsync(this WechatWorkClient client, Models.CgibinOAJournalExportDocumentRequest 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
+                .CreateRequest(request, HttpMethod.Post, "cgi-bin", "oa", "journal", "export_doc")
+                .SetQueryParam("access_token", request.AccessToken);
+
+            return await client.SendRequestWithJsonAsync<Models.CgibinOAJournalExportDocumentResponse>(flurlReq, data: request, cancellationToken: cancellationToken);
+        }
+
+        /// <summary>
+        /// <para>异步调用 [POST] /cgi-bin/oa/journal/get_export_doc_result 接口。</para>
+        /// <para>REF: https://developer.work.weixin.qq.com/document/path/96108 </para>
+        /// </summary>
+        /// <param name="client"></param>
+        /// <param name="request"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public static async Task<Models.CgibinOAJournalGetExportDocumentResultResponse> ExecuteCgibinOAJournalGetExportDocumentResultAsync(this WechatWorkClient client, Models.CgibinOAJournalGetExportDocumentResultRequest 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
+                .CreateRequest(request, HttpMethod.Post, "cgi-bin", "oa", "journal", "get_export_doc_result")
+                .SetQueryParam("access_token", request.AccessToken);
+
+            return await client.SendRequestWithJsonAsync<Models.CgibinOAJournalGetExportDocumentResultResponse>(flurlReq, data: request, cancellationToken: cancellationToken);
+        }
         #endregion
 
         #region MeetingRoom

src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinOA/Journal/CgibinOAJournalExportDocumentRequest.cs

@@ -0,0 +1,22 @@
+namespace SKIT.FlurlHttpClient.Wechat.Work.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /cgi-bin/oa/journal/export_doc 接口的请求。</para>
+    /// </summary>
+    public class CgibinOAJournalExportDocumentRequest : WechatWorkRequest
+    {
+        /// <summary>
+        /// 获取或设置汇报 UUID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("journaluuid")]
+        [System.Text.Json.Serialization.JsonPropertyName("journaluuid")]
+        public string JournalId { get; set; } = string.Empty;
+
+        /// <summary>
+        /// 获取或设置文档 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("docid")]
+        [System.Text.Json.Serialization.JsonPropertyName("docid")]
+        public string DocumentId { get; set; } = string.Empty;
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinOA/Journal/CgibinOAJournalExportDocumentResponse.cs

@@ -0,0 +1,15 @@
+namespace SKIT.FlurlHttpClient.Wechat.Work.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /cgi-bin/oa/journal/export_doc 接口的响应。</para>
+    /// </summary>
+    public class CgibinOAJournalExportDocumentResponse : WechatWorkResponse
+    {
+        /// <summary>
+        /// 获取或设置导出任务 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("jobid")]
+        [System.Text.Json.Serialization.JsonPropertyName("jobid")]
+        public string JobId { get; set; } = default!;
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinOA/Journal/CgibinOAJournalGetExportDocumentResultRequest.cs

@@ -0,0 +1,15 @@
+namespace SKIT.FlurlHttpClient.Wechat.Work.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /cgi-bin/oa/journal/get_export_doc_result 接口的请求。</para>
+    /// </summary>
+    public class CgibinOAJournalGetExportDocumentResultRequest : WechatWorkRequest
+    {
+        /// <summary>
+        /// 获取或设置导出任务 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("jobid")]
+        [System.Text.Json.Serialization.JsonPropertyName("jobid")]
+        public string JobId { get; set; } = string.Empty;
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinOA/Journal/CgibinOAJournalGetExportDocumentResultResponse.cs

@@ -0,0 +1,22 @@
+namespace SKIT.FlurlHttpClient.Wechat.Work.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /cgi-bin/oa/journal/get_export_doc_result 接口的响应。</para>
+    /// </summary>
+    public class CgibinOAJournalGetExportDocumentResultResponse : WechatWorkResponse
+    {
+        /// <summary>
+        /// 获取或设置任务状态。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("status")]
+        [System.Text.Json.Serialization.JsonPropertyName("status")]
+        public int Status { get; set; }
+
+        /// <summary>
+        /// 获取或设置文档临时下载链接。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("url")]
+        [System.Text.Json.Serialization.JsonPropertyName("url")]
+        public string? Url { get; set; }
+    }
+}

test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/CgibinOA/Journal/CgibinOAJournalExportDocumentRequest.json

@@ -0,0 +1,4 @@
+{
+    "journaluuid": "JOURNAL_UUID",
+    "docid": "DOCID"
+}

test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/CgibinOA/Journal/CgibinOAJournalExportDocumentResponse.json

@@ -0,0 +1,5 @@
+{
+    "errcode": 0,
+    "errmsg": "ok",
+    "jobid": "JOBID"
+}

test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/CgibinOA/Journal/CgibinOAJournalGetExportDocumentResultRequest.json

@@ -0,0 +1,3 @@
+{
+    "jobid": "JOBID"
+}

test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/CgibinOA/Journal/CgibinOAJournalGetExportDocumentResultResponse.json

@@ -0,0 +1,6 @@
+{
+    "errcode": 0,
+    "errmsg": "ok",
+    "status": 2,
+    "url": "URL"
+}