feat(douyinopen): 新增获取用户唯一标识接口

Author: fudiwei

src/SKIT.FlurlHttpClient.ByteDance.DouyinOpen/Extensions/DouyinOpenClientExecuteApiDouyinAuthExtensions.cs

@@ -8,6 +8,29 @@ namespace SKIT.FlurlHttpClient.ByteDance.DouyinOpen
 {
     public static class DouyinOpenClientExecuteApiDouyinAuthExtensions
     {
+        /// <summary>
+        /// <para>异步调用 [POST] /api/douyin/v1/auth/get_related_id/ 接口。</para>
+        /// <para>
+        /// REF: <br/>
+        /// <![CDATA[ https://developer.open-douyin.com/docs/resource/zh-CN/dop/develop/openapi/account-management/get-related-id ]]>
+        /// </para>
+        /// </summary>
+        /// <param name="client"></param>
+        /// <param name="request"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public static async Task<Models.DouyinAuthGetRelatedIdV1Response> ExecuteDouyinAuthGetRelatedIdV1Async(this DouyinOpenClient client, Models.DouyinAuthGetRelatedIdV1Request 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, "api", "douyin", "v1", "auth", "get_related_id/")
+                .WithHeader("access-token", request.AccessToken);
+
+            return await client.SendFlurlRequestAsJsonAsync<Models.DouyinAuthGetRelatedIdV1Response>(flurlReq, data: request, cancellationToken: cancellationToken).ConfigureAwait(false);
+        }
+
         /// <summary>
         /// <para>异步调用 [POST] /api/douyin/v1/auth/get_openid_by_c/ 接口。</para>
         /// <para>

src/SKIT.FlurlHttpClient.ByteDance.DouyinOpen/Models/ApiDouyinAuth/DouyinAuthGetRelatedIdV1Request.cs

@@ -0,0 +1,15 @@
+namespace SKIT.FlurlHttpClient.ByteDance.DouyinOpen.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /api/douyin/v1/auth/get_related_id/ 接口的请求。</para>
+    /// </summary>
+    public class DouyinAuthGetRelatedIdV1Request : DouyinOpenRequest
+    {
+        /// <summary>
+        /// 获取或设置用户的 OpenId。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("open_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("open_id")]
+        public string OpenId { get; set; } = string.Empty;
+    }
+}

src/SKIT.FlurlHttpClient.ByteDance.DouyinOpen/Models/ApiDouyinAuth/DouyinAuthGetRelatedIdV1Response.cs

@@ -0,0 +1,49 @@
+namespace SKIT.FlurlHttpClient.ByteDance.DouyinOpen.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /api/douyin/v1/auth/get_related_id/ 接口的响应。</para>
+    /// </summary>
+    public class DouyinAuthGetRelatedIdV1Response : DouyinOpenResponse
+    {
+        public static class Types
+        {
+            public class Data
+            {
+                /// <summary>
+                /// 获取或设置用户在相同主体下的唯一标志。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("allied_id")]
+                [System.Text.Json.Serialization.JsonPropertyName("allied_id")]
+                public string AlliedId { get; set; } = default!;
+            }
+        }
+
+        [Newtonsoft.Json.JsonProperty("err_no")]
+        [System.Text.Json.Serialization.JsonPropertyName("err_no")]
+        [System.Text.Json.Serialization.JsonNumberHandling(System.Text.Json.Serialization.JsonNumberHandling.AllowReadingFromString)]
+        public int ErrorNumber { get; set; }
+
+        [Newtonsoft.Json.JsonProperty("err_msg")]
+        [System.Text.Json.Serialization.JsonPropertyName("err_msg")]
+        public string? ErrorMessage { get; set; }
+
+        /// <summary>
+        /// 获取或设置请求唯一标识。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("log_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("log_id")]
+        public string? LogId { get; set; }
+
+        /// <summary>
+        /// 获取或设置返回数据。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("data")]
+        [System.Text.Json.Serialization.JsonPropertyName("data")]
+        public Types.Data Data { get; set; } = default!;
+
+        public override bool IsSuccessful()
+        {
+            return GetRawStatus() == 200 && ErrorNumber == 0;
+        }
+    }
+}

test/SKIT.FlurlHttpClient.ByteDance.DouyinOpen.UnitTests/ModelSamples/ApiDouyinAuth/DouyinAuthGetRelatedIdV1Request.json

@@ -0,0 +1,3 @@
+{
+    "open_id": "Cv4PoJXaTPn63rNu"
+}

test/SKIT.FlurlHttpClient.ByteDance.DouyinOpen.UnitTests/ModelSamples/ApiDouyinAuth/DouyinAuthGetRelatedIdV1Response.json

@@ -0,0 +1,8 @@
+{
+    "log_id": "202405291440576E078D8757B9",
+    "data": {
+        "allied_id": "ZsNCZC1dUR"
+    },
+    "err_no": 0,
+    "err_msg": ""
+}