【平臺(tái)介紹】
微盟隸屬于上海暉碩信息科技有限公司，國(guó)內(nèi)領(lǐng)先的微信開(kāi)發(fā)服務(wù)商。從2013年4月發(fā)展至今，憑借著豐富的產(chǎn)品功能、全新的產(chǎn)品設(shè)計(jì)、快速的產(chǎn)品創(chuàng)新、超 出用戶期待的產(chǎn)品價(jià)值，基于微信為企業(yè)提供開(kāi)發(fā)、運(yùn)營(yíng)、培訓(xùn)、推廣一體化解決方案，幫助企業(yè)實(shí)現(xiàn)線上線下互通（O2O），社會(huì)化客戶關(guān)系管理 （SCRM），移動(dòng)電商，輕應(yīng)用（lightapp）WMAPP等多個(gè)層面的業(yè)務(wù)開(kāi)發(fā)，目前深入挖掘的行業(yè)有電商、餐飲、汽車(chē)、房產(chǎn)、婚慶、商超、快消、 銀行、證券、影樓等數(shù)百個(gè)行業(yè)解決方案。
微盟給企業(yè)提供完整的移動(dòng)電商解決方案，微盟旺鋪、社會(huì)化分銷平臺(tái)（SDP）為零售行業(yè)提供全渠道的電商解決方案，幫助企業(yè)搭建新一代微商分銷體系，實(shí)現(xiàn)線上線下互通和客戶沉淀。
【授權(quán)說(shuō)明】
微店平臺(tái)為授權(quán)型平臺(tái)。
ThirdAppKey：第三方平臺(tái)AppKey
ThirdAppSecret：第三方平臺(tái)AppSecret
SessionKey：授權(quán)號(hào)
【獲取方式】
一、注冊(cè)為微盟開(kāi)放平臺(tái)開(kāi)發(fā)者
二、登錄微盟開(kāi)放平臺(tái)
三、創(chuàng)建應(yīng)用流程
1）登陸微盟開(kāi)放平臺(tái)，進(jìn)入服務(wù)商管理后臺(tái)
2）選擇對(duì)應(yīng)的類目"創(chuàng)建應(yīng)用";
3）進(jìn)入創(chuàng)建應(yīng)用頁(yè)面，填寫(xiě)應(yīng)用名稱和應(yīng)用簡(jiǎn)介；
4）進(jìn)入應(yīng)用列表“待審核”頁(yè)面，應(yīng)用審核需一個(gè)工作日；
5）應(yīng)用審核通過(guò)
6）點(diǎn)擊查看“API權(quán)限”，獲取client_id和client_secret，進(jìn)入應(yīng)用測(cè)試開(kāi)發(fā)階段；
用戶授權(quán)說(shuō)明
如果您的應(yīng)用和微盟開(kāi)放平臺(tái)對(duì)接時(shí)需要獲取用戶隱私數(shù)據(jù) （如商品、訂單等），為保證用戶戶數(shù)據(jù)的安全與隱私，您的應(yīng)用需要取得用戶的授權(quán)，即獲取訪問(wèn)用戶數(shù)據(jù)的授權(quán)令牌 Access Token。這種情況下，您的應(yīng)用需要引導(dǎo)用戶完成使用微盟帳號(hào)“登錄授權(quán)”的流程。該流程采用國(guó)際通用的OAuth2.0標(biāo)準(zhǔn)協(xié)議作為用戶身份驗(yàn)證與授 權(quán)協(xié)議，支持網(wǎng)站、手機(jī)客戶端、桌面客戶端。 目前微盟OAuth2.0采用獲取Access Token（授權(quán)令牌） ，詳見(jiàn)如下說(shuō)明。
1.1 、請(qǐng)求地址入口
POST https://dopen.weimob.com/fuwu/b/oauth2/authorize?enter=wm&view=pc&response_type=code&scope=default&client_id={client_id}&redirect_uri={http://xxx}&state={state}
授權(quán)操作步驟：
實(shí)際進(jìn)行授權(quán)操作時(shí)，測(cè)試的數(shù)據(jù) client_id、client_secret、redirect_uri均需要根據(jù)自己創(chuàng)建的應(yīng)用實(shí)際數(shù)據(jù)給予替換，不能拿示例中給出的值直接進(jìn)行測(cè)試，以免影響實(shí)際測(cè)試效果。
拼接用戶授權(quán)需訪問(wèn)url ，示例及參數(shù)說(shuō)明如下：
https://dopen.weimob.com/fuwu/b/oauth2/authorize?enter=wm&view=pc&response_type=code&scope=default&client_id=
1q2w3e4r5t6y7u&redirect_uri=http://www.weimob.com&state=q1w2e3r4t5
參數(shù)名稱 | 是否必須 | 參數(shù)可能值 | 參數(shù)說(shuō)明 |
enter | 是 | wm | 授權(quán)入口類型 |
client_id | 是 | 第三方應(yīng)用id | |
response_type | 是 | code | 授權(quán)類型 ，值為code。 |
state | 可選 | 自定義信息 | |
redirect_uri | 是 |
填寫(xiě)在開(kāi)放平臺(tái)注冊(cè)時(shí)的回調(diào)地址
| redirect_uri指的是第三方應(yīng)用發(fā)起請(qǐng)求時(shí)，所傳的回調(diào)地址參數(shù)，在用戶授權(quán)后應(yīng)用會(huì)跳轉(zhuǎn)至redirect_uri |
scope | 是 | 默認(rèn)default，認(rèn)證權(quán)限范圍。 |
1.2 、引導(dǎo)用戶授權(quán)
引導(dǎo)用戶通過(guò)瀏覽器訪問(wèn)以上授權(quán)url，將彈出如下登錄頁(yè)面。用戶輸入賬號(hào)、密碼點(diǎn)“登錄”按鈕，即可進(jìn)入授權(quán)頁(yè)面，選擇對(duì)應(yīng)的公眾帳號(hào)。
1.2.1、獲取code
上圖頁(yè)面， 若用戶點(diǎn)“授權(quán)”按鈕后，平臺(tái)會(huì)將授權(quán)碼code 返回到了回調(diào)地址上，應(yīng)用可以獲取并使用該code去換取access_token； 若用戶未點(diǎn)授權(quán)而是點(diǎn)了“取消”按鈕，則返回如下結(jié)果，其中error為錯(cuò)誤碼，error_description為錯(cuò)誤描述。分別如下圖所示：
說(shuō)明：
可發(fā)布服務(wù)市場(chǎng)(fuwu.weimob.com)的服務(wù)，在服務(wù)上線后，如購(gòu)買(mǎi)服務(wù)的用戶，通過(guò)"我的服務(wù)--立即使用”訪問(wèn)(下圖)，系統(tǒng)會(huì)自動(dòng)跳到授權(quán)頁(yè)面(因此這種方式訪問(wèn)應(yīng)用的，不需要拼接url)，只需注意獲取code即可。
另返回code時(shí)，還會(huì)返回通過(guò)state傳遞訂購(gòu)服務(wù)相關(guān)的信息，類似如下：
state=sign:C54E2894C1401455A648547EA4DBC5E4;endTime:xxx;versionName:xxx
sign:state完整簽名，以client_secret為簽名密鑰，MD5加密
endTime: 服務(wù)結(jié)束時(shí)間
versionName: 版本名稱
sign = md5(client_secret endTime versionName)
1.3.換取access_token
成功獲取授權(quán)碼code后，可以以此進(jìn)行換取access_token。
示例及參數(shù)說(shuō)明如下：
POST https://dopen.weimob.com/fuwu/b/oauth2/token?code={code}&grant_type=authorization_code&client_id={client_id}&client_secret={client_secret}&redirect_uri={redirect_uri}
名稱 | 是 否 必 選 | 參數(shù)值 | 參數(shù)釋義 |
client_id | 是 | 創(chuàng)建應(yīng)用時(shí)獲得。 | |
client_secret | 是 | 創(chuàng)建應(yīng)用時(shí)獲得。 | |
grant_type | 是 | authorization_code | 授權(quán)類型 ，值為authorization_code |
code | 是 | 上一步獲取code得到 | |
redirect_uri | 是 | 可填寫(xiě)應(yīng)用注冊(cè)時(shí)回調(diào)地址域名。redirect_uri指的是應(yīng)用發(fā)起請(qǐng)求時(shí)，所傳的回調(diào)地址參數(shù)，在用戶授權(quán)后應(yīng)用會(huì)跳轉(zhuǎn)至redirect_uri | |
state | 可選 | 自定義信息
|
返回結(jié)果
返回key | 類型 | 返回value | 說(shuō)明 |
access_token | string | Access token | |
token_type | string | Bearer | Access token的類型目前只支持bearer |
expires_in | number | 7200（表示7200秒后過(guò)期） | Access token過(guò)期時(shí)間 |
refresh_token | string | Refresh token，可用來(lái)刷新access_token | |
refresh_token_expires_in | number | 默認(rèn)7天 | Refresh token有效期 |
scope | String | 默認(rèn)default | 授權(quán)范圍 |
business_id | String | 微盟商戶id | |
public_account_id | String | 微盟商戶的公眾號(hào)id |
1.4 刷新access_token
通過(guò)授權(quán)獲取的refresh_token，可用來(lái)刷新access token 的有效時(shí)長(zhǎng)。
示例及參數(shù)如下說(shuō)明：
POST https://dopen.weimob.com/fuwu/b/oauth2/token?grant_type=refresh_token&client_id={client_id}&client_secret={client_secret}&refresh_token={refresh_token}
名稱 | 是否必選 | 參數(shù)值 | 參數(shù)釋義 |
client_id | 是 | 創(chuàng)建應(yīng)用時(shí)獲得。 | |
client_secret | 是 | 創(chuàng)建應(yīng)用時(shí)獲得。 | |
grant_type | 是 | refresh_token | 授權(quán)類型 ，值為refresh_token |
refresh_token | 是 | 上一步中返回的refresh_token | |
state | 可選 | 自定義state
|
返回?cái)?shù)據(jù)
返回key | 類型 | 返回value | 說(shuō)明 |
access_token | string | Access token | |
token_type | string | Bearer | Access token的類型目前只支持bearer |
expires_in | number | 7200（表示7200秒后過(guò)期） | Access token過(guò)期時(shí)間 |
refresh_token | string | Refresh token，可用來(lái)刷新access_token | |
refresh_token_expires_in | number | 默認(rèn)7天 | Refresh token有效期 |
scope | String | 默認(rèn)default | 授權(quán)范圍 |
business_id | String | 微盟商戶id | |
public_account_id | String | 微盟商戶的公眾號(hào)id |
1.5 獲取商戶基本信息接口
PS:目前該api只返回商戶的pid,name,avatarUrl三個(gè)字段的信息。
請(qǐng)求方式GET
online： http://dopen.weimob.com/api/1_0/open/usercenter/getWeimobUserInfo?accesstoken={accesstoken}
返回?cái)?shù)據(jù)結(jié)構(gòu)：
{
"data": {
"pid": "55628727",
"name": "微盟開(kāi)放服務(wù)平臺(tái)",
"avatarUrl": "http://wx.qlogo.cn/mmopen/scAWiciaAIqhVtHQmXZmWBLbA08DEoHib20x5vHF818tG5zEf8BU6dGELnjibibdYeic1YlqlCdFP9dHVF8ibgTRdwjohEZWfJKB6zU/0"
},
"code": {
"errcode": 0,
"errmsg": "success"
}
}
類型 | 類型 | 返回value | 說(shuō)明 |
pid | string | 商戶公眾號(hào)id | |
name | string | 商戶公眾號(hào)名稱 | |
avatarUrl | string | 商戶公眾號(hào)頭像 |
13137631192
2794453937
chy@differsoft.com
掃一掃加微信好友
