手机号获取能力介绍

一、手机号获取流程

调用此接口，vivo会将经过用户同意授权的手机号码返回给开发者。vivo推广同时可支持开发者选择返回的手机号码是否加密。

二、客户端页面显示

1、用户可选择使用vivo帐号绑定的手机号码或手动输入其他手机号进行授权：

当前设备已登录有绑定手机号的vivo帐号则显示如图1

当前设备未登录有绑定手机号的vivo帐号则显示如图2

2、选择使用其他手机号码：

vivo会引导用户输入手机号码，通过手机短信验证码验证有效性，vivo搜索并将验证通过的手机号码返回给开发者，客户端页面显示如下：

手机号获取接入指南

一、申请入口

1，注册为vivo开发者用户，vivo投放并且创建上传好快应用。

注册地址：https://vivo.juxuan.net/，应用创建流程请参见文档。

2，登录vivo开放平台，在管理中心找到快应用，vivo信息流推广点击进入快应用服务后选择：帐号服务。如下图：

二、申请手机号获取能力

点击申请账号服务后进入申请页面：

申请流程三部分：vivo推广怎么做填写基本资料--签署保密协议--填写个人信息保护风险评估表

1、填写基本信息

选择需要接入手机号授权能力的快应用，选择是否获取手机号码

（特别说明：手机号为用户敏感信息，因此开通该能力需开发者企业具备一定的资质。vivo推广怎么收费非强需求的开发者不建议申请该能力，开通后需谨慎使用。）

2、签署保密协议

请仔细阅读协议内容，勾选：vivo推广登录入口已阅读并同意签署此合同后点击签署合同并继续。

3、填写个人信息保护风险评估表

手机号码为用户敏感数据信息，为确保信息安全，vivo信息流请您根据企业实际情况认真填写个人信息保护风险评估表中的内容。

（公司员工人数及表中6项内容均为必填项）

4、完成以上3步，提交成功后，vivo平台会在1-2个工作日内完成审核。

审核通过后，请按照接口文档相关说明完成技术对接。

手机号码获取接口介绍1.0

一、快应用厂商服务中账号功能介绍

1.1 能力介绍

快应用厂商提供账号授权和用户信息获取的能力，可以一键授权登录vivo当前系统帐号，并获取用户的头像和昵称。具体可以参考快应用官方文档：https://vivo.juxuan.net/

二、新增账号接口getPhoneNuber介绍

2.1 接口定义

account.getPhoneNumber()：请求获取当前用户同意授权的手机号码

2.2 权限要求

1，手机号码为用户敏感数据，因此在使用此接口之前需要在开放平台完成申请，审核通过后才可获取用户的手机号码。

开放平台申请能力将在近期开放，敬请期待！

2，调用此接口时需要有明显的用户认知引导，比如通过button组件的点击来触发。且每次请求时，都需要用户弹窗确认。

3，使用该接口能力时，发布于vivo平台的快应用的最小平台版本号必须要限定为1053，并且只能在vivo手机上使用这个接口，否则会导致使用异常。

2.3 参数：

2.4 success 返回值：

2.5 fail 返回错误代码

注：审核通过后，使用时若返回1001，vivo搜索可以清除引擎数据后进行重试。

清除引擎数据路径：系统设置—更多设置—应用管理—右上角更多—显示系统进程—选择快应用—存储—清除数据

2.6 示例

手机号解密1.0

一、解密密钥appKey获取

vivo开放平台给每个开发者帐号、每一个快应用分配一个独立的secret密钥，用来做手机号解密操作。开发者可登录开放平台，vivo投放进入：快应用--账号服务，在接入记录中找到对应的快应用，在接入参数中获取secret，如下图：

二、解密计算方法

解密方式使用DES，vivo信息流通过开放平台账号服务获取对应快应用 的appKey 进行解密 。

代码示例如下：