用户信息授权

VVChat

准备工作

h5应用VVChat登录是基于 OAuth2.0协议标准构建的OAuth2.0授权登录系统。

在进行VVChat OAuth2.0授权登录接入之前，在VVChat开放平台注册开发者帐号，并拥有一个已审核通过的应用，并获得相应的AppID和AppKey，申请VVChat登录且通过审核后，可开始接入流程。

授权流程说明

授权流程分三步：

  1. 第三方发起VVChat授权登录请求，VVChat用户允许授权第三方应用后，VVChat会拉起应用，并且带上授权临时票据code参数；

  2. 通过code参数加上AppID和AppKey等，通过API换取访问token；

  3. 通过token进行接口调用，获取用户基本数据资源或帮助用户实现基本操作。（根据scope的不同可以获取到不同的权限。）

第一步：请求CODE

在装有VVChatAPP里的手机浏览器里打开如下链接：

1
 
qyx://thirdlogin?app_id=test&scope=snsapi_userinfo&state=xxxxx&redirect_uri=http://xxxx.com
参数说明
参数 是否必须 说明
app_id 是 应用唯一ID，VVChat开发平台下发
scope 是 应用授权域，获取个人信息填写 snsapi_userinfo
state 否 用于保持请求与回调的状态，将原样返回第三方，该参数可以防止csrf攻击

用户点击授权后，VVChat客户端会被拉起，跳转至授权界面，用户在该界面点击允许或取消，将会调用redirect_uri将参数以查询参数（?code=xxxxx）的形式返回给调用方。

返回说明
返回值 说明
err_code 0：用户同意 ，其他代号都表示错误
code 授权code，用来后续换取token用
state 第三方传入的安全状态码
第二步：通过code获取token

参考 访问凭证接口

第三步：通过access_token调用接口
获取用户个人信息

参考 获取用户资料接口

VVChat支付

准备工作

在进行VVChat支付接入之前，在VVChat开放平台注册开发者帐号，并拥有一个已审核通过的应用，并获得相应的AppID和AppKey，申请VVChat支付且通过审核后，可开始接入流程。

支付流程说明

支付流程分三步：

  1. 商户调用统一下单接口获取到imprest_code

  2. 商户用imprest_code调起VVChat支付，用户确认支付后完成支付

  3. 商户后端将接收到支付通知

第一步：调用统一下单接口，得到imprest_code

统一下单接口

第二步：调起VVChat支付

在装有VVChat的手机的浏览器里打开如下链接：

1
 
qyx://qpay?imprest_code=IMPREST_CODE&app_id=APP_ID&redirect_uri=http://xxxx/xxx

参数说明

参数 说明
app_id 平台发放的app_id
imprest_code 调用统一下单获取到的imprest_code

返回说明

参数 说明
trade_no 平台发放的app_id
第三步：商户收取后端支付通知

请查看 统一下单接口的回调说明

VVChat客服

在装有VVChat的手机的浏览器里打开如下链接：

1
 
qyx://openSessionView?open_id=OPEN_ID

参数说明

参数 说明
open_id 客服的open_id

VVChat基础分享

分享后的内容显示的样式是固定的

准备工作

在进行VVChat基础接入之前，在VVChat开放平台注册开发者帐号，并拥有一个已审核通过的应用，并获得相应的AppID和AppKey，申请VVChat支付且通过审核后，可开始接入流程。

基础分享流程说明

基础分享流程分三步：

  1. 获取到要分享的内容

  2. 调起VVChat基础分享

  3. 分享完成的处理

第一步：设置要分享的内容
参数说明
参数 是否必须 说明
app_id 是 平台发放的app_id
share_title 是 分享标题
sub_title 否 分享副标题
share_url 是 分享的链接
thumb_url 否 预览图链接
redirect_uri 是 重定向地址
第二步：调起VVChat基础分享

在装有VVChat的手机的浏览器里打开如下链接：

1
 
qyx://share?app_id=APPID&share_title=ShareTitle&sub_title=SubTitle&share_url=https://xxxxxx/&thumb_url=http://xxxx/xxx&redirect_uri=https://xxxx/
第三步：调起方会收到分享结果的回调 包含回调完成的状态和信息

成功返回 200

参数 类型 参考值 说明
code int 200 状态码

错误返回 400

参数 类型 参考值 说明
code int 400 错误代号
err_msg string 请求失败！ 错误信息

VVChat高级分享

显示的内容是可变的

准备工作

在进行VVChat基础接入之前，在VVChat开放平台注册开发者帐号，并拥有一个已审核通过的应用，并获得相应的AppID和AppKey，申请VVChat支付且通过审核后，可开始接入流程。

基础分享流程说明

高级分享流程分三步：

  1. 获取到要分享的内容

  2. 调起VVChat高级分享

  3. 高级分享完成的处理

第一步：设置要分享的内容

参数说明

参数 是否必须 说明
app_id 是 平台发放的app_id
share_title 是 分享标题
sub_title 否 分享副标题
share_url 是 分享的链接
thumb_url 否 预览图链接
share_ data_url 否 {“tpl_header”: “vctalk”,”tpl_version”: “v1”,”tpl_type”:”MultipleLine”,”data”: [“内容1”,”内容2”]}
redirect_uri 是 重定向地址
第二步：调起VVChat高级分享

在装有VVChat的手机的浏览器里打开如下链接：

1
 
qyx://share?app_id=APPID&share_title=ShareTitle&sub_title=SubTitle&share_data_url=ShareDataUrl&share_url=https://xxxxxx/&thumb_url=http://xxxx/xxx&redirect_uri=https://xxxx/
第三步：调起方会收到分享结果的回调 包含回调完成的状态和信息

成功返回 200

参数 类型 参考值 说明
code int 200 状态码

错误返回 400

参数 类型 参考值 说明
code int 400 错误代号
err_msg string 请求失败！ 错误信息