feat(wxapi): 新增微信小店达人推广商品相关接口

Author: fudiwei

src/SKIT.FlurlHttpClient.Wechat.Api/Events/Channels/EC/ChannelsECHeadSupplierItemUpdateEvent.cs

@@ -4,7 +4,7 @@ namespace SKIT.FlurlHttpClient.Wechat.Api.Events
     /// <para>表示 EVENT.head_supplier_item_update 事件的数据。</para>
     /// <para>
     /// REF: <br/>
-    /// <![CDATA[ https://developers.weixin.qq.com/doc/channels/API/leagueheadsupplier/callback/head_supplier_item_update.html ]]>
+    /// <![CDATA[ https://developers.weixin.qq.com/doc/store/leagueheadsupplier/API/callback/head_supplier_item_update.html ]]>
     /// </para>
     /// </summary>
     public class ChannelsECHeadSupplierItemUpdateEvent : WechatApiEvent

src/SKIT.FlurlHttpClient.Wechat.Api/Extensions/WechatApiClientExecuteChannelsExtensions.cs

@@ -0,0 +1,24 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /channels/ec/league/headsupplier/cooperativeitem/add 接口的请求。</para>
+    /// </summary>
+    public class ChannelsECLeagueHeadSupplierCooperativeItemAddRequest : WechatApiRequest, IInferable<ChannelsECLeagueHeadSupplierCooperativeItemAddRequest, ChannelsECLeagueHeadSupplierCooperativeItemAddResponse>
+    {
+        /// <summary>
+        /// 获取或设置机构推广商品链接。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("head_supplier_item_link")]
+        [System.Text.Json.Serialization.JsonPropertyName("head_supplier_item_link")]
+        public string HeadSupplierItemLink { get; set; } = string.Empty;
+
+        /// <summary>
+        /// 获取或设置是否隐藏。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("hidden_flag")]
+        [Newtonsoft.Json.JsonConverter(typeof(Newtonsoft.Json.Converters.Common.NumericalBooleanConverter))]
+        [System.Text.Json.Serialization.JsonPropertyName("hidden_flag")]
+        [System.Text.Json.Serialization.JsonConverter(typeof(System.Text.Json.Serialization.Common.NumericalBooleanConverter))]
+        public bool? IsHidden { get; set; }
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Channels/ECLeague/HeadSupplier/CooperativeItem/ChannelsECLeagueHeadSupplierCooperativeItemAddRequest.cs

@@ -0,0 +1,9 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /channels/ec/league/headsupplier/cooperativeitem/add 接口的响应。</para>
+    /// </summary>
+    public class ChannelsECLeagueHeadSupplierCooperativeItemAddResponse : WechatApiResponse
+    {
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Channels/ECLeague/HeadSupplier/CooperativeItem/ChannelsECLeagueHeadSupplierCooperativeItemAddResponse.cs

@@ -0,0 +1,30 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /channels/ec/league/headsupplier/cooperativeitem/list/get 接口的请求。</para>
+    /// </summary>
+    public class ChannelsECLeagueHeadSupplierCooperativeItemListGetRequest : WechatApiRequest, IInferable<ChannelsECLeagueHeadSupplierCooperativeItemListGetRequest, ChannelsECLeagueHeadSupplierCooperativeItemListGetResponse>
+    {
+        /// <summary>
+        /// 获取或设置佣金分配类型。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("commission_type")]
+        [System.Text.Json.Serialization.JsonPropertyName("commission_type")]
+        public int CommissionType { get; set; }
+
+        /// <summary>
+        /// 获取或设置分页每页数量。
+        /// <para>默认值：10</para>
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("page_size")]
+        [System.Text.Json.Serialization.JsonPropertyName("page_size")]
+        public int Limit { get; set; } = 10;
+
+        /// <summary>
+        /// 获取或设置翻页标记。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("next_key")]
+        [System.Text.Json.Serialization.JsonPropertyName("next_key")]
+        public string? Cursor { get; set; }
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Channels/ECLeague/HeadSupplier/CooperativeItem/ChannelsECLeagueHeadSupplierCooperativeItemListGetRequest.cs

@@ -0,0 +1,50 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /channels/ec/league/headsupplier/cooperativeitem/list/get 接口的响应。</para>
+    /// </summary>
+    public class ChannelsECLeagueHeadSupplierCooperativeItemListGetResponse : WechatApiResponse
+    {
+        public static class Types
+        {
+            public class CooperativeItem
+            {
+                /// <summary>
+                /// 获取或设置合作商品 ID。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("product_id")]
+                [System.Text.Json.Serialization.JsonPropertyName("product_id")]
+                [System.Text.Json.Serialization.JsonNumberHandling(System.Text.Json.Serialization.JsonNumberHandling.AllowReadingFromString)]
+                public long CooperativeItemId { get; set; }
+
+                /// <summary>
+                /// 获取或设置合作计划 ID。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("id")]
+                [System.Text.Json.Serialization.JsonPropertyName("id")]
+                public long PlanId { get; set; }
+
+                /// <summary>
+                /// 获取或设置计划链接。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("head_supplier_item_link")]
+                [System.Text.Json.Serialization.JsonPropertyName("head_supplier_item_link")]
+                public string HeadSupplierItemLink { get; set; } = default!;
+            }
+        }
+
+        /// <summary>
+        /// 获取或设置合作商品列表。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("list")]
+        [System.Text.Json.Serialization.JsonPropertyName("list")]
+        public Types.CooperativeItem[] CooperativeItemList { get; set; } = default!;
+
+        /// <summary>
+        /// 获取或设置翻页标记。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("next_key")]
+        [System.Text.Json.Serialization.JsonPropertyName("next_key")]
+        public string? NextCursor { get; set; }
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Channels/ECLeague/HeadSupplier/CooperativeItem/ChannelsECLeagueHeadSupplierCooperativeItemListGetResponse.cs

@@ -13,9 +13,9 @@ public class Product
             {
                 public static class Types
                 {
-                    public class ProductInfo : ChannelsECLeagueHeadSupplierWindowGetDetailResponse.Types.Product.Types.ProductInfo
+                    public class ProductInfo
                     {
-                        public static new class Types
+                        public static class Types
                         {
                             public class Detail : ChannelsECLeagueHeadSupplierWindowGetDetailResponse.Types.Product.Types.ProductInfo.Types.Detail
                             {
@@ -26,27 +26,48 @@ public class Category : ChannelsECLeagueHeadSupplierWindowGetDetailResponse.Type
                             }
                         }
 
+                        /// <summary>
+                        /// 获取或设置商品标题。
+                        /// </summary>
+                        [Newtonsoft.Json.JsonProperty("title")]
+                        [System.Text.Json.Serialization.JsonPropertyName("title")]
+                        public string Title { get; set; } = default!;
+
+                        /// <summary>
+                        /// 获取或设置商品副标题。
+                        /// </summary>
+                        [Newtonsoft.Json.JsonProperty("sub_title")]
+                        [System.Text.Json.Serialization.JsonPropertyName("sub_title")]
+                        public string? SubTitle { get; set; }
+
+                        /// <summary>
+                        /// 获取或设置主图 URL 列表。
+                        /// </summary>
+                        [Newtonsoft.Json.JsonProperty("head_imgs")]
+                        [System.Text.Json.Serialization.JsonPropertyName("head_imgs")]
+                        public string[] HeadImageUrlList { get; set; } = default!;
+
                         /// <summary>
                         /// 获取或设置商品详情信息。
                         /// </summary>
                         [Newtonsoft.Json.JsonProperty("desc_info")]
                         [System.Text.Json.Serialization.JsonPropertyName("desc_info")]
-                        public new Types.Detail Detail { get; set; } = default!;
+                        public Types.Detail Detail { get; set; } = default!;
 
                         /// <summary>
                         /// 获取或设置商品类目列表。
                         /// </summary>
                         [Obsolete("相关接口或字段于 2024-10-28 下线。")]
                         [Newtonsoft.Json.JsonProperty("cats")]
                         [System.Text.Json.Serialization.JsonPropertyName("cats")]
-                        public new Types.Category[]? CategoryList { get; set; }
+                        public Types.Category[]? CategoryList { get; set; }
 
                         /// <summary>
                         /// 获取或设置新版商品类目列表。
                         /// </summary>
                         [Newtonsoft.Json.JsonProperty("cats_v2")]
                         [System.Text.Json.Serialization.JsonPropertyName("cats_v2")]
-                        public new Types.Category[]? CategoryV2List { get; set; }
+                        public Types.Category[]? CategoryV2List { get; set; }
                     }
                 }
 

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Channels/ECLeague/HeadSupplier/Item/ChannelsECLeagueHeadSupplierItemGetResponse.cs

@@ -0,0 +1,15 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /channels/ec/league/headsupplier/item/promotiondetail/get 接口的请求。</para>
+    /// </summary>
+    public class ChannelsECLeagueHeadSupplierItemPromotionDetailGetRequest : WechatApiRequest, IInferable<ChannelsECLeagueHeadSupplierItemPromotionDetailGetRequest, ChannelsECLeagueHeadSupplierItemPromotionDetailGetResponse>
+    {
+        /// <summary>
+        /// 获取或设置团长商品链接。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("head_supplier_item_link")]
+        [System.Text.Json.Serialization.JsonPropertyName("head_supplier_item_link")]
+        public string HeadSupplierItemLink { get; set; } = string.Empty;
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.Api/Models/Channels/ECLeague/HeadSupplier/Item/ChannelsECLeagueHeadSupplierItemPromotionDetailGetRequest.cs

@@ -0,0 +1,173 @@
+namespace SKIT.FlurlHttpClient.Wechat.Api.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /channels/ec/league/headsupplier/item/promotiondetail/get 接口的响应。</para>
+    /// </summary>
+    public class ChannelsECLeagueHeadSupplierItemPromotionDetailGetResponse : WechatApiResponse
+    {
+        public static class Types
+        {
+            public class Product
+            {
+                public static class Types
+                {
+                    public class CommissionInfo
+                    {
+                        public static class Types
+                        {
+                            public class NormalCommissionInfo
+                            {
+                                /// <summary>
+                                /// 获取或设置佣金费率（单位：十万分数）。
+                                /// </summary>
+                                [Newtonsoft.Json.JsonProperty("ratio")]
+                                [System.Text.Json.Serialization.JsonPropertyName("ratio")]
+                                public int Ratio { get; set; }
+                            }
+                        }
+
+                        /// <summary>
+                        /// 获取或设置计划类型。
+                        /// </summary>
+                        [Newtonsoft.Json.JsonProperty("plan_type")]
+                        [System.Text.Json.Serialization.JsonPropertyName("plan_type")]
+                        public int PlanType { get; set; }
+
+                        /// <summary>
+                        /// 获取或设置佣金分配类型。
+                        /// </summary>
+                        [Newtonsoft.Json.JsonProperty("commission_type")]
+                        [System.Text.Json.Serialization.JsonPropertyName("commission_type")]
+                        public int CommissionType { get; set; }
+
+                        /// <summary>
+                        /// 获取或设置佣金费率（单位：十万分数）。
+                        /// </summary>
+                        [Newtonsoft.Json.JsonProperty("ratio")]
+                        [System.Text.Json.Serialization.JsonPropertyName("ratio")]
+                        public int CommissionRatio { get; set; }
+
+                        /// <summary>
+                        /// 获取或设置服务费费率（单位：十万分数）。
+                        /// </summary>
+                        [Newtonsoft.Json.JsonProperty("service_ratio")]
+                        [System.Text.Json.Serialization.JsonPropertyName("service_ratio")]
+                        public int ServiceFeeRatio { get; set; }
+
+                        /// <summary>
+                        /// 获取或设置计划开始时间戳。
+                        /// </summary>
+                        [Newtonsoft.Json.JsonProperty("start_time")]
+                        [System.Text.Json.Serialization.JsonPropertyName("start_time")]
+                        public long StartTimestamp { get; set; }
+
+                        /// <summary>
+                        /// 获取或设置计划结束时间戳。
+                        /// </summary>
+                        [Newtonsoft.Json.JsonProperty("end_time")]
+                        [System.Text.Json.Serialization.JsonPropertyName("end_time")]
+                        public long EndTimestamp { get; set; }
+
+                        /// <summary>
+                        /// 获取或设置该商品普通推广下的佣金信息。
+                        /// </summary>
+                        [Newtonsoft.Json.JsonProperty("normal_commission_info")]
+                        [System.Text.Json.Serialization.JsonPropertyName("normal_commission_info")]
+                        public Types.NormalCommissionInfo? NormalCommissionInfo { get; set; }
+                    }
+
+                    public class HeadSupplierInfo
+                    {
+                        /// <summary>
+                        /// 获取或设置团长 AppId。
+                        /// </summary>
+                        [Newtonsoft.Json.JsonProperty("appid")]
+                        [System.Text.Json.Serialization.JsonPropertyName("appid")]
+                        public string AppId { get; set; } = default!;
+
+                        /// <summary>
+                        /// 获取或设置团长名称。
+                        /// </summary>
+                        [Newtonsoft.Json.JsonProperty("name")]
+                        [System.Text.Json.Serialization.JsonPropertyName("name")]
+                        public string Name { get; set; } = default!;
+                    }
+
+                    public class CooperativeInfo
+                    {
+                        /// <summary>
+                        /// 获取或设置合作状态。
+                        /// </summary>
+                        [Newtonsoft.Json.JsonProperty("cooperative_status")]
+                        [System.Text.Json.Serialization.JsonPropertyName("cooperative_status")]
+                        public int CooperativeStatus { get; set; }
+
+                        /// <summary>
+                        /// 获取或设置是否隐藏。
+                        /// </summary>
+                        [Newtonsoft.Json.JsonProperty("is_hidden")]
+                        [System.Text.Json.Serialization.JsonPropertyName("is_hidden")]
+                        public bool IsHidden { get; set; }
+
+                        /// <summary>
+                        /// 获取或设置带货链接。
+                        /// </summary>
+                        [Newtonsoft.Json.JsonProperty("link")]
+                        [System.Text.Json.Serialization.JsonPropertyName("link")]
+                        public string? Link { get; set; }
+                    }
+                }
+
+                /// <summary>
+                /// 获取或设置小店 AppId。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("shop_appid")]
+                [System.Text.Json.Serialization.JsonPropertyName("shop_appid")]
+                public string AppId { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置商品 ID。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("product_id")]
+                [System.Text.Json.Serialization.JsonPropertyName("product_id")]
+                [System.Text.Json.Serialization.JsonNumberHandling(System.Text.Json.Serialization.JsonNumberHandling.AllowReadingFromString)]
+                public long ProductId { get; set; }
+
+                /// <summary>
+                /// 获取或设置商品来源。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("spu_source")]
+                [System.Text.Json.Serialization.JsonPropertyName("spu_source")]
+                public int SPUSource { get; set; }
+
+                /// <summary>
+                /// 获取或设置佣金信息。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("commission_info")]
+                [System.Text.Json.Serialization.JsonPropertyName("commission_info")]
+                public Types.CommissionInfo CommissionInfo { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置供货机构信息。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("head_supplier_info")]
+                [System.Text.Json.Serialization.JsonPropertyName("head_supplier_info")]
+                public Types.HeadSupplierInfo HeadSupplierInfo { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置合作信息。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("cooperative_info")]
+                [System.Text.Json.Serialization.JsonPropertyName("cooperative_info")]
+                public Types.CooperativeInfo CooperativeInfo { get; set; } = default!;
+            }
+        }
+
+        /// <summary>
+        /// 获取或设置商品信息。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("item")]
+        [System.Text.Json.Serialization.JsonPropertyName("item")]
+        public Types.Product Product { get; set; } = default!;
+    }
+}