微信快速開(kāi)發(fā)框架 新增微店功能
什么是UnionID
我們知道，每個(gè)用戶針對(duì)一個(gè)微信公眾賬號(hào)都有一個(gè)openId，對(duì)于不同的公眾賬號(hào)，openId都是不同的，但很多公司都有很多微信號(hào)，用戶也會(huì)同時(shí)關(guān)注同個(gè)公司的多個(gè)微信賬號(hào)，為確保用戶的唯一性，騰訊增加了UnionID字段，它可以確保在同個(gè)微信開(kāi)放平臺(tái)（open.weixin.qq.com）賬號(hào)下的多個(gè)公眾號(hào)的同個(gè)用戶的唯一性。點(diǎn)擊傳送門(mén)，查看使用方法。
以前我們的開(kāi)發(fā)，都是在mp.weixin.qq.com微信公眾賬號(hào)后臺(tái)的開(kāi)發(fā)者中心里，現(xiàn)在我們可以在微信開(kāi)放平臺(tái)里，把多個(gè)公眾賬號(hào)綁定到一個(gè)開(kāi)發(fā)者賬號(hào)中，目前一個(gè)賬號(hào)可以綁定10個(gè)公眾號(hào)。目前2套系統(tǒng)還是分開(kāi)的，估計(jì)以后都會(huì)統(tǒng)一到Open系統(tǒng)中，目前Open已經(jīng)有網(wǎng)站登錄、移動(dòng)登入、移動(dòng)支付等接口，老應(yīng)我也會(huì)繼續(xù)跟進(jìn)的。
UnionID目前只在“獲取用戶基本信息”中增加，UserInfoResponse增加string類型的UnionID屬性。
微信小店
微信公眾平臺(tái)本次更新增加了微信小店功能，微信小店基于微信支付，包括添加商品、商品管理、訂單管理、貨架管理、維權(quán)等功能，開(kāi)發(fā)者可使用接口批量添加商品，快速開(kāi)店。
必須是已微信認(rèn)證、已接入微信支付的服務(wù)號(hào)，才可在服務(wù)中心中申請(qǐng)開(kāi)通微信小店功能。
微信小店其實(shí)就是一個(gè)微店功能，公眾號(hào)可以在公眾平臺(tái)后臺(tái)進(jìn)行添加、修改、刪除等功能，用戶可以在其微店下單，使用微信支付。這次微信小店的api文檔比較大，所以這次更新慢了點(diǎn)，而且無(wú)法進(jìn)行測(cè)試，我只能對(duì)每個(gè)api進(jìn)行了單元測(cè)試，比對(duì)文檔中提供的json數(shù)據(jù)，雖說(shuō)簡(jiǎn)單，但工作量巨大，pdf文檔無(wú)法進(jìn)行復(fù)制黏貼，所以可能會(huì)存在一定的bug，如果發(fā)現(xiàn)bug，請(qǐng)及時(shí)與我聯(lián)系。
這次的Api中，增加了一個(gè)DefaultResponse的響應(yīng)類，主要是針對(duì)一些api請(qǐng)求只需要返回errcode和errmsg，比如在修改商品、刪除商品等api中都會(huì)遇到，這些api只需要返回成功與否即可，所以就不增加其相對(duì)應(yīng)的Response了。
微信小店有個(gè)貨架功能，他與庫(kù)存不是一個(gè)概念，它的概念相當(dāng)于超市的貨品擺放架，你可以創(chuàng)建多個(gè)貨架，每個(gè)貨架可以包含一個(gè)或多個(gè)貨架控件。這個(gè)可能很難理解，你可以理解成頁(yè)面和控件，一個(gè)貨架就是一個(gè)頁(yè)面，貨架控件相當(dāng)于我們的web控件。目前微信小店提供了5種貨架控件，擺放和關(guān)聯(lián)都有一定的限制。
控件1：是由一個(gè)分組組成，展示該指定數(shù)量的商品列表可與控件，可以與控件2、控件3、控件4聯(lián)合使用
控件2：是由多個(gè)分組組成（最多有4個(gè)分組），展示指定分組的名稱，可以與控件1、控件3、控件4聯(lián)合使用
控件3：是由一個(gè)分組組成，展示指定分組的分組圖片，可以與控件1、控件2、控件4聯(lián)合使用
控件4：是由多個(gè)分組組成（最多3個(gè)分組），展示指定分組的分組圖片，可以與控件1、控件2、控件3聯(lián)合使用
控件5：是由多個(gè)分組組成，展示指定分組的名稱，不可以與其他控件聯(lián)合使用。
具體的樣式，大家可以參考pdf文檔。
因?yàn)榭丶叶祭^承了ShelfModule的抽象類，在json反序列化時(shí)造成了很大的麻煩，最后雖然解決了，但總覺(jué)得不夠理想，過(guò)幾天我會(huì)整理下，把我的方案分享下，也希望有大蝦指點(diǎn)下。
以下是微信小店的API的Request和Response的對(duì)應(yīng)表：
| 商品管理接口 | ||
| 增加商品 | MerchantCreateRequest | MerchantCreateResponse |
| 刪除商品 | MerchantDelRequest | DefaultResponse |
| 修改商品 | MerchantUpdateRequest | DefaultResponse |
| 查詢商品 | MerchantGetRequest | MerchantGetResponse |
| 獲取指定狀態(tài)的所有商品 | MerchantGetbystatusRequest | MerchantGetbystatusResponse |
| 商品上下架 | MerchantModproductstatusRequest | DefaultResponse |
| 獲取指定分類的所有子分類 | MerchantCategoryGetsubRequest | MerchantCategoryGetsubResponse |
| 獲取指定子分類的所有SKU | MerchantCategoryGetskuRequest | MerchantCategoryGetskuResponse |
| 獲取指定分類的所有屬性 | MerchantCategoryGetpropertyRequest | MerchantCategoryGetpropertyResponse |
| 庫(kù)存管理接口 | ||
| 增加庫(kù)存 | MerchantStockAddRequest | DefaultResponse |
| 減少庫(kù)存 | MerchantStockReduceRequest | DefaultResponse |
| 郵費(fèi)模板管理接口 | ||
| 增加郵費(fèi)模板 | MerchantExpressAddRequest | MerchantExpressAddResponse |
| 刪除郵費(fèi)模板 | MerchantExpressDelRequest | DefaultResponse |
| 修改郵費(fèi)模板 | MerchantExpressUpdateRequest | DefaultResponse |
| 獲取指定ID的郵費(fèi)模板 | MerchantExpressGetbyidRequest | MerchantExpressGetbyidResponse |
| 獲取所有郵費(fèi)模板 | MerchantExpressGetallRequest | MerchantExpressGetallResponse |
| 分組管理接口 | ||
| 增加分組 | MerchantGroupAddRequest | MerchantGroupAddResponse |
| 刪除分組 | MerchantGroupDelRequest | DefaultResponse |
| 修改分組屬性 | MerchantGroupPropertymodRequest | DefaultResponse |
| 修改分組商品 | MerchantGroupProductmodRequest | DefaultResponse |
| 獲取所有分組 | MerchantGroupGetallRequest | MerchantGroupGetallResponse |
| 根據(jù)分組ID獲取分組信息 | MerchantGroupGetbyidRequest | MerchantGroupGetbyidResponse |
| 貨架管理接口 | ||
| 增加貨架 | MerchantShelfAddRequest | MerchantShelfAddResponse |
| 刪除貨架 | MerchantShelfDelRequest | DefaultResponse |
| 修改貨架 | MerchantShelfModRequest | DefaultResponse |
| 獲取所有貨架 | MerchantShelfGetallRequest | MerchantShelfGetallResponse |
| 根據(jù)貨架ID獲取貨架信息 | MerchantShelfGetbyidRequest | MerchantShelfGetbyidResponse |
| 貨架上下架 | MerchantShelfUpdatestatusRequest | MerchantShelfUpdatestatusResponse |
| 訂單管理接口 | ||
| 訂單付款通知 | RequestOrderEventMessage(通知信息） | |
| 根據(jù)訂單ID獲取訂單詳情 | MerchantOrderGetbyidRequest | MerchantOrderGetbyidResponse |
| 根據(jù)訂單狀態(tài)/創(chuàng)建時(shí)間獲取訂單詳情 | MerchantOrderGetbyfilterRequest | MerchantOrderGetbyFilterResponse |
| 設(shè)置訂單發(fā)貨信息 | MerchantOrderSetdeliveryRequest | DefaultResponse |
| 關(guān)閉訂單 | MerchantOrderCloseRequest | DefaultResponse |
| 功能接口 | ||
| 上傳圖片 | MerchantCommonUploadimgRequest | MerchantCommonUploadimgResponse |
這里大家要注意一點(diǎn)，這里接口所用到的圖片url，都需要通過(guò)上傳圖片api上傳后獲取的url
多客服功能
1、將消息轉(zhuǎn)發(fā)到多客服：
在收到客戶消息時(shí)，只要返回 ResponseTransferCustomServiceMessage 的實(shí)例即可。
2、獲取客服聊天記錄：
使用了高級(jí)接口，創(chuàng)建一個(gè)CustomServiceGetRecordRequest實(shí)例，提交后獲取CustomServiceGetRecordResponse。
?
?
單元測(cè)試
這次因?yàn)闆](méi)有測(cè)試接口，所以對(duì)所有的api進(jìn)行的Mock測(cè)試，基本是通過(guò)了，但還是無(wú)法保證正確性，希望大家在試用中能與我多交流，盡量的消滅bug。
之前因?yàn)橛袦y(cè)試接口，我都能實(shí)地的測(cè)試，這次呢通過(guò)單元測(cè)試，雖然很枯燥，但幫助真的很大，其中測(cè)試出了很多小bug，單詞拼錯(cuò)，報(bào)錯(cuò)等等，所以希望大家在自己的項(xiàng)目中，不要壓縮測(cè)試的時(shí)間，這個(gè)真的很重要。
相關(guān)文檔
1、微信公眾平臺(tái)開(kāi)發(fā)者文檔?點(diǎn)擊進(jìn)入
2、微信小店文檔?點(diǎn)擊下載
3、源代碼已更新至Github?點(diǎn)擊進(jìn)入
寫(xiě)在最后
最近微信的升級(jí)加快，由于精力有限，所以這次版本升級(jí)較慢，造成的不便深感抱歉，很多朋友問(wèn)我為什么做框架而不是實(shí)例？實(shí)例至少可以賣(mài)錢(qián)，但本人不是這樣想，做這個(gè)框架是第一是為了完成自己對(duì)開(kāi)源的一個(gè)理想，第二呢也是方便大家能夠?qū)娖脚_(tái)的快速入門(mén)。后續(xù)呢可能會(huì)針對(duì)微信的開(kāi)放平臺(tái)進(jìn)行框架設(shè)計(jì)，也有可能完成對(duì)公眾平臺(tái)的一個(gè)實(shí)例，至于時(shí)間，無(wú)法保障。
很多人覺(jué)得項(xiàng)目名稱有點(diǎn)變扭，沒(méi)辦法，一開(kāi)始我只是針對(duì)自己的平臺(tái)做的小框架，名字也亂起的，后來(lái)也懶得改了，將錯(cuò)就錯(cuò)吧，哈。