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