C#开发微信门户及运用(24)-微信小店货架信息保管

在眼前微信小店系列篇《C#支付微信门户及动(22)-微信小店的支出同用》里面介绍了一些微信小店的基础知识,以及《C#出微信门户及应用(23)-微信小店商品管理接口的包裹和测试》里面详细介绍了微信小店商品的接口定义、实现同测试的始末,本文主要介绍微信小店货架信息保管。这个模块是于微信小店对象中,最为复杂,也是最好难以掌握的一个模块,对于她的目标建模,需要数测试才会到起来,因此此货架管理模块,可以说凡是极具技术含量的一个模块了。

1、微信小店货架介绍

于微信公众号的后台里面,可以对货架信息进行维护,界面如下所示。货架的概念,就是拿商品分门别类的死好展示让客户,货架就是类似一个布局好的展柜,我们得定义不同之货架,然后公布不同的URL进行体验。

必发bifa88手机客服端 1

除此以外,我们一般创建货架,都是因货架的模板库来构建的,货架的沙盘被咱们飞速构建一个货架,提供了可视化的参阅界面,货架模板界面如下所示。

必发bifa88手机客服端 2

 

2、货架管理之支出模型

对此使用API开发微信店铺,微信小店的货架管理操作接口,和健康的模块差不多,具有下几乎独力量操作。

必发bifa88手机客服端 3

虽然看起与前面的目标模型差不多,但是货架的信息非常复杂,因此你如用依据Json数据把它还原也实体对象的时光,需要频繁进行斟酌,否则很轻建模错误。

本着许正在微信小店管理界面的货架模板,货架的目标信息包括了5个例外之控件模型,它们有些可以进行结合以。

必发bifa88手机客服端 4

差一点只货架的型显示如下所示。

必发bifa88手机客服端 5必发bifa88手机客服端 6

必发bifa88手机客服端 7必发bifa88手机客服端 8

必发bifa88手机客服端 9

经过地方5单控件模型,我们得看来她各自表示不一样的布局功能,而且它们得以以货架上进行结合使用的。

3、货架信息之目标建模

据悉微信小店的接口说明,我们最后定义的货架实体对象信息,内容即非常丰富和弹性化。

必发bifa88手机客服端 10

咱由此参考微信小店的API说明,就可以看到货架的信JSON数据充分复杂,具体定义如下所示。

必发bifa88手机客服端 11必发bifa88手机客服端 12

{
    "shelf_data": {
      "module_infos": [
        {
          "group_info": {
            "filter": {
              "count": 2
            },
            "group_id": 50
          },
          "eid": 1
        },
        {
            "group_infos": {
                "groups": [
                  {
                    "group_id": 49
                  },
                  {
                    "group_id": 50
                  },
                  {
                    "group_id": 51
                  }
                ]
          },
          "eid": 2
        },
        {
          "group_info": {
            "group_id": 52,
            "img": "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl29nqqObBwFwnIX3licVPnFV5Jm64z4I0TTicv0TjN7Vl9bykUUibYKIOjicAwIt6Oy0Y6a1Rjp5Tos8tg/0"
          },
          "eid": 3
        },
        {
          "group_infos": {  
            "groups": [
              {
                "group_id": 49,
                "img": "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl29nqqObBwFwnIX3licVPnFV5uUQx7TLx4tB9qZfbe3JmqR4NkkEmpb5LUWoXF1ek9nga0IkeSSFZ8g/0"
              },
              {
                "group_id": 50,
                "img": "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl29nqqObBwFwnIX3licVPnFV5G1kdy3ViblHrR54gbCmbiaMnl5HpLGm5JFeENyO9FEZAy6mPypEpLibLA/0"
              },
              {
                "group_id": 52,
                "img": "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl29nqqObBwFwnIX3licVPnFV5uUQx7TLx4tB9qZfbe3JmqR4NkkEmpb5LUWoXF1ek9nga0IkeSSFZ8g/0"
              }
            ]
          },
          "eid": 4
        }, 
        {
          "group_infos": {
            "groups": [
              {
                "group_id": 43
              },
              {
                "group_id": 44
              },
              {
                "group_id": 45
              },
              {
                "group_id": 46
              }
            ],
            "img_background": "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl29nqqObBwFwnIX3licVPnFV5uUQx7TLx4tB9qZfbe3JmqR4NkkEmpb5LUWoXF1ek9nga0IkeSSFZ8g/0"
          },
          "eid": 5
        }
      ]
    }, 
    "shelf_banner": "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2ibrWQn8zWFUh1YznsMV0XEiavFfLzDWYyvQOBBszXlMaiabGWzz5B2KhNn2IDemHa3iarmCyribYlZYyw/0", 
    "shelf_name": "测试货架"
}

View Code

我们根据JSON数据的概念,定义了几乎单货架控件的靶子,他们之涉如下所示。

必发bifa88手机客服端 13

