社群
學習
工具庫
AI工具
休閒
搜尋
繁体中文
目錄
1、商品管理介面的定義
2、商品管理介面的實作
3、商品管理接口的测试
首頁 微信小程式 微信開發 C#開發微信入口網站及應用-微信小店商品管理介面的封裝與測試

C#開發微信入口網站及應用-微信小店商品管理介面的封裝與測試

高洛峰
高洛峰
Feb 18, 2017 am 09:53 AM

在上篇《C#開發微信門戶及應用(22)-微信小店的開發與使用》裡面介紹了一些微信小店的基礎知識，以及對應的對像模型，本篇繼續微信小店的主題，介紹其中API介面的封裝與測試使用。微信小店的相關物件模型，基本上包括了常規的商品、商品分組、貨架、庫存、訂單這些模型，還有商品分類，商品分類屬性、商品分類SKU、快遞郵寄模板、圖片管理等功能。本文介紹的介面封裝也就是基於這些內容進行的，並針對介面的實作進行測試和使用。

1、商品管理介面的定義

前面文章介紹了微信小店的物件模型，如下所示。

C#开发微信门户及应用-微信小店商品管理接口的封装和测试

這個圖形基本上覆蓋了微信小店的相關對象，並介紹了它們之間的關係了。

我們從基礎的商品資訊管理入手，我們知道，商品介麵包含了增加、修改、查詢、刪除等接口，如下所示。

C#开发微信门户及应用-微信小店商品管理接口的封装和测试

商品資訊是所有微店的基礎，因此對它的管理操作，我們需要更加清晰和完善。

綜上所述的功能，我們可以定義好微信商品的介面如下所示。 

        #region 商品信息        /// <summary>
        /// 创建商品        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="merchantJson">商品对象</param>
        /// <returns></returns>
        AddMerchantResult AddMerchant(string accessToken, MerchantJson merchantJson);        /// <summary>
        /// 删除商品        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="productId">商品ID</param>
        /// <returns></returns>
        CommonResult DeleteMerchant(string accessToken, string productId);        /// <summary>
        /// 修改商品        /// product_id表示要更新的商品的ID，其他字段说明请参考增加商品接口。        /// 从未上架的商品所有信息均可修改，否则商品的名称(name)、商品分类(category)、商品属性(property)这三个字段不可修改。        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="merchantJson">修改商品的信息</param>
        /// <returns></returns>
        CommonResult UpdateMerchant(string accessToken, MerchantJson merchantJson);        /// <summary>
        /// 根据ID查询商品信息，如果成功返回MerchantJson信息，否则返回null        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="productId">商品的Id</param>
        /// <returns></returns>
        MerchantJson GetMerchant(string accessToken, string productId);        /// <summary>
        /// 获取指定状态的所有商品        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="status">商品状态(0-全部, 1-上架, 2-下架)</param>
        /// <returns></returns>
        List<MerchantJson> GetMerchantByStatus(string accessToken, int status);        /// <summary>
        /// 商品上下架        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="status">商品上下架标识(0-下架, 1-上架)</param>
        /// <returns></returns>
        CommonResult UpdateMerchantStatus(string accessToken, string productId, int status); 

        #endregion
登入後複製

當然，微信的商品還包含了分類、分類屬性、分類SKU的基礎管理，因此商品管理也需要增加這個內容

C#开发微信门户及应用-微信小店商品管理接口的封装和测试

它們的功能介面定義如下所示。透過下面的接口，我們就很容易實現商品分類（不是商品分組）、SKU資訊、和分類屬性等資訊的取得操作了。 

        #region 商品分类及属性        /// <summary>
        /// 获取指定分类的所有子分类        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="cateId">大分类ID(根节点分类id为1)</param>
        /// <returns></returns>
        List<SubCategory> GetSub(string accessToken, int cate_id);        /// <summary>
        /// 获取指定子分类的所有SKU        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="cateId">商品子分类ID</param>
        /// <returns></returns>
        List<SubCategorySku> GetSku(string accessToken, int cate_id);        /// <summary>
        /// 获取指定分类的所有属性        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="cateId">分类ID</param>
        /// <returns></returns>
        List<SubCategoryProperty> GetProperty(string accessToken, int cate_id); 

        #endregion
