开发指南

微信C端授权文档


对接前,请先登录微盟后台,进入新版开发者中心,创建应用,获取client_id、client_secret、配置redirect_uri。


说明:

1、当商户公众号是认证服务号时,用户信息直接授权给对应的公众号;当商户公众号不是认证服务号时,用户信息授权给微盟“旺铺”公众号,并由“旺铺”公众号与商户公众号形成映射关系,将相应信息传递给商户公众号。

2、仅认证服务号可获取到微信用户的OpenID、头像、性别等,其他账号类型(包括认证/未认证订阅号、未认证服务号)可正常获取到除OpenID外的其他信息。 


1. 1 创建授权请求,获取code

请求地址:https://dopen.weimob.com/fuwu/c/oauth2/authorize?enter=wx&view=wx&aid= {aid} &response_type=code&scope=default&client_id={clinet_id}&redirect_uri={http://xxx}&state={state}

说明:只能在微信客户端发起授权请求。


参数说明:

参数名称 是否必须 参数可能值 参数说明
client_id 第三方应用id
aid 商户aid
response_type code 授权类型 ,值为code。
state 可选 自定义信息
redirect_uri 填写在开放平台注册时的回调地址 redirect_uri指的是第三方应用发起请求时,所传的回调地址参数,在用户授权后应用会跳转至redirect_uri
scope 默认default,认证权限范围。


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

说明:当商户公众号是认证服务号时,用户信息直接授权给对应的公众号;当商户公众号不是认证服务号时,用户信息授权给微盟“旺铺”公众号,并由“旺铺”公众号与商户公众号形成映射关系,将相应信息传递给商户公众号。


C端授权页面如下:


1.3 换取access_token

成功获取授权码code后,可以以此进行换取access_token,

请求方式:POST

请求地址:https://dopen.weimob.com/fuwu/c/oauth2/token?code={code}&grant_type=authorization_code&client_id={client_id}&client_secret={client_secret}&redirect_uri={http://xxx}


名称 是否必选 参数值 参数释义
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 Access token过期时间(表示7200秒后过期)
refresh_token string Refresh token,可用来刷新access_token
refresh_token_expires_in number 默认7天 Refresh token有效期
scope String 默认default 授权范围
weimobUserId String 微盟用户id
weimobOpenId String 微盟用户openId
openId String 微信openId


1.4 刷新accees_token

通过授权获取的refresh_token,可用来刷新access token的有效时长。

请求方式:POST

请求地址:http://dopen.weimob.com/fuwu/c/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 Access token过期时间(表示7200秒后过期)
refresh_token string Refresh token,可用来刷新access_token
refresh_token_expires_in number 默认7天 Refresh token有效期
scope String 默认default 授权范围
weimobUserId String 微盟用户id
weimobOpenId String 微盟用户openId
openId String 微信openId


1.5 获取微信用户API:

请求方式:POST

请求地址:https://dopen.weimob.com/c/api/1_0/oauthcenter/session/getuserinfo?accesstoken={上一步授权成功后的access_token}


返回结果:

{

"code": {

"errcode": 0,

"errmsg": "success"

},

"exp": null,

"data": {

"AId": 670,

"WeimobOpenId": "oAshwimwkoh57iYJtkgh-G7k_BH",

"OpenId": "oka-Fb7hW2_bdWSMBHNTk77ZIhsD",

"NickName": "月牙",

"Sex": "2",

"Province": "上海",

"City": "宝山",

"Country": "中国",

"HeadimgUrl":"http://wx.qlogo.cn/mmopen/91WsEk2G56iatjDLib35N9DuNzLA4hrN2jDJXGhbnPAic7jPjgxO6jMvjcS0nftpOibOycNTu0q2FQYw/0"

}

}


data数据说明:

返回key 类型 说明
AId string 商户aid
WeimobOpenId string 微盟用户openId
OpenId string 微信用户id
NickName string 微信用户昵称
Sex string 微信用户性别(1:男 2:女)
Province String 微信用户省份
City String 微信用户城市
Country String 微信用户国家
HeadimgUrl String 微信用户头像


售前咨询热线

10105188

在线QQ咨询

关注微盟

扫描关注官方微信

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

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

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