vivo搜索投放快应用账号接入文档

一、 简介

1.1 目的

本文档描述了快应用接入vivo账号的整体流程和规范。

1.2 预期的读者和阅读建议

包括但不限于第三方服务系统开发人员、测试人员、产品经理。

1.3 缩略语和术语

缩略语/术语	全称	说明
clientid	第三方服务ID	client_id是vivo标识对第三方的唯一性标识，就是在接入前申请的appid做为clientid
clientsecret	第三方服务密钥	第三方访问vivo的密钥，用于签名，不能在公网中传输，在接入前申请的appkey做为clientsecret
accesstoken	访问令牌	在用户授权许可下，授权服务器下发给客户端的一个授权凭证，可以用access token获取用户授权的信息
refreshtoken	刷新令牌	刷新令牌的作用在于更新访问令牌，访问令牌的有效期一般较短，这样在访问令牌失效时，可以利用刷新令牌去授权服务器换取新的访问令牌，是否需要该令牌是由第三方自行选择
redirectUri	回调地址	授权模式下请求code时，用回调地址请求vivo服务器进行校验
scope		scope 可以看做是一个集合，包含一个权限的 ID，名称，以及描述信息等，比如“获取您的基本资料（头像、昵称）

接入vivo第三方授权之前，通过vivo申请第三方服务ID和第三方服务密钥。

二、申请APPID和APPKEY

1、 进入vivo开放平台——管理中心——快应用——快应用服务——账号服务

2、选择已有快应用或新建快应用草稿

3、 填写回调地址提交成功后生成APPID和APPKEY，vivo信息流接口参数与回调地址在vivo账号服务页面查看与修改

三、注意事项

回调地址

回调地址不用做传递参数，仅用于校验，要求调用联盟接口传的地址域名和注册到开放平台的一致。vivo广告返回值直接通过接口返回，不使用回调地址。回调地址时需要注意以下事项：

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

2. HTTP 和 HTTPS 视为不同域，比如 和

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

4. 授权码模式下，请求code步骤，回调地址是必填项。

回调地址示例

假设您申请时填写的回调地址是：，vivo投放那么 redirectUri 的参数可以是：

；

不可以是：

https://vivo.net/? aa =1& bb =2 // SCHEME 不匹配。

四、接口详述

申请到APPID和APPKEY后，即可进行接入。账号的接口文档，vivo推广请查看快应用官网的账号接入文档：