1. 三方免登接口
提供给第三方免登跳转到轻筑的页面
注意
- 如果接口需要提供auth-token,你需要通过轻筑开放平台创建应用来获取appid和secret,然后通过appid和secret来获取接口访问凭证auth-token。
1.1. 1. 基本信息
概况 | 内容 |
---|---|
接口地址 | /api/platform/third/skip/auth |
请求方法 | POST |
请求数据类型 | JSON |
响应数据类型 | JSON |
1.2. 2. 请求数据
1.2.1. 请求头(request-header)
请求头除了默认的参数还需要添加如下请求头参数:
字段 | 描述 |
---|---|
auth-token | 接口访问凭据,你可以通过平台下发的appid和secret获取凭据 |
Content-Type | application/json;charset=UTF-8 |
1.2.2. 请求体(request-body)
字段 | 类型 | 是否必填 | 描述 |
---|---|---|---|
phone | string | 是 | 手机号(AES加密) |
type | number | 是 | 跳转类型(1、选择团队界面 2、轻筑团队菜单 3、轻筑团队第三方页面 4、项目大屏) |
projectId | string | 否 | 项目id |
enterpriseId | string | 否 | 企业id |
menuCode | string | 否 | 菜单编码(参考菜单编码字典)(跳转类型传1时不传,其他情况必传) |
showMenu | boolean | 否 | 是否不展示轻筑菜单 ture:是 ; false:否 默认 false |
必传字段说明:跳转类型为1时,只传必传字段;跳转类型为2、3时,projectId 和 enterpriseId 只能传入一个(根据菜单所属团队:企业或者项目填写);跳转类型为4时,projectId必传,enterpriseId不传。
AES加密算法特征:
参数 | 说明 |
---|---|
算法密钥 | secret |
编码方式 | UTF8 |
加密模式 | CBC |
填充 | Pkcs7padding |
数据块 | 128 |
偏移量 | 密钥的前 16 位字符 |
菜单编码字典:
菜单编码 | 所属企业/项目 | 页面归属 | 菜单名称 |
---|---|---|---|
shijiu_P1001 | 项目 | WEB端 | 安全资料汇总* |
shijiu_P1002 | 项目 | WEB端 | 质量资料汇总* |
shijiu_P1003 | 项目 | WEB端 | 环保资料汇总* |
shijiu_P1004 | 项目 | WEB端 | 工程资料汇总*-进度 |
shijiu_P1005 | 项目 | WEB端 | 工程资料汇总*-组织 |
shijiu_P1006 | 项目 | WEB端 | 技术资料汇总* |
shijiu_P1007 | 项目 | WEB端 | 设备资料汇总* |
screen_P1001 | 项目 | 大屏端 | 项目大屏-首页 |
screen_P1002 | 项目 | 大屏端 | 项目大屏-项目概况 |
screen_P1003 | 项目 | 大屏端 | 项目大屏-实名制 |
screen_P1004 | 项目 | 大屏端 | 项目大屏-视频监控 |
screen_P1005 | 项目 | 大屏端 | 项目大屏-物联监测 |
screen_P1006 | 项目 | 大屏端 | 项目大屏-环境监测 |
screen_P1007 | 项目 | 大屏端 | 项目大屏-安全质量 |
screen_P1008 | 项目 | 大屏端 | 项目大屏-施工日志 |
1.3. 3. 响应数据
接口调用成功后会自动跳转到指定页面。
1.4. 4. 错误码
当返回数据中的 code 不为 0 时,为错误返回。其中errCode为详细的错误码。