概述

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

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
• 请求参数：
  1. apikey: 接口调用凭据
     1. type：分享类型
     2. 0-个人名片
     3. objectid：对象id
        • 个人： userid
     4. paras：可选。场景参数

• 应答格式：application/json;charset=UTF-8
• 应答编码：UTF-8
• 应答数据：
  1. status：应答码，0表示成功，非0时异常信息见msg
  2. msg：异常信息；
  3. access_token：分享访问码
  4. 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服务器内部错误