支出微信门户及利用

By admin in 亚洲必赢app在哪下载 on 2019年1月12日

在上篇《C#开发微信门户及采用(22)-微信小店的支付和使用》里面介绍了有些微信小店的基础知识,以及相应的对象模型,本篇继续微信小店的主题,介绍其中API接口的卷入和测试使用。微信小店的连锁对象模型,基本上包括了正常的货色、商品分组、货架、库存、订单这多少个模型,还有货物分类,商品分类属性、商品分类SKU、快递邮寄模板、图片管理等成效。本文介绍的接口封装也就是基于这一个情节举办的,并针对接口的实现举行测试和使用。

1、商品管理接口的概念

前边作品介绍了微信小店的对象模型,如下所示。

亚洲必赢app在哪下载 1

本条图片基本上覆盖了微信小店的连锁对象,并介绍了它们中间的关联了。

咱俩从基础的商品新闻管理起头,我们了然,商品接口包含了扩大、修改、查询、删除等接口,如下所示。

亚洲必赢app在哪下载 2

商品音信是独具微店的底子,因此对它的治本操作,我们需要更为显著和系数。

归咎的效益,我们可以定义好微信商品的接口如下所示。

        #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的底蕴管理,由此商品管理还需要扩张这多少个情节

亚洲必赢app在哪下载 3

它们的效能接口定义如下所示。通过下面的接口,大家就很容易实现商品归类(不是货物分组)、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("https://api.weixin.qq.com/merchant/create?access_token={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("https://api.weixin.qq.com/merchant/del?access_token={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("https://api.weixin.qq.com/merchant/update?access_token={0}", accessToken);
            string postData = merchantJson.ToJson();

            return Helper.GetExecuteResult(url, postData);
        }

为了拿到商品的详细消息,我们需要定义一个商品的实体对象,以便我们把收获到的音信转换为实体类音信,方便使用和拍卖。

亚洲必赢app在哪下载,货物的消息,包含了不少细小定义的类,他们结合了货物的逐一部分的情节,主体的实体类新闻如下所示。

亚洲必赢app在哪下载 4

概念好相对相比复杂的商品消息实体后,我们就可以通过对象举办处理了。

获取商品详细音信的落实代码如下所示。

        /// <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("https://api.weixin.qq.com/merchant/get?access_token={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("https://api.weixin.qq.com/merchant/getbystatus?access_token={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("https://api.weixin.qq.com/merchant/category/getsub?access_token={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项目,分别对各种接口举行测试。

亚洲必赢app在哪下载 5

本篇重要介绍商品管理方面的接口,由此下边首要介绍其中商品管理一些的接口测试代码,以及相应的结果。

中间货物常规管理的接口测试代码如下所示。

        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数据如下所示:

亚洲必赢app在哪下载 6亚洲必赢app在哪下载 7

{
  "product_id": "pSiLnt6FYDuFtrRRPMlkdKbye-rE",
  "product_base": {
    "category_id": [
      "537103312"
    ],
    "property": [
      {
        "id": "类型",
        "vid": "软件产品设计"
      }
    ],
    "name": "代码生成工具Database2Sharp",
    "sku_info": [],
    "main_img": "http://mmbiz.qpic.cn/mmbiz/mLqH9gr11Gyb2sgiaelcsxYtQENGePp0Rb3AZKbjkicnKTUNBrEdo7Dyic97ar46SoAfKRB5x2R94bDUdNpgqiaZzA/0",
    "img": [
      "http://mmbiz.qpic.cn/mmbiz/mLqH9gr11Gyb2sgiaelcsxYtQENGePp0RiaheJmVXm7tbvTYUQV7OF3DgfGiaQVMh3WbeEcGDOQQiajQXGKK9tfoeA/0"
    ],
    "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

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

亚洲必赢app在哪下载 8

此外,“商品保障管理”的效能测试重要就是测试商品的充实、修改、删除操作,具体代码如下所示。

        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/0";
            string img3 = "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl28bJj62XgfHPibY3ORKicN1oJ4CcoIr4BMbfA8LqyyjzOZzqrOGz3f5KWq1QGP3fo6TOTSYD3TBQjuw/0";

            //商品增删改处理
            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 = "<div class=\"item_pic_wrp\" style=\"margin-bottom:8px;font-size:0;\"><img class=\"item_pic\" style=\"width:100%;\" alt=\"\" src=\"http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjD3ulEKogfsiaua49pvLfUS8Ym0GSYjViaLic0FD3vN0V8PILcibEGb2fPfEOmw/0\" ></div><p style=\"margin-bottom:11px;margin-top:11px;\">test</p><div class=\"item_pic_wrp\" style=\"margin-bottom:8px;font-size:0;\"><img class=\"item_pic\" style=\"width:100%;\" alt=\"\" src=\"http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjD3ul1UcLcwxrFdwTKYhH9Q5YZoCfX4Ncx655ZK6ibnlibCCErbKQtReySaVA/0\" ></div><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 ? "成功" : "失败");
            }
        }

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

亚洲必赢app在哪下载 9

如上就是本人对货品管理接口的API定义和贯彻,以及对接口举办测试的论述,基本上把所有有关的情节都贴出来了,希望我们可以对微店开发一些,有更深远的摸底和认得。

 

只要对这一个《C#开发微信门户及使用》连串感兴趣,可以关心自身的其它作品,系列小说如下所示:

C#开发微信门户及选择(25)-微信集团号的客户端管住功效

C#支出微信门户及利用(24)-微信小店货架信息保管

C#支付微信门户及采用(23)-微信小店商品管理接口的卷入和测试

C#付出微信门户及利用(22)-微信小店的支出和接纳

C#支出微信门户及采用(21)-微信集团号的音信和事件的收到处理及解密 

C#支出微信门户及运用(20)-微信公司号的菜谱管理

C#开发微信门户及应用(19)-微信公司号的音讯发送(文本、图片、文件、语音、视频、图文音信等)

C#开发微信门户及使用(18)-微信公司号的通讯录管理支出之成员管理

C#付出微信门户及运用(17)-微信公司号的通讯录管理支付之部门管理

C#付出微信门户及应用(16)-微信公司号的配置和采用

C#支出微信门户及选拔(15)-微信菜单扩展扫一扫、发图片、发地理地方效能

 C#支付微信门户及利用(14)-在微信菜单中行使重定向获取用户数量

C#开发微信门户及使用(13)-使用地理地方扩张相关应用

C#付出微信门户及运用(12)-使用语音处理

C#支付微信门户及使用(11)–微信菜单的多种呈现模式介绍

C#开发微信门户及运用(10)–在保管体系中一头微信用户分组信息

C#付出微信门户及应用(9)-微信门户菜单管理及提交到微信服务器

C#支付微信门户及运用(8)-微信门户应用管理连串机能介绍

C#开发微信门户及应用(7)-微信多客服功效及支付集成

C#支出微信门户及采纳(6)–微信门户菜单的管住操作

C#开发微信门户及应用(5)–用户分组信息保管

C#付出微信门户及运用(4)–关注用户列表及详细信息管理

C#支出微信门户及应用(3)–文本音信和图文新闻的对答

C#开发微信门户及采用(2)–微信音信的拍卖和回应

C#付出微信门户及应用(1)–起先应用微信接口

发表评论

电子邮件地址不会被公开。 必填项已用*标注

网站地图xml地图
Copyright @ 2010-2019 亚洲必赢app官方下载 版权所有