feat(work): 新增获取家校访问用户身份接口

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

@@ -91,6 +91,27 @@ namespace SKIT.FlurlHttpClient.Wechat.Work
             return await client.SendRequestWithJsonAsync<Models.CgibinSchoolSetUpgradeInfoResponse>(flurlReq, data: request, cancellationToken: cancellationToken);
         }
 
+        /// <summary>
+        /// <para>异步调用 [GET] /cgi-bin/school/getuserinfo 接口。</para>
+        /// <para>REF: https://developer.work.weixin.qq.com/document/path/95791 </para>
+        /// </summary>
+        /// <param name="client"></param>
+        /// <param name="request"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public static async Task<Models.CgibinSchoolGetUserInfoResponse> ExecuteCgibinSchoolGetUserInfoAsync(this WechatWorkClient client, Models.CgibinSchoolGetUserInfoRequest 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.Get, "cgi-bin", "school", "getuserinfo")
+                .SetQueryParam("access_token", request.AccessToken)
+                .SetQueryParam("code", request.Code);
+
+            return await client.SendRequestWithJsonAsync<Models.CgibinSchoolGetUserInfoResponse>(flurlReq, data: request, cancellationToken: cancellationToken);
+        }
+
         #region User
         /// <summary>
         /// <para>异步调用 [GET] /cgi-bin/school/user/get 接口。</para>

src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinSchool/CgibinSchoolGetUserInfoRequest.cs

@@ -0,0 +1,15 @@
+namespace SKIT.FlurlHttpClient.Wechat.Work.Models
+{
+    /// <summary>
+    /// <para>表示 [GET] /cgi-bin/school/getuserinfo 接口的请求。</para>
+    /// </summary>
+    public class CgibinSchoolGetUserInfoRequest : WechatWorkRequest
+    {
+        /// <summary>
+        /// 获取或设置成员授权码。
+        /// </summary>
+        [Newtonsoft.Json.JsonIgnore]
+        [System.Text.Json.Serialization.JsonIgnore]
+        public string Code { get; set; } = string.Empty;
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinSchool/CgibinSchoolGetUserInfoResponse.cs

@@ -0,0 +1,29 @@
+namespace SKIT.FlurlHttpClient.Wechat.Work.Models
+{
+    /// <summary>
+    /// <para>表示 [GET] /cgi-bin/school/getuserinfo 接口的响应。</para>
+    /// </summary>
+    public class CgibinSchoolGetUserInfoResponse : WechatWorkResponse
+    {
+        /// <summary>
+        /// 获取或设置手机设备号。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("DeviceId")]
+        [System.Text.Json.Serialization.JsonPropertyName("DeviceId")]
+        public string? DeviceId { get; set; }
+
+        /// <summary>
+        /// 获取或设置家长账号。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("parent_userid")]
+        [System.Text.Json.Serialization.JsonPropertyName("parent_userid")]
+        public string? ParentUserId{ get; set; }
+
+        /// <summary>
+        /// 获取或设置学生账号。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("student_userid")]
+        [System.Text.Json.Serialization.JsonPropertyName("student_userid")]
+        public string? StudentUserId{ get; set; }
+    }
+}

test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/CgibinSchool/CgibinSchoolGetUserInfoResponse.json

@@ -0,0 +1,7 @@
+{
+    "errcode": 0,
+    "errmsg": "ok",
+    "DeviceId": "DEVICEID",
+    "parent_userid": "parent_userid",
+    "student_userid": "student_userid"
+}