支付宝小程序 获取会员信息
支付宝小程序 获取会员信息
[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, avatar3. 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版下载