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