概述

借用分享的流程，链接跳转对话的流程如下：

1. 网页js调用对接系统获取个人名片访问token

2. 对接系统通过调用gateway接口，获取个人名片访问token，并返回给网页

3. 网页js使用该token调用验证个人名片接口，客户端同时跳转个人对话窗口

发布历史

since 版本：

• 后台 0.14.0+
• 客户端 2.7.10+
• 2017.4.18 发布

涉及的接口

获取个人名片访问token

• 提供方：U聊服务端
• 发起方：接入系统

请求地址

/upchat-public-gateway/api/app/share/add

• 调用方式：HTTP POST
• 请求格式：application/x-www-form-urlencoded;charset=utf-8
• 请求编码：UTF-8

请求参数

属性	必填	说明
apikey		接口调用凭据
type		分享类型。个人名片:0
objectid		对象id。个人：userid
paras	否	场景参数

响应

• 响应格式：application/json;charset=UTF-8
• 响应编码：UTF-8
• 返回值：

属性	说明
status	应答码，0表示成功，非0时异常信息见msg
msg	异常信息
access_token	分享访问码
expires	分享过期时间，秒为单位。-1为永久有效

• 响应范例：

{    "status":"0",
      "msg":"成功",
      "access_token":"BkxvK25+sfvqeFGRnbLwN+0xMcB\/89TP61r8mtHJm9HbSEw1NrX4biKVerwRjOIKQ2F9nTFQrb463mgXnNvQ+Q=="
      "expires":604429
  }

访问个人名片，跳转。js接口

• 网页需引入库 app.upchat_1.1.js
• 接口：UPSharePlugin.validateShare(success,fail,opt)
• 用途：验证分享链接，跳转到相应的聊天窗口
• 参数：success 成功回调函数; fail 失败回调函数;opt: {access_token:token}
• 返回：success,fail回调
• 返回字段：
  • status：状态

    取值	说明
    0	成功
    1	已失效 这种情况需要给出重试的机制
    99	服务器内部错误