我们可以因JSON数据进行实体对象的建模,然后来矣这些目标,我们便好更定义好货架的连带操作接口了,接口定义如下所示。

        #region 货架管理

        /// <summary>
        /// 增加货架
        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="shelfBanner">货架招牌图片Url</param>
        /// <param name="shelfName">货架名称</param>
        /// <param name="controls">货架控件1,2,3,4,5类型的集合</param>
        /// <returns></returns>
        AddShelfResult AddShelf(string accessToken, string shelfBanner, string shelfName, List<ShelfControlBase> controls);

        /// <summary>
        /// 删除货架
        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="shelfId">货架Id</param>
        /// <returns></returns>
        CommonResult DeleteShelf(string accessToken, int shelfId);

        /// <summary>
        /// 修改货架
        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="shelfId">货架Id</param>
        /// <param name="shelfBanner">货架招牌图片Url</param>
        /// <param name="shelfName">货架名称</param>
        /// <param name="controls">货架控件1,2,3,4,5类型的集合</param>
        /// <returns></returns>
        CommonResult UpdateShelf(string accessToken, int shelfId, string shelfBanner, string shelfName, List<ShelfControlBase> controls);

        /// <summary>
        /// 获取所有货架
        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <returns></returns>
        List<ShelfJson> GetAllShelf(string accessToken);

        /// <summary>
        /// 根据货架ID获取货架信息
        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="shelfId">货架Id</param>
        /// <returns></returns>
        ShelfJson GetShelfById(string accessToken, int shelfId); 

        #endregion

有了这些接口的定义,我们尽管得贯彻对应之接口,从而实现我们通往微信API的包裹处理了。

微信小店的货架管理落实内容如下所示(部分内容,增删改)。

        /// <summary>
        /// 增加货架
        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="shelfBanner">货架招牌图片Url</param>
        /// <param name="shelfName">货架名称</param>
        /// <param name="controls">货架控件1,2,3,4,5类型的集合</param>
        /// <returns></returns>
        public AddShelfResult AddShelf(string accessToken, string shelfBanner, string shelfName, List<ShelfControlBase> controls)
        {
            var url = string.Format("https://api.weixin.qq.com/merchant/shelf/add?access_token={0}", accessToken);
            var data = new
            {
                shelf_data = new
                {
                    module_infos = controls
                },
                shelf_banner = shelfBanner,
                shelf_name = shelfName
            };

            string postData = data.ToJson();
            return JsonHelper<AddShelfResult>.ConvertJson(url, postData);
        }

        /// <summary>
        /// 删除货架
        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="shelfId">货架Id</param>
        /// <returns></returns>
        public CommonResult DeleteShelf(string accessToken, int shelfId)
        {
            var url = string.Format("https://api.weixin.qq.com/merchant/shelf/del?access_token={0}", accessToken);
            var data = new
            {
                shelf_id = shelfId
            };
            string postData = data.ToJson();

            return Helper.GetExecuteResult(url, postData);
        }

        /// <summary>
        /// 修改货架
        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="shelfId">货架Id</param>
        /// <param name="shelfBanner">货架招牌图片Url</param>
        /// <param name="shelfName">货架名称</param>
        /// <param name="controls">货架控件1,2,3,4,5类型的集合</param>
        /// <returns></returns>
        public CommonResult UpdateShelf(string accessToken, int shelfId, string shelfBanner, string shelfName, List<ShelfControlBase> controls)
        {
            var url = string.Format("https://api.weixin.qq.com/merchant/shelf/mod?access_token={0}", accessToken);
            var data = new
            {
                shelf_id = shelfId,
                shelf_data = new
                {
                    module_infos = controls
                },
                shelf_banner = shelfBanner,
                shelf_name = shelfName
            };
            string postData = data.ToJson();

            return Helper.GetExecuteResult(url, postData);
        }

4、微信小店货架管理的接口测试

由货架管理之靶子及接口定义比较复杂一些,一定得进行多次的测试才会规范以,如果不留神起或而定义之实体类,获取不顶某某字段信息。

本身为便利,创建了一个Winform项目,分别对各个接口进行测试。

必发bifa88手机客服端 14

于货架管理内容之接口测试,测试代码如下所示。

        private void btnShelf_Click(object sender, EventArgs e)
        {
            IMerchantApi api = new MerchantApi();
            List<ShelfJson> list = api.GetAllShelf(token);
            Console.WriteLine(list.ToJson());

            foreach(ShelfJson json in list)
            {
                Console.WriteLine("货架信息:");
                ShelfJson getJson = api.GetShelfById(token, json.shelf_id.Value);
                Console.WriteLine(getJson.ToJson());
            }

            string shelf_banner = "http://mmbiz.qpic.cn/mmbiz/mLqH9gr11Gyb2sgiaelcsxYtQENGePp0RgeNlAQicfZQokjbJMUq4h8MHtjpekJNEWKuMN3gdRz5RxfkYb7NlIrw/0";
            string shelf_name = "测试货架";
            ShelfControl1 c11 = new ShelfControl1(6, 202797386);            
            ShelfControl1 c12 = new ShelfControl1(4, 202797397);
            List<ShelfControlBase> controlList = new List<ShelfControlBase>(){c11, c12};
            AddShelfResult result = api.AddShelf(token, shelf_banner, shelf_name, controlList);
            if (result != null && result.shelf_id > 0)
            {
                Console.WriteLine("增加的货架信息:");
                ShelfJson getJson = api.GetShelfById(token, result.shelf_id);
                Console.WriteLine(getJson.ToJson());

                shelf_name = "测试货架-修改";
                controlList = new List<ShelfControlBase>(){c11};
                CommonResult updateReuslt = api.UpdateShelf(token, result.shelf_id, shelf_banner, shelf_name, controlList);
                Console.WriteLine("修改货架操作:{0}", updateReuslt.Success ? "成功" : "失败");

                CommonResult deleteResult = api.DeleteShelf(token, result.shelf_id);
                Console.WriteLine("删除货架操作:{0}", deleteResult.Success ? "成功" : "失败");
            }
        }

必发bifa88手机客服端 15

 

设若对这个《C#支付微信门户及用》系列感兴趣,可以关心自我的旁文章,系列随笔如下所示:

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)–开始动微信接口

 

相关文章