版本内容
1、修正了缺少对Event.View的支持
2、增加了用户UnionID
3、新增微信小店功能
4、多客服功能
5、单元测试
什么是UnionID
我们知道,每个用户针对一个微信公众账号都有一个openId,对于不同的公众账号,openId都是不同的,但很多公司都有很多微信号,用户也会同时关注同个公司的多个微信账号,为确保用户的唯一性,腾讯增加了UnionID字段,它可以确保在同个微信开放平台(open.weixin.qq.com)账号下的多个公众号的同个用户的唯一性。点击传送门,查看使用方法。
以前我们的开发,都是在mp.weixin.qq.com微信公众账号后台的开发者中心里,现在我们可以在微信开放平台里,把多个公众账号绑定到一个开发者账号中,目前一个账号可以绑定10个公众号。目前2套系统还是分开的,估计以后都会统一到Open系统中,目前Open已经有网站登录、移动登入、移动支付等接口,老应我也会继续跟进的。
UnionID目前只在“获取用户基本信息”中增加,UserInfoResponse增加string类型的UnionID属性。
微信小店
微信公众平台本次更新增加了微信小店功能,微信小店基于微信支付,包括添加商品、商品管理、订单管理、货架管理、维权等功能,开发者可使用接口批量添加商品,快速开店。
必须是已微信认证、已接入微信支付的服务号,才可在服务中心中申请开通微信小店功能。
微信小店其实就是一个微店功能,公众号可以在公众平台后台进行添加、修改、删除等功能,用户可以在其微店下单,使用微信支付。这次微信小店的api文档比较大,所以这次更新慢了点,而且无法进行测试,我只能对每个api进行了单元测试,比对文档中提供的json数据,虽说简单,但工作量巨大,pdf文档无法进行复制黏贴,所以可能会存在一定的bug,如果发现bug,请及时与我联系。
这次的Api中,增加了一个DefaultResponse的响应类,主要是针对一些api请求只需要返回errcode和errmsg,比如在修改商品、删除商品等api中都会遇到,这些api只需要返回成功与否即可,所以就不增加其相对应的Response了。
微信小店有个货架功能,他与库存不是一个概念,它的概念相当于超市的货品摆放架,你可以创建多个货架,每个货架可以包含一个或多个货架控件。这个可能很难理解,你可以理解成页面和控件,一个货架就是一个页面,货架控件相当于我们的web控件。目前微信小店提供了5种货架控件,摆放和关联都有一定的限制。
控件1:是由一个分组组成,展示该指定数量的商品列表可与控件,可以与控件2、控件3、控件4联合使用
控件2:是由多个分组组成(最多有4个分组),展示指定分组的名称,可以与控件1、控件3、控件4联合使用
控件3:是由一个分组组成,展示指定分组的分组图片,可以与控件1、控件2、控件4联合使用
控件4:是由多个分组组成(最多3个分组),展示指定分组的分组图片,可以与控件1、控件2、控件3联合使用
控件5:是由多个分组组成,展示指定分组的名称,不可以与其他控件联合使用。
具体的样式,大家可以参考pdf文档。
因为控件我都继承了ShelfModule的抽象类,在json反序列化时造成了很大的麻烦,最后虽然解决了,但总觉得不够理想,过几天我会整理下,把我的方案分享下,也希望有大虾指点下。
以下是微信小店的API的Request和Response的对应表:
商品管理接口 | ||
增加商品 | MerchantCreateRequest | MerchantCreateResponse |
删除商品 | MerchantDelRequest | DefaultResponse |
修改商品 | MerchantUpdateRequest | DefaultResponse |
查询商品 | MerchantGetRequest | MerchantGetResponse |
获取指定状态的所有商品 | MerchantGetbystatusRequest | MerchantGetbystatusResponse |
商品上下架 | MerchantModproductstatusRequest | DefaultResponse |
获取指定分类的所有子分类 | MerchantCategoryGetsubRequest | MerchantCategoryGetsubResponse |
获取指定子分类的所有SKU | MerchantCategoryGetskuRequest | MerchantCategoryGetskuResponse |
获取指定分类的所有属性 | MerchantCategoryGetpropertyRequest | MerchantCategoryGetpropertyResponse |
库存管理接口 | ||
增加库存 | MerchantStockAddRequest | DefaultResponse |
减少库存 | MerchantStockReduceRequest | DefaultResponse |
邮费模板管理接口 | ||
增加邮费模板 | MerchantExpressAddRequest | MerchantExpressAddResponse |
删除邮费模板 | MerchantExpressDelRequest | DefaultResponse |
修改邮费模板 | MerchantExpressUpdateRequest | DefaultResponse |
获取指定ID的邮费模板 | MerchantExpressGetbyidRequest | MerchantExpressGetbyidResponse |
获取所有邮费模板 | MerchantExpressGetallRequest | MerchantExpressGetallResponse |
分组管理接口 | ||
增加分组 | MerchantGroupAddRequest | MerchantGroupAddResponse |
删除分组 | MerchantGroupDelRequest | DefaultResponse |
修改分组属性 | MerchantGroupPropertymodRequest | DefaultResponse |
修改分组商品 | MerchantGroupProductmodRequest | DefaultResponse |
获取所有分组 | MerchantGroupGetallRequest | MerchantGroupGetallResponse |
根据分组ID获取分组信息 | MerchantGroupGetbyidRequest | MerchantGroupGetbyidResponse |
货架管理接口 | ||
增加货架 | MerchantShelfAddRequest | MerchantShelfAddResponse |
删除货架 | MerchantShelfDelRequest | DefaultResponse |
修改货架 | MerchantShelfModRequest | DefaultResponse |
获取所有货架 | MerchantShelfGetallRequest | MerchantShelfGetallResponse |
根据货架ID获取货架信息 | MerchantShelfGetbyidRequest | MerchantShelfGetbyidResponse |
货架上下架 | MerchantShelfUpdatestatusRequest | MerchantShelfUpdatestatusResponse |
订单管理接口 | ||
订单付款通知 | RequestOrderEventMessage(通知信息) | |
根据订单ID获取订单详情 | MerchantOrderGetbyidRequest | MerchantOrderGetbyidResponse |
根据订单状态/创建时间获取订单详情 | MerchantOrderGetbyfilterRequest | MerchantOrderGetbyFilterResponse |
设置订单发货信息 | MerchantOrderSetdeliveryRequest | DefaultResponse |
关闭订单 | MerchantOrderCloseRequest | DefaultResponse |
功能接口 | ||
上传图片 | MerchantCommonUploadimgRequest | MerchantCommonUploadimgResponse |
这里大家要注意一点,这里接口所用到的图片url,都需要通过上传图片api上传后获取的url
多客服功能
1、将消息转发到多客服:
在收到客户消息时,只要返回 ResponseTransferCustomServiceMessage 的实例即可。
2、获取客服聊天记录:
使用了高级接口,创建一个CustomServiceGetRecordRequest实例,提交后获取CustomServiceGetRecordResponse。
单元测试
这次因为没有测试接口,所以对所有的api进行的Mock测试,基本是通过了,但还是无法保证正确性,希望大家在试用中能与我多交流,尽量的消灭bug。
之前因为有测试接口,我都能实地的测试,这次呢通过单元测试,虽然很枯燥,但帮助真的很大,其中测试出了很多小bug,单词拼错,报错等等,所以希望大家在自己的项目中,不要压缩测试的时间,这个真的很重要。
相关文档
1、微信公众平台开发者文档 点击进入
2、微信小店文档 点击下载
3、源代码已更新至Github 点击进入
写在最后
最近微信的升级加快,由于精力有限,所以这次版本升级较慢,造成的不便深感抱歉,很多朋友问我为什么做框架而不是实例?实例至少可以卖钱,但本人不是这样想,做这个框架是第一是为了完成自己对开源的一个理想,第二呢也是方便大家能够对公众平台的快速入门。后续呢可能会针对微信的开放平台进行框架设计,也有可能完成对公众平台的一个实例,至于时间,无法保障。
很多人觉得项目名称有点变扭,没办法,一开始我只是针对自己的平台做的小框架,名字也乱起的,后来也懒得改了,将错就错吧,哈。
最后推荐个QQ群:85318032 (博友加入的时候,请注明自己的技术特长)