微信小程序获取用户手机号需要企业小程序,个人小程序是无法获取到手机号的。我们先看看官方的解释。
获取手机号
获取微信用户绑定的手机号,需先调用wx.login接口。
因为需要用户主动触发才能发起获取手机号接口,所以该功能不由 API 来调用,需用 button 组件的点击来触发。
注意:目前该接口针对非个人开发者,且完成了认证的小程序开放(不包含海外主体)。需谨慎使用,若用户举报较多或被发现在不必要场景下使用,微信有权永久回收该小程序的该接口权限。
使用方法
需要将 button 组件 open-type
的值设置为 getPhoneNumber
,当用户点击并同意之后,可以通过 bindgetphonenumber
事件回调获取到微信服务器返回的加密数据, 然后在第三方服务端结合 session_key
以及 app_id
进行解密获取手机号。
注意
在回调中调用 wx.login 登录,可能会刷新登录态。此时服务器使用 code 换取的 sessionKey 不是加密时使用的 sessionKey,导致解密失败。建议开发者提前进行 login
;或者在回调中先使用 checkSession
进行登录态检查,避免 login
刷新登录态。
这是写在前端页面的,需要用按钮去触发这个功能。点击之后会获取到2个数据:encryptedData和 iv ,之后会用得到。
Markup
<button open-type="getPhoneNumber" bindgetphonenumber="getPhoneNumber"></button>
返回参数说明
参数 | 类型 | 说明 | 最低版本 |
---|---|---|---|
encryptedData | String | 包括敏感数据在内的完整用户信息的加密数据,详细见加密数据解密算法 | |
iv | String | 加密算法的初始向量,详细见加密数据解密算法 |
然后首先用wx.login获取code,用户有效凭证来换取用户的sessionKey和openid。换取sessionKey需要开发者在自己的服务端调用 auth.code2Session 这个方法。
用GET方式提交四个数据:
请求地址
Bash
GET https://api.weixin.qq.com/sns/jscode2session?appid=APPID&secret=SECRET&js_code=JSCODE&grant_type=authorization_code
请求参数
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
appid | string | 是 | 小程序 appId | |
secret | string | 是 | 小程序 appSecret | |
js_code | string | 是 | 登录时获取的 code | |
grant_type | string | 是 | 授权类型,此处只需填写 authorization_code |
其中 grant_type 不要我们管,我们只需填写小程序APPID,还有小程序密钥appSecret,再是wx.login获取的code。
得到sessionkey之后我们就能换取手机号了。我们先来整理一下我们获得了哪些数据以及最后换取手机号需要哪些数据。
首先是点击获取手机号的按钮得到的encryptedData和iv,然后是wx.login获取的code(最后一步获取手机号不需要),然后是用code换取的session_key,最后一步换取手机号就要这三个参数和小程序的APPID就可以了。
换取手机号需要在服务端操作,微信提供了示例的demo,可以点击下载,我用的是PHP版本的,你只需要传入对应的数据即可。
如图:
一切做好之后,就能在小程序端得到用户的手机号了。如下图:
countryCode是区号,phoneNumber是用户绑定的手机号(国外手机号会有区号),purePhoneNumber是没有区号的手机号。