【平台介绍】
微盟隶属于上海晖硕信息科技有限公司,国内领先的微信开发服务商。从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 | 商户公众号头像 |