有奖捉虫:办公协同&微信生态&物联网文档专题 HOT

步骤一:权限申请

向会议侧提交使用申请,并提供弹窗内的自定义文案内容(用于向用户端展示获取手机号的原因)。

步骤二:JS-API 获取手机号动态 Code

JS-API接口:data.getPhoneNumber
支持的版本:3.11.0
是否需要鉴权:需要,权限开启:获取用户的手机号。

参数说明

输入参数

参数名称
参数类型
参数描述
success
Function
授权成功回调函数。
fail
Function
授权失败回调函数。

输出参数

参数名称
参数类型
参数描述
code
Int
错误码。
message
String
错误信息。
token
String
动态令牌,可通过 RestApi 接口换取用户手机号;有效期5min,只能消费一次。
code
success := 0 成功
cancel := 1 取消
message
success := "success" 成功
cancel := "get auto_code is canceled" 取消

示例

import * as wemeet from '@tencent/wemeet-js-sdk';
wemeet.data.getPhoneNumber({
success: ({ code, message, token }) => {
// handler
},
fail: ({ code, message }) => {
// handler
},
}).catch(e => console.error(e));


步骤三:RestApi 通过手机号动态 Code 换取手机号

接口描述: 通过 RestApi,使用 token 向后台换取手机号。
调用方式: Get
接口请求域名:
https://api.meeting.qq.com/v1/user/info/phonenumber

输入参数

HTTP 请求头公共参数参见:第三方应用鉴权(OAuth2.0)
参数名称
是否必填
参数类型
参数描述
token
String
动态令牌,可通过 JS-API 接口获取;有效期5min,只能消费一次。

输出参数

参数名称
是否必填
参数类型
phone_info
Object
phone_info:
参数名称
是否必填
参数类型
参数描述
phone_number
String
用户的手机号。
country_code
String
手机号区号。

错误码

错误码
说明
3501
未开启获取授权手机号的权限点。
3502
获取授权手机号服务异常。
3506
超过获取授权手机号动态令牌的最大频率。
3507
授权手机号的动态令牌非法。

必读注意事项

建议通过单击登录绑定手机号等交互方式引导触发接口调用,避免违反符合用户预期。否则可能无法通过应用市场审核。
仅3.11.0之后的版本支持该接口,需要处理新老版本兼容逻辑。