授权用户登录
接口说明:
通过此接口为方便客户方实现用户免登录功能,可以直接跳转到众趣方订单列表页或者编辑详情页
请求路径:
{HostName}/api/v2/op/openapi/third_login/
请求方式:
- POST
入参示例
{
"hid": "房源id",
"uid": "2834",
"token": "gAAAAABjrT7r62j-JaLHeVT1TE5nUaLzg8IKOFImkrwZkEphfHQaaLfu5dahRLJD25a3cqXseLSSDidqr8yXhEQ6JjEMZUMlI-UMBrwWP1bixBSLlzEvN4os-7IZwPMfoPFqkGVJ5tNzj57uLe1LZfvBaQbEUmJoA6f6SDgVAJiDfPDFzGTdXDi8O22TlW2ohONcf9p8ulRZ8dVTEqo1lPDp-6ft2OuUAnl20balc4IoUtXAFpzzCur7Uax7mXUDpD4UFsbNRmRx",
}
前置条件
使用本接口前,需要先通过获取单点登录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校验失败 |