feat(work): 新增代开发应用 ExternalUserId 转换接口

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

@@ -283,6 +283,26 @@ namespace SKIT.FlurlHttpClient.Wechat.Work
             return await client.SendRequestWithJsonAsync<Models.CgibinExternalContactOpenGroupIdToChatIdResponse>(flurlReq, data: request, cancellationToken: cancellationToken);
         }
 
+        /// <summary>
+        /// <para>异步调用 [POST] /cgi-bin/externalcontact/to_service_external_userid 接口。</para>
+        /// <para>REF: https://open.work.weixin.qq.com/api/doc/90001/90143/95195 </para>
+        /// </summary>
+        /// <param name="client"></param>
+        /// <param name="request"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public static async Task<Models.CgibinExternalContactToServiceExternalUserIdResponse> ExecuteCgibinExternalContactToServiceExternalUserIdAsync(this WechatWorkClient client, Models.CgibinExternalContactToServiceExternalUserIdRequest 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", "externalcontact", "to_service_external_userid")
+                .SetQueryParam("access_token", request.AccessToken);
+
+            return await client.SendRequestWithJsonAsync<Models.CgibinExternalContactToServiceExternalUserIdResponse>(flurlReq, data: request, cancellationToken: cancellationToken);
+        }
+
         #region ContactWay
         /// <summary>
         /// <para>异步调用 [POST] /cgi-bin/externalcontact/add_contact_way 接口。</para>

src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinExternalContact/CgibinExternalContactToServiceExternalUserIdRequest.cs

@@ -0,0 +1,15 @@
+namespace SKIT.FlurlHttpClient.Wechat.Work.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /cgi-bin/externalcontact/to_service_external_userid 接口的请求。</para>
+    /// </summary>
+    public class CgibinExternalContactToServiceExternalUserIdRequest : WechatWorkRequest
+    {
+        /// <summary>
+        /// 获取或设置代开发自建应用的外部联系人账号。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("external_userid")]
+        [System.Text.Json.Serialization.JsonPropertyName("external_userid")]
+        public string ExternalUserId { get; set; } = string.Empty;
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinExternalContact/CgibinExternalContactToServiceExternalUserIdResponse.cs

@@ -0,0 +1,15 @@
+namespace SKIT.FlurlHttpClient.Wechat.Work.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /cgi-bin/externalcontact/to_service_external_userid 接口的响应。</para>
+    /// </summary>
+    public class CgibinExternalContactToServiceExternalUserIdResponse : WechatWorkResponse
+    {
+        /// <summary>
+        /// 获取或设置第三方应用的外部联系人账号。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("external_userid")]
+        [System.Text.Json.Serialization.JsonPropertyName("external_userid")]
+        public string ExternalUserId { get; set; } = default!;
+    }
+}

test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/CgibinExternalContact/CgibinExternalContactToServiceExternalUserIdRequest.json

@@ -0,0 +1,3 @@
+{
+    "external_userid": "wmAAAAAAA"
+}

test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/CgibinExternalContact/CgibinExternalContactToServiceExternalUserIdResponse.json

@@ -0,0 +1,5 @@
+{
+    "errcode": 0,
+    "errmsg": "ok",
+    "external_userid": "ooAAAAAAAAAAA"
+}