支付宝小程序 获取会员信息
支付宝小程序 获取会员信息
[TOC]
1. 产品介绍
开发者可以通过国际标准的OAuth2.0授权机制,在用户授权的情况下,得到用于换取用户信息的令牌。在拿到用户的授权令牌后,通过调用用户信息共享接口,获取用户的公开信息。
1.1 准入条件
小程序开发者均可使用。
1.2 计费模式
不收费。
1.3 案例
步骤一:用户首次进入小程序首页,若无进行业务交互,则无需唤起会员授权
步骤二:当需要访问用户时,以弹框的形式确认授权(静默授权不弹窗)。建议:用户授权放在需要展示用户相关信息的环节,请勿一开始就引导授权。
步骤三:用户确认授权后,可以在该小程序的会员中心查看会员信息,授权完成。
2. 接入指引
2.1 添加“获取会员信息”功能
在小程序详情页的功能列表中添加“获取会员信息”。
2.2 客户端获取authcode
my.getAuthCode({
scopes: 'auth_user', // 主动授权:auth_user,静默授权:auth_base
success: (res) => {
if (res.authCode) {
// 认证成功
// 调用自己的服务端接口,让服务端进行后端的授权认证,并且种session,需要解决跨域问题
my.httpRequest({
url: 'http://isv.com/auth', // 该url是自己的服务地址,实现的功能是服务端拿到authcode去开放平台进行token验证
data: {
authcode: res.authcode
},
success: () => {
// 授权成功并且服务器端登录成功
},
fail: () => {
// 根据自己的业务场景来进行错误处理
},
});
}
},
});
2.3 服务端获取access_token
服务器端调用alipay.system.oauth.token接口换取授权访问令牌,开发者可通过获取到的auth_code换取access_token和用户ID。auth_code作为换取access_token的票据,每次用户授权完成,回调地址中的auth_code将不一样,auth_code只能使用一次,一天未被使用自动过期。具体可参见文档alipay.system.oauth.token。 开放平台服务端SDK的java调用示例如下:
AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");
AlipaySystemOauthTokenRequest request = new AlipaySystemOauthTokenRequest();
request.setGrantType("authorization_code");
request.setCode("4b203fe6c11548bcabd8da5bb087a83b");
request.setRefreshToken("201208134b203fe6c11548bcabd8da5bb087a83b");
AlipaySystemOauthTokenResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}
- 认证成功 把uid&token种到session中,在session有效期内就不需要每次都走授权平台进行验证。
- 认证失败 则返回失败原因,需要再重新走授权流程。
- 注意 如果仅是为了授权或获取用户ID,那么到此授权结束。
2.4 服务端获取会员信息
- 如果服务端要获取用户信息,那么不仅需要完成以上步骤——客户端获取authCode、authCode换取token,还需要token换取用户信息,该步骤需使用接口:alipay.user.info.share。
- 注意: 服务端获取的用户信息进行落库,jsapi获取的用户信息用来界面展示,不建议把前端获取到用户信息透传给服务端。 代码以java示例
AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");
AlipayUserInfoShareRequest request = new AlipayUserInfoShareRequest();
AlipayUserInfoShareResponse response = alipayClient.execute(request,accessToken);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}
2.5 客户端获取会员信息
前端通过 my.getAuthUserInfo 接口获得的用户信息主要是用来进行界面展示,如果想在数据库存储,请用上面步骤,服务器端接口调用流程进行获取用户信息。
my.getAuthCode({
scopes: 'auth_user',
success: (res) => {
my.getAuthUserInfo({
success: ({ nickName, avatar }) => {
console.log({ nickName, avatar })
}
});
},
});
返回字段:nickName, avatar
3. API列表
接口名称 | 描述 |
---|---|
my.getAuthCode | 获取用户授权码 |
alipay.system.oauth.token | 换取授权访问令牌 |
alipay.user.info.share | 服务端获取会员信息 |
my.getAuthUserInfo | 客户端获取会员信息 |
4. 补充说明
- 服务端获取不到会员信息
- 原因1:涉及到敏感信息如真实姓名、手机号、证件号等,这些敏感信息不会返回
- 原因2:调用的接口错误,请使用接口:alipay.user.info.share
- 获取会员信息,服务端报 isv.invalid-token 无效 token
- 原因1:获取授权码scope 必须传 auth_user
- 原因2:调用的接口错误,请使用接口:alipay.user.info.share
- 授权接入注意事项
- 授权登录安全建议
- RSA2签名验证工具 Mac版下载,Windows版下载
更多建议: