跳转至

授权用户登录

接口说明:

通过此接口为方便客户方实现用户免登录功能,可以直接跳转到众趣方订单列表页或者编辑详情页

请求路径:

{HostName}/api/v2/op/openapi/third_login/

请求方式:

  • POST

入参示例

{
    "hid": "房源id", 
    "uid": "2834",
    "token": "gAAAAABjrT7r62j-JaLHeVT1TE5nUaLzg8IKOFImkrwZkEphfHQaaLfu5dahRLJD25a3cqXseLSSDidqr8yXhEQ6JjEMZUMlI-UMBrwWP1bixBSLlzEvN4os-7IZwPMfoPFqkGVJ5tNzj57uLe1LZfvBaQbEUmJoA6f6SDgVAJiDfPDFzGTdXDi8O22TlW2ohONcf9p8ulRZ8dVTEqo1lPDp-6ft2OuUAnl20balc4IoUtXAFpzzCur7Uax7mXUDpD4UFsbNRmRx",
}
  • 通过账号创建或者后台系统接口获取用户 uid,详情请参考账号创建接口
  • 使用方式:客户获取 单点登录token根据需求直接加载/跳转链接,附带示例参数

前置条件

使用本接口前,需要先通过获取单点登录token接口获取到单点登录token,将其作为本接口的token参数传入。

传入参数字段及含义:

字段名 类型 是否必传 含义
hid string 房源id
uid string 用户id
token string 校验token
jump_page string 跳转的编辑页面
注意:

hid

  • hid是接入方与众趣模型一一对应的资源的唯一id。可能是接入方拍摄任务的id,接入方房源id等等,不一而足。
  • hid 传参时会跳转到模型编辑页面,不传参数时,会跳转到列表

jump_page

  • 可选参数,默认值为floorplan
  • jump_page=floorplan时,跳转到户型图编辑页
  • jump_page=scene_manage时,跳转到实勘图编辑页

响应参数示例

{
    "msg": "success",
    "code": 1,
    "data":{
        "url":"{HostName}openapi/third_login/?b'fac97adc9305d064934cba5b4ba8e2562f0ed4b26098cd77c6b0144f3fba8ed0f2fa6ab27c9ce86f691356c84dc22897586b19419dd28248661202517530d8a4fd98af8edc16ca746c90f09d'"
    }
}

响应参数字段及义:

字段名 类型 是否必传 含义
msg string 响应状态描述
code int 响应状态码
data object 返回跳转连接

实例请求

window.open(res.data.url)

注意:需要前端使用js打开连接地址实现跳转

消息码code取值及说明:

code值 说明
1 成功
-1 失败
32000 签名校验失败
31000 不支持当前请求的版本
37012 当前token与用户不匹配
32002 token超时
32004 token校验失败