登入後複製

 

2、商品管理介面的實作

上面的介面定義了對應商品的介面。

對於接口的實現，我們一般都是根據官方網站的接口說明，提交到那個URL，並且是POST那些數據，然後整理成一個常規的處理方式，獲得結果並轉換為對應的對象即可，如新增商品操作的實作代碼如下所示。 

        /// <summary>
        /// 创建商品        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="merchantJson">商品对象</param>
        /// <returns></returns>
        public AddMerchantResult AddMerchant(string accessToken, MerchantJson merchantJson)
        {            var url = string.Format("http://www.php.cn/{0}", accessToken);            string postData = merchantJson.ToJson();            return JsonHelper<AddMerchantResult>.ConvertJson(url, postData);
        }
登入後複製

而傳回結果，這是定義一個物件來獲得新增商品的ID等內容，如下所示。 

    /// <summary>
    /// 创建商品信息的返回结果    /// </summary>
    public class AddMerchantResult : ErrorJsonResult
    {        /// <summary>
        /// 商品ID        /// </summary>
        public string product_id { get; set; }
    }
登入後複製

而基類這是常規的響應內容

    /// <summary>
    /// 微信返回Json结果的错误数据    /// </summary>
    public class ErrorJsonResult 
    {        /// <summary>
        /// 返回代码        /// </summary>
        public ReturnCode errcode { get; set; }        /// <summary>
        /// 错误消息        /// </summary>
        public string errmsg { get; set; }
    }
登入後複製

通過這些對象的定義，添加商品後，我們就知道操作是否成功，如果添加的ID給我們使用，我們可以進行查詢具體的商品資訊或是進行修改、刪除等操作的。

而對商品資訊的修改或刪除的操作，都是傳回一個是否成功的記錄就可以了，因此我們定義了一個統一的回應對象CommonResult。商品修改、刪除的介面實作程式碼如下所示。

由於程式碼我都進行高度的完善和整​​理，對於各種處理的程式碼都相對比較容易理解的了。 

        /// <summary>
        /// 删除商品        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="productId">商品ID</param>
        /// <returns></returns>
        public CommonResult DeleteMerchant(string accessToken, string productId)
        {            var url = string.Format("http://www.php.cn/{0}", accessToken);            var data = new
            {
                product_id = productId
            };            string postData = data.ToJson();            return Helper.GetExecuteResult(url, postData);
        }        /// <summary>
        /// 修改商品        /// product_id表示要更新的商品的ID，其他字段说明请参考增加商品接口。        /// 从未上架的商品所有信息均可修改，否则商品的名称(name)、商品分类(category)、商品属性(property)这三个字段不可修改。        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="merchantJson">修改商品的信息</param>
        /// <returns></returns>
        public CommonResult UpdateMerchant(string accessToken, MerchantJson merchantJson)
        {            var url = string.Format("http://www.php.cn/{0}", accessToken);            string postData = merchantJson.ToJson();            return Helper.GetExecuteResult(url, postData);
        }
登入後複製

為了獲取商品的詳細信息，我們需要定義一個商品的實體對象，以便我們把獲取到的信息轉換為實體類信息，方便使用和處理。

商品的訊息，包含了不少細小定義的類，他們構成了商品的各個部分的內容，主體的實體類資訊如下所示。

C#开发微信门户及应用-微信小店商品管理接口的封装和测试

定義好相對比較複雜的商品資訊實體後，我們就可以透過物件處理了。

取得商品詳細資訊的實作代碼如下所示。 

        /// <summary>
        /// 根据ID查询商品信息，如果成功返回MerchantJson信息，否则返回null        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="productId">商品的Id</param>
        /// <returns></returns>
        public MerchantJson GetMerchant(string accessToken, string productId)
        {            var url = string.Format("http://www.php.cn/{0}", accessToken);            var data = new
            {
                product_id = productId
            };            string postData = data.ToJson();

            MerchantJson merchant = null;
            GetMerchantResult result = JsonHelper<GetMerchantResult>.ConvertJson(url, postData);            if (result != null)
            {
                merchant = result.product_info;
            }            return merchant;
        }
