From 49f6172f61523d833f91bdcecedc42fcf6120604 Mon Sep 17 00:00:00 2001
From: Fu Diwei <fudiwei@sina.com>
Date: Mon, 13 Oct 2025 20:39:12 +0800
Subject: [PATCH] =?UTF-8?q?feat(work):=20=E6=96=B0=E5=A2=9E=E9=80=9A?=
 =?UTF-8?q?=E8=BF=87=E9=82=AE=E7=AE=B1=E8=8E=B7=E5=8F=96=20UserId=20?=
 =?UTF-8?q?=E6=8E=A5=E5=8F=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...atWorkClientExecuteCgibinUserExtensions.cs | 23 +++++++++++++++++++
 .../CgibinUserGetUserIdByEmailRequest.cs      | 22 ++++++++++++++++++
 .../CgibinUserGetUserIdByEmailResponse.cs     |  9 ++++++++
 .../CgibinUserGetUserIdByEmailRequest.json    |  4 ++++
 .../CgibinUserGetUserIdByEmailResponse.json   |  5 ++++
 5 files changed, 63 insertions(+)
 create mode 100644 src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinUser/CgibinUserGetUserIdByEmailRequest.cs
 create mode 100644 src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinUser/CgibinUserGetUserIdByEmailResponse.cs
 create mode 100644 test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/_/CgibinUser/CgibinUserGetUserIdByEmailRequest.json
 create mode 100644 test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/_/CgibinUser/CgibinUserGetUserIdByEmailResponse.json

diff --git a/src/SKIT.FlurlHttpClient.Wechat.Work/Extensions/WechatWorkClientExecuteCgibinUserExtensions.cs b/src/SKIT.FlurlHttpClient.Wechat.Work/Extensions/WechatWorkClientExecuteCgibinUserExtensions.cs
index abc1adb1..91e4f56d 100644
--- a/src/SKIT.FlurlHttpClient.Wechat.Work/Extensions/WechatWorkClientExecuteCgibinUserExtensions.cs
+++ b/src/SKIT.FlurlHttpClient.Wechat.Work/Extensions/WechatWorkClientExecuteCgibinUserExtensions.cs
@@ -290,6 +290,29 @@ namespace SKIT.FlurlHttpClient.Wechat.Work
             return await client.SendFlurlRequestAsJsonAsync<Models.CgibinUserGetUserIdResponse>(flurlReq, data: request, cancellationToken: cancellationToken).ConfigureAwait(false);
         }
 
+        /// <summary>
+        /// <para>异步调用 [POST] /cgi-bin/user/get_userid_by_email 接口。</para>
+        /// <para>
+        /// REF: <br/>
+        /// <![CDATA[ https://developer.work.weixin.qq.com/document/path/95895 ]]>
+        /// </para>
+        /// </summary>
+        /// <param name="client"></param>
+        /// <param name="request"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public static async Task<Models.CgibinUserGetUserIdByEmailResponse> ExecuteCgibinUserGetUserIdByEmailAsync(this WechatWorkClient client, Models.CgibinUserGetUserIdByEmailRequest 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", "user", "get_userid_by_email")
+                .SetQueryParam("access_token", request.AccessToken);
+
+            return await client.SendFlurlRequestAsJsonAsync<Models.CgibinUserGetUserIdByEmailResponse>(flurlReq, data: request, cancellationToken: cancellationToken).ConfigureAwait(false);
+        }
+
         /// <summary>
         /// <para>异步调用 [POST] /cgi-bin/user/get_active_stat 接口。</para>
         /// <para>
diff --git a/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinUser/CgibinUserGetUserIdByEmailRequest.cs b/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinUser/CgibinUserGetUserIdByEmailRequest.cs
new file mode 100644
index 00000000..c83807eb
--- /dev/null
+++ b/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinUser/CgibinUserGetUserIdByEmailRequest.cs
@@ -0,0 +1,22 @@
+namespace SKIT.FlurlHttpClient.Wechat.Work.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /cgi-bin/user/get_userid_by_email 接口的请求。</para>
+    /// </summary>
+    public class CgibinUserGetUserIdByEmailRequest : WechatWorkRequest
+    {
+        /// <summary>
+        /// 获取或设置邮箱类型。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("email_type")]
+        [System.Text.Json.Serialization.JsonPropertyName("email_type")]
+        public int? EmailType { get; set; }
+
+        /// <summary>
+        /// 获取或设置邮箱。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("email")]
+        [System.Text.Json.Serialization.JsonPropertyName("email")]
+        public string Email { get; set; } = string.Empty;
+    }
+}
diff --git a/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinUser/CgibinUserGetUserIdByEmailResponse.cs b/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinUser/CgibinUserGetUserIdByEmailResponse.cs
new file mode 100644
index 00000000..c969afa7
--- /dev/null
+++ b/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinUser/CgibinUserGetUserIdByEmailResponse.cs
@@ -0,0 +1,9 @@
+namespace SKIT.FlurlHttpClient.Wechat.Work.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /cgi-bin/user/get_userid_by_email 接口的响应。</para>
+    /// </summary>
+    public class CgibinUserGetUserIdByEmailResponse : CgibinUserGetUserIdResponse
+    {
+    }
+}
diff --git a/test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/_/CgibinUser/CgibinUserGetUserIdByEmailRequest.json b/test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/_/CgibinUser/CgibinUserGetUserIdByEmailRequest.json
new file mode 100644
index 00000000..fa0c0733
--- /dev/null
+++ b/test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/_/CgibinUser/CgibinUserGetUserIdByEmailRequest.json
@@ -0,0 +1,4 @@
+{
+    "email": "12345@qq.com",
+    "email_type": 1
+}
diff --git a/test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/_/CgibinUser/CgibinUserGetUserIdByEmailResponse.json b/test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/_/CgibinUser/CgibinUserGetUserIdByEmailResponse.json
new file mode 100644
index 00000000..ff1d3f00
--- /dev/null
+++ b/test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/_/CgibinUser/CgibinUserGetUserIdByEmailResponse.json
@@ -0,0 +1,5 @@
+{
+    "errcode": 0,
+    "errmsg": "ok",
+    "userid": "zhangsan"
+}