《微信小程序开发从入门到实战》学习五十九

6.2 账号信息API

账号信息API包括登录API、用户信息API和小程序账号信息API。

通过它们可以获取用户的微信账号信息或小程序的AppID。

6.2.1 登录API

使用云开发技术实现服务端功能时，微信可以帮助开发者对小程序用户做鉴权。

当小程序需要接入自研的服务端时，需要开发者自己实现小程序用户的权限验证。

小程序可以使用wx.login接口获取登录的凭证，小程序端将登录凭证发送至服务端，再由服务端对接微信后台实现鉴权。小程序端代码如下：

????wx.login({

??????success(res)?{

????????if?(res.code)?{

??????????//?发起网络请求，将登录凭证code发送给服务端

??????????wx.request({

????????????url:?'https://test.com/onLogin',

????????????data:?{

??????????????code:?res.code

????????????}

??????????})

????????}?else?{

??????????console.log('登录失败，'+res.errMsg)

????????}

??????}

????})

wx.login获得的用户登录状态有时效性。具体失效逻辑由微信维护，对开发者透明。开发者需要调用wx.checkSession接口检测当前用户登录状态是否有效。代码如下：

wx.checkSession({

??????success(){

????????//?session_key未过期，并且在本生命周期一直有效

??????},

??????fail(){

????????//?session_key已经失效，需要重新执行登录流程

????????wx.login() // 重新登录

??????}

????})

6.2.2 用户信息API

wx.getUserInfo接口可以获取用户信息，使用该接口前，需要先对获取用户信息这一操作向用户发起授权请求，即让用户单击包含open-type="getUserInfo"属性的button按钮。用户同意授权后，就可以直接调用wx.getUserInfo接口了。

wx.getUserInfo接口传入了Object类型的参数，参数的有效属性包含boolean类型的withCredentials，string类型的lang，和三个回调函数success，fail,还有complete。代码如下：

????wx.getUserInfo({

??????withCredentials:?false,?//?是否返回加密信息，非必填，默认false

??????lang:?'zh_CN',?//?显示用户信息的语言，非必填，可选值为en、zh_CN、zh_TW,默认为en

??????success:?function(res)?{?//?接口调用成功的回调函数

????????//?res中包含用户信息

????????const?userInfo?=?res.userInfo?//?用户信息对象，不包含?openid等敏感信息

????????const?nickName?=?userInfo.nickName?//?微信昵称

????????const?avatarUrl?=?userInfo.avatarUrl?//?微信头像图片URL

????????const?gender?=?userInfo.gender?//?性别?0?：未知，1:男，2；女

????????const?province?=?userInfo.province?//?省份

????????const?city?=?userInfo.city?//?城市

????????const?country?=?userInfo.country?//?国家

??????}

????})

------

如果希望通过该接口获得用户openid，则需要设置withCredentials为true。

此时，要求之前有调用过wx.login接口，且登录状态未过期，相关代码如下：

????wx.login({

??????success:?(r)?=>?{

????????if?(r.code)?{?????????

??????????wx.getUserInfo({

????????????withCredentials:?true,?

????????????success:?function(res)?{?

??????????????const?userInfo?=?res.userInfo?//?用户信息对象，不包含?openid等敏感信息

??????????????//?将登录凭证、加密数据和加密向量发送给服务端，服务端解密数据后获取

??????????????wx.request({

????????????????url:?'https://test.com/onLogin',

????????????????data:?{

??????????????????code:?r.code,?//?登录凭证

??????????????????encryptedData:?res.encryptedData,?//?加密数据

??????????????????iv:?res.iv?//?加密向量

????????????????},

????????????????success(response){

??????????????????//?服务端可能会返回一些内容，在这里进行处理

????????????????}

??????????????})

????????????}

??????????})

????????}

??????},

????})