扫码登录第三方网站

当您开发了一个独立的网站，但是希望用户以U聊的账号登录您的网站时，可以通过u聊扫码方式实现免密登录此网站。（注意此网站并不是U聊客户端内使用的应用）

1. 网站生成登录二维码

点击U聊登录，网页生成登录二维码，图示如下

2. 手机扫码确认登录

U聊手机用户打开U聊，扫描二维码；然后点击登录确认，此时U聊后台会返回当前手机的用户信息 网站页面将返回的用户信息回传给网页的后台

3. 网站后台模拟登录过程

网站后台根据页面回传的用户信息，模拟登录过程，完成安全登录。

生成二维码token接口

平台网页调用，获取生成二维码的token。

• 提供方：U聊服务端

• 发起方：第三方网站前端

请求地址

/upchat-public-gateway/api/login/gettoken

• 调用方式：HTTP POST

• 请求格式：application/x-www-form-urlencoded;charset=utf-8

• 请求编码：UTF-8

请求参数：

• apikey：消息发送凭据

响应

• 响应格式：application/json;charset=UTF-8

• 响应编码：UTF-8

• 返回值：

  属性	说明
  status	应答码，0表示成功，非0时异常信息见msg
  msg	异常信息
  token	生成二维码的token

  响应范例：

  {
    "status": "0",
    "msg": "成功",
    "token": "upchat-web-login-public-2ecccb5c-25c0-4c3c-8744-7d195a2ca60c"
  }
  

获取扫码同状态接口

• 提供方：U聊服务端

• 发起方：第三方网站前端

请求地址

/upchat-public-gateway/api/login/getstep

• 调用方式：HTTP POST

• 请求格式：application/x-www-form-urlencoded;charset=utf-8

• 请求编码：UTF-8

请求参数：

属性	说明
apikey	消息发送凭据
token	登录的token值

响应

• 响应格式：application/json;charset=UTF-8

• 响应编码：UTF-8

• 返回值：

  属性	说明
  status	应答码，0表示成功，非0时异常信息见msg
  msg	返回结果,结果中包含用户登陆id以及登陆时间
  step	扫码同步状态

数详细说明：

• step

  取值	说明
  0	未扫描
  1	已扫描未确认
  2	已确认
  3	网页已登录
  4	扫描未确认超时

响应范例：

{
   "status":"0",
   "msg":"user[userid], login in time[time] success!",
   "step":"2"
}