一、 简介
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 视为不同域，比如 https://vivo.juxuan.net/ 和 https://www.juxuan.net/
3. 请求传递的参数 redirectUri，其域名部分可以是注册时填写的回调地址的同级或子域名，路径部分可以是同级或子路径，但是 SCHEME 和端口号必须相同；
4. 授权码模式下，请求code步骤，回调地址是必填项。
回调地址示例
假设您申请时填写的回调地址是：https://vivo.juxuan.net/，vivo投放那么 redirectUri 的参数可以是：
https://vivo.juxuan.net/
https://www.juxuan.net/；
不可以是：
https://vivo.juxuan.net/? aa =1& bb =2 // SCHEME 不匹配。
四、接口详述
申请到APPID和APPKEY后，即可进行接入。账号的接口文档，vivo推广请查看快应用官网的账号接入文档：https://vivo.juxuan.net/
评论列表