开发指南

C/S架构授权文档



由于C/S架构的应用无法发起基于浏览器的授权,因此需要进入微盟服务商中心/商户开发者中心的授权按钮完成发起授权操作,点击开发者中心的授权按钮,将访问如下地址。


1、online环境地址:

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}


参数说明:

参数名称 是否必须  参数可能值 参数说明
enter wm 授权入口类型
client_id 创建应用时获得的id
response_type code 授权类型 ,值为code
state 可选 自定义信息
redirect_uri 填写在开放平台注册时的回调地址 

redirect_uri指的是第三方应用发起请求时,

所传的回调地址参数,在用户授权后应用会跳转至redirect_uri 

scope 默认default,认证权限范围。


1.1 获取code
上一步完成后,会引导用户进入到微盟开放平台Oauth2授权页面,点击授权此时会将授权码code 返回到了回调地址(上一步骤中的redirect_uri),应用可以获取并使用该code去换取access_token。
成功后跳转到redirect_uri?code=xxx&state=state


1.2 换取access_token
成功获取授权码code后,可以以此进行换取access_token,
online环境请求地址:
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.3 刷新accees_token
通过授权获取的refresh_token,可用来刷新access token 的有效时长。
online环境地址: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.4授权完成
完成以上流程后,C/S架构的应用需要自身根据一定的查询方式获取到上部获取到的access_token。
获取商户基本信息接口
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"
}
}

返回key 类型 返回value 说明
pid string     商户公众号id
name string 商户公众号名称
avatarUrl    string 商户公众号头像

售前咨询热线

10105188

在线QQ咨询

关注微盟

扫描关注官方微信

总部咨询热线:10105188 QQ:4006305400 邮箱:feedback@weimob.com 举报电话:02180356016

地址:上海市宝山区长江路258号微盟大厦

Copyright © 2011-2018 yun.weimob.com. All Rights Reserved 上海微盟企业发展有限公司版权所有 沪ICP备17019238号-1