登入後複製

雖然商品的實體資訊很複雜，但是一旦我們定義好，我們就很容易對結果進行轉換並處理了，上面的程式碼並不是很難理解，主要就是提交數據後，對數據進行轉換而已。

當然，我們也可以取得不同狀態的商品清單內容，如下程式碼所示。 

        /// <summary>
        /// 获取指定状态的所有商品        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="status">商品状态(0-全部, 1-上架, 2-下架)</param>
        /// <returns></returns>
        public List<MerchantJson> GetMerchantByStatus(string accessToken, int status)
        {            var url = string.Format("http://www.php.cn/{0}", accessToken);            var data = new
            {
                status = status
            };            string postData = data.ToJson();

            List<MerchantJson> list = new List<MerchantJson>();
            GetMerchantByStatus result = JsonHelper<GetMerchantByStatus>.ConvertJson(url, postData);            if (result != null)
            {
                list = result.products_info;
            }            return list;
        }
登入後複製

我们添加商品的时候，商品的分类信息、分类属性、分类SKU信息也都是很重要的内容，我们需要指定对应商品分类才能添加到微信小店里面。

获取商品分类的操作实现代码如下所示。

        /// <summary>
        /// 获取指定分类的所有子分类        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="cateId">大分类ID(根节点分类id为1)</param>
        /// <returns></returns>
        public List<SubCategory> GetSub(string accessToken, int cate_id)
        {            var url = string.Format("http://www.php.cn/{0}", accessToken);            var data = new
            {
                cate_id = cate_id
            };            string postData = data.ToJson();

            List<SubCategory> list = new List<SubCategory>();
            GetSubResult result = JsonHelper<GetSubResult>.ConvertJson(url, postData);            if(result != null)
            {
                list = result.cate_list;
            }            return list;
        }
登入後複製

 

3、商品管理接口的测试

为了验证我们开发的接口，我们需要增加一个测试项目，方便对我们编写的API进行测试，测试完全成功后，我们才能正式在项目中使用。

我为了方便，创建了一个Winform项目，分别对各个接口进行测试。

C#开发微信门户及应用-微信小店商品管理接口的封装和测试

本篇主要介绍商品管理方面的接口，因此下面主要介绍其中商品管理部分的接口测试代码，以及对应的结果。

其中商品常规管理的接口测试代码如下所示。

        private void btnMerchant_Click(object sender, EventArgs e)
        {            //商品管理
            IMerchantApi api = new MerchantApi();            //获取所有商品信息
            Console.WriteLine("获取所有商品信息");
            List<MerchantJson> list = api.GetMerchantByStatus(token, 0);            foreach(MerchantJson json in list)
            {
                Console.WriteLine(json.ToJson());
                Console.WriteLine();
            }            //更新商品状态
            Console.WriteLine("更新商品状态");            foreach (MerchantJson json in list)
            {
                CommonResult result = api.UpdateMerchantStatus(token, json.product_id, 1);
                Console.WriteLine("商品ID：{0},商品名称：{1}， 操作：{2}", 
                    json.product_id, json.product_base.name, result.Success ? "成功" : "失败");
            }

            Thread.Sleep(1000);            //根据商品ID获取商品信息
            Console.WriteLine("根据商品ID获取商品信息");            foreach (MerchantJson json in list)
            {
                MerchantJson getJson = api.GetMerchant(token, json.product_id);                if(json != null)
                {
                    Console.WriteLine("商品ID：{0},商品名称：{1}", getJson.product_id, getJson.product_base.name);
                }
            }
        }
登入後複製

测试后结果如下所示（就是返回我微店铺里面的商品信息），一切正常。

返回的商品Json数据如下所示：

{  "product_id": "pSiLnt6FYDuFtrRRPMlkdKbye-rE",  "product_base": {    "category_id": [      "537103312"
    ],    "property": [
      {        "id": "类型",        "vid": "软件产品设计"
      }
    ],    "name": "代码生成工具Database2Sharp",    "sku_info": [],    "main_img": "http://www.php.cn/",    "img": [      "http://www.php.cn/"
    ],    "detail": [],    "buy_limit": 0,    "detail_html": ""
  },  "sku_list": [
    {      "sku_id": "",      "ori_price": 100000,      "price": 50000,      "icon_url": "",      "quantity": 1100,      "product_code": ""
    }
  ],  "attrext": {    "location": {      "country": "中国",      "province": "广东",      "city": "广州",      "address": ""
    },    "isPostFree": 1,    "isHasReceipt": 0,    "isUnderGuaranty": 0,    "isSupportReplace": 0
  },  "delivery_info": {    "delivery_type": 0,    "template_id": 175807970,    "express": [
      {        "id": 10000027,        "price": 0
      },
      {        "id": 10000028,        "price": 0
      },
      {        "id": 10000029,        "price": 0
      }
    ]
  },  "status": 1}
登入後複製

View Code

测试的部分结果输出如下所示。

C#开发微信门户及应用-微信小店商品管理接口的封装和测试

另外，“商品维护管理”的功能测试主要就是测试商品的增加、修改、删除操作，具体代码如下所示。

        private void btnMerchantEdit_Click(object sender, EventArgs e)
        {
            IMerchantApi api = new MerchantApi();            
            string img1 = "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjD3ulEKogfsiaua49pvLfUS8Ym0GSYjViaLic0FD3vN0V8PILcibEGb2fPfEOmw/0";            
            string img2 = "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjD3ul1UcLcwxrFdwTKYhH9Q5YZoCfX4Ncx655ZK6ibnlibCCErbKQtReySaVA/0n/";            
            string img3 = "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl28bJj62XgfHPibY3ORKicN1oJ4CcoIr4BMbfA8LqyyjzOZzqrOGz3f5KWq1QGP3fo6TOTSYD3TBQjuw/0n/";            
            //商品增删改处理
            MerchantJson merchant = new MerchantJson();
            merchant.product_base = new Merchant_base();
            merchant.product_base.name = "测试产品";
            merchant.product_base.category_id.Add("537074298");
            merchant.product_base.img = new List<string>() { img1, img2, img3 };
            merchant.product_base.main_img = img1;
            merchant.product_base.detail.AddRange(new List<MerchantDetail>() {                    new MerchantDetail()
                    {
                        text = "test first"
                    },                    new MerchantDetail()
                    {
                        img = img2
                    }, new MerchantDetail()
                    {
                        text = "test again"
                    }
            });
            merchant.product_base.property.AddRange(new List<MerchantProperty>(){                new MerchantProperty
                {
                    id= "1075741879",
                    vid="1079749967"
                },                new MerchantProperty{
                    id= "1075754127",
                    vid= "1079795198"
                },                new MerchantProperty(){
                    id= "1075777334",
                    vid= "1079837440"
                }
            });
            merchant.product_base.sku_info.AddRange(new List<MerchantSku>(){                new MerchantSku{
                    id=  "1075741873",
                    vid = new List<string>() {                        "1079742386",                        "1079742363"
                    }
                }
            });
            merchant.product_base.buy_limit = 10;            //merchant.product_base.detail_html = "<p class=\"item_pic_wrp\" style=\"margin-bottom:8px;font-size:0;\"><img class=\"item_pic\" style=\"width:100%;\" alt=\"\" src=\"http://www.php.cn/\" ></p><p style=\"margin-bottom:11px;margin-top:11px;\">test</p><p class=\"item_pic_wrp\" style=\"margin-bottom:8px;font-size:0;\"><img class=\"item_pic\" style=\"width:100%;\" alt=\"\" src=\"http://www.php.cn/\" ></p><p style=\"margin-bottom:11px;margin-top:11px;\">test again</p>";
            merchant.sku_list.AddRange(new List<MerchantSku_list>()
            {                new MerchantSku_list(){
                sku_id="1075741873:1079742386",
                price=30,
                icon_url="http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjD3ulEKogfsiaua49pvLfUS8Ym0GSYjViaLic0FD3vN0V8PILcibEGb2fPfEOmw/0",
                quantity=800,
                product_code="testing",
                ori_price=9000000
                },                new MerchantSku_list(){
                    sku_id="1075741873:1079742363",
                    price=30,
                    icon_url="http://mmbiz.qpic.cn/mmbiz/4whpV1VZl28bJj62XgfHPibY3ORKicN1oJ4CcoIr4BMbfA8LqyyjzOZzqrOGz3f5KWq1QGP3fo6TOTSYD3TBQjuw/0",
                    quantity=800,
                    product_code="testingtesting",
                    ori_price=9000000
                }
            });
            merchant.attrext = new MerchantAttrext()
            {
                location = new MerchantLocation()
                {
                    country = "中国",
                    province = "广东省",
                    city = "广州市",
                    address = "T.I.T创意园"
                },
                isPostFree = 0,
                isHasReceipt = 1,
                isUnderGuaranty = 0,
                isSupportReplace = 0
            };
            merchant.delivery_info = new MerchantDelivery()
            {
                delivery_type = 0,
                template_id = 0,
                express = new List<MerchantExpress>(){                new MerchantExpress() {
                    id=10000027, 
                    price=100
                }, 
                new MerchantExpress(){
                    id=10000028, 
                    price=100
                }, 
                new MerchantExpress(){
                    id=10000029, 
                    price=100
                }}
            };

            Console.WriteLine(merchant.ToJson());

            AddMerchantResult result = api.AddMerchant(token, merchant);
            Console.WriteLine("添加商品：{0}", result.product_id);            if (!string.IsNullOrEmpty(result.product_id))
            {                //更新商品
                merchant.product_id = result.product_id;
                merchant.product_base.name = "测试产品22";
                CommonResult updateResult = api.UpdateMerchant(token, merchant);
                Console.WriteLine("更新商品：{0}", updateResult.Success ? "成功" : "失败");


                CommonResult deleteResult = api.DeleteMerchant(token, merchant.product_id);
                Console.WriteLine("删除商品：{0}", deleteResult.Success ? "成功" : "失败");
            }
        }
登入後複製

测试的输出结果如下所示（一切成功）。

C#开发微信门户及应用-微信小店商品管理接口的封装和测试

以上就是我对商品管理接口的API定义和实现，以及对接口进行测试的阐述，基本上把所有相关的内容都贴出来了，希望大家能够对微店开发部分，有更深入的了解和认识。

 更多C#开发微信门户及应用-微信小店商品管理接口的封装和测试 相关文章请关注PHP中文网！


本網站聲明
本文內容由網友自願投稿，版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容，請聯絡admin@php.cn

熱AI工具

Undresser.AI Undress

Undresser.AI Undress

人工智慧驅動的應用程序，用於創建逼真的裸體照片

AI Clothes Remover

AI Clothes Remover

用於從照片中去除衣服的線上人工智慧工具。

Undress AI Tool

Undress AI Tool

免費脫衣圖片

Clothoff.io

Clothoff.io

AI脫衣器

AI Hentai Generator

AI Hentai Generator

免費產生 AI 無盡。

顯示更多

熱門文章

R.E.P.O.能量晶體解釋及其做什麼（黃色晶體）
4 週前 By 尊渡假赌尊渡假赌尊渡假赌
R.E.P.O.最佳圖形設置
4 週前 By 尊渡假赌尊渡假赌尊渡假赌
刺客信條陰影：貝殼謎語解決方案
2 週前 By DDD
R.E.P.O.如果您聽不到任何人，如何修復音頻
4 週前 By 尊渡假赌尊渡假赌尊渡假赌
WWE 2K25：如何解鎖Myrise中的所有內容
1 個月前 By 尊渡假赌尊渡假赌尊渡假赌
顯示更多

熱工具

記事本++7.3.1

記事本++7.3.1

好用且免費的程式碼編輯器

SublimeText3漢化版

SublimeText3漢化版

中文版，非常好用

禪工作室 13.0.1

禪工作室 13.0.1

強大的PHP整合開發環境

Dreamweaver CS6

Dreamweaver CS6

視覺化網頁開發工具

SublimeText3 Mac版

SublimeText3 Mac版

神級程式碼編輯軟體(SublimeText3)

顯示更多

熱門話題

gmail信箱登陸入口在哪裡
7504
15
CakePHP 教程
1378
52
steam的賬戶名稱是什麼格式
78
11
win11激活密鑰永久
52
19
NYT連接提示和答案
19
54
顯示更多