vivo帐号第三方授权接入指南

根据您的不同业务场景需求，可以申请获取用户的基本信息（头像、昵称、性别、所在地）及手机号信息，让您更了解用户。

支持在手机、平板、电脑上接入vivo帐号服务。

② 如未申请开发者帐号，请先申请开发者帐号，并创建应用

③ 通过开放平台获取到appid（client_id）、对应的clientsecret等信息，具体参照位置如下：

添加混淆的应用需要添加以下方法防混淆sdk。

① 授权码模式/标准授权模式：功能最完整、流程最严密的授权模式。它的特点是通过客户端的后台服务器，与服务提供商认证的服务器进行互动。cp客户端通过授权sdk获取到code，cp服务器通过code获取accesstoken，cp服务器通过accesstoken获取用户信息。

② v2新增scope用于代表不同类型的权限，每种权限又分完全权限和不完全权限。完全权限：对应信息在授权页面默认勾选、不可取消，用户同意授权后开发者获得授权码可换取对应信息；不完全权限：对应信息在授权页面默认勾选、可取消，如取消勾选但用户同意授权，开发者不能换取对应信息;仅能和具有完全权限的信息一同发起请求。

具体使用图片，见附录

升级内容（相较于上一版本）

新增功能

2.去除imei采集

重要

1.接入时需要在开平重新申请appid

升级内容（相较于上一版本）

新增功能

安全优化

版本功能

新增功能

1.联系人权限去除

3.提供第三方应用获取vivo帐号信息功能

① APP

② H5/PC

添加混淆的应用需要添加以下方法防混淆sdk。

必要说明：

a) 授权码模式/标准授权模式：功能最完整、流程最严密的授权模式。它的特点是通过客户端的后台服务器，与服务提供商认证的服务器进行互动。cp客户端通过授权sdk获取到code，cp服务器通过code获取accesstoken，cp服务器通过accesstoken获取用户信息。

b) v2新增scope用于代表不同类型的权限，每种权限又分完全权限和不完全权限。

a) 初始化（app）

首先需要创建一个oauth对象，创建方法如下：

特别注意：

appid需要通过开平申请，reditUrl需要在申请appid的时候进行填写；

c) 应用客户端获取code

d) SDK目前提供的scope如下

注意：

i.目前只提供基础信息和手机号信息

ii.如果app申请的是不完全权限，则需要使用BASE_PHONE_USERINFO来申请手机号信息，不可单独入参手机号信息

•  代码示例

i.获取基础用户信息

ii.获取手机号信息

iii.获取基础信息&手机号信息

基本接入流程：

a) 申请APPID和APPKEY。

备注：以下接口由应用自己的服务器和vivo帐号服务器进行对接，都是post请求，要设置成表单形式提交，参数放在url后面即可。

接口说明

消息方向：应用服务器-》vivo帐号服务器

请求参数

示例：

入参

响应示例：

返回值含义如下

接口说明

调用方式：post

消息方向：应用服务器-》vivo帐号服务器

请求参数

示例：

入参

响应示例：

敏感信息的解密见附录

1.3 根据refreshToken获取新accessToken【服务器对接】

accessToken有效期是24小时，当accessToken过期后可用refreshToken获取新的accessToken和refreshToken，原来的accessToken和refreshToken失效。

接口说明

消息方向：应用服务器-》vivo帐号服务器

请求参数

示例：

响应示例：

接口说明

消息方向：应用服务器-》vivo帐号服务器

请求参数

示例：

响应示例：

返回码

a) 回调地址时需要注意以下事项：

•  填写的地址必须符合 URI 规范，填写后可以修改

•  请求传递的参数 redirect_uri，其域名部分可以是注册时填写的回调地址的同级或子域名，路径部分可以是同级或子路径，但是 SCHEME 和端口号必须相同

回调地址示例：

错误示例：

oauthResult返回码说明

提示

当应用每次调用接口时，接收回调之前都需要先解注册

1.生成待签名的字符串

在请求参数中，除去签名参数（即sign），把其它的参数按照字段的顺序排序，排序完成后再把所有的参数用&符号连接起来，这样就完成了待签名的字符串

2.签名

• 目前暂只支持MD5签名。MD5 是一种摘要生成算法，通过在签名原始串后加上第三方的CientSecret(接入前申请的APPKEY)密钥的内容，进行MD5运算，形成的摘要字符串即为签名结果。

• 可以使用提供的工具类把所有请求所求参数放到Map中生成paraMap，用第三方服务申请的client_id(接入前申请的APPID)对应的client_secret(接入前申请的APPKEY)作为签名密钥，调用PartnerSignUtil的sign方法生成生成签名作为参数放在url后即可

注意

如需MD5SignUtil，可在vivo开放平台-管理中心-应用分发-应用列表页-应用详情页-帐号服务获取

•  密文数据为获取用户接口返回的watermark字段，采用aes算法进行的加密