v6.8.3及之前版本

1、用户凭证

1.1、获取用户凭证

• 接口规范

  Request Method：POST
  Content-Type：application/json;charset=UTF-8
  Request URL：{http}://{ip}:{port}/{lczServer}/oapi/privilege/getUserAuthId

• 请求参数

请求体格式：

{
  "header": {
    "contentType": "${contentType}",
    "privilege_type": "${privilege_type}",
    "validateVariants": "${validateVariants}",
    "v": "${v}"
  }
}

参数说明

• 返回结果

成功时的返回格式：

{
  "success": true,
  "content": {
    "authId":"",   //用户令牌
    "createTime":0,  //令牌创建时间
    "expiresTime":0, //令牌失效时间
    "refreshToken":""  //用于令牌刷新（只能用一次）
    }
}

出错时返回格式：

{
  "success":false,
  "code":"错误码",
  "msg":"错误信息"
}

1.1.1、认证参数示例

1.1.1.1、明文方式传参

{
  "header": {
    "contentType": "JSON",
    "privilege_type": "LczCloudFormTest",
    "validateVariants": "openId=123;clientId=123;test_Mode=1;access_token=abc;userName=testUser;userAlias=测试用户;orgName=zjsj;orgAlias=浙江税局"
  }
}

1.1.1.2、密文方式传参

{
  "header": {
    "contentType": "JSON",
    "privilege_type": "LczCloudFormTest",
    "v": "dmFsaWRhdGVWYXJpYW50cyUzRG9wZW5JZCUzRDEyMyUzQmNsaWVudElkJTNEMTIzJTNCdGVzdF9Nb2RlJTNEMSUzQmFjY2Vzc190b2tlbiUzRGFiYyUzQnVzZXJOYW1lJTNEdGVzdFVzZXIlM0J1c2VyQWxpYXMlM0QldTZENEIldThCRDUldTc1MjgldTYyMzclM0JvcmdOYW1lJTNEempzaiUzQm9yZ0FsaWFzJTNEJXU2RDU5JXU2QzVGJXU3QTBFJXU1QzQw"
  }
}

加密的原始字符串

validateVariants=openId=123;clientId=123;test_Mode=1;access_token=abc;userName=testUser;userAlias=测试用户;orgName=zjsj;orgAlias=浙江税局

1.2、验证用户凭证

• 接口规范

  Request Method：GET
  Request URL：{http}://{ip}:{port}/{lczServer}/oapi/authId/check/{authId}

• 请求参数

参数说明

• 返回结果

成功时的返回格式：

{
  "success": true,
  "content": {
    "expiresTime":0,  //失效时间
    "timeExpireAfter":0, //多少时间之后过期
    "checkSuccess":false //是否失效
    }
}

出错时返回格式：

{
  "success":false,
  "code":"错误码",
  "msg":"错误信息"
}

1.3、刷新用户凭证

• 接口规范

  Request Method：POST
  Content-Type：application/json;charset=UTF-8
  Request URL：{http}://{ip}:{port}/{lczServer}/oapi/authId/refresh

• 请求参数

请求体格式：

{
  "header": {
    "contentType": "${contentType}",
    "authId": "${authId}"
  },
   "requestBody": {
        "refreshToken":"${refreshToken}"  
  }
}

参数说明

• 返回结果

成功时的返回格式：

{
  "success": true,
  "content": {
    "authId":"",   //用户令牌
    "createTime":0,  //令牌创建时间
    "expiresTime":0, //令牌失效时间
    "refreshToken":""  //用于令牌刷新
    }
}

出错时返回格式：

{
  "success":false,
  "code":"错误码",
  "msg":"错误信息"
}

1.4、更新虚拟用户信息

• 接口规范

  Request Method：POST
  Content-Type：application/json;charset=UTF-8
  Request URL：{http}://{ip}:{port}/{lczServer}/oapi/auth/user/update

• 请求参数

请求体格式：

{
        "header": {
             "contentType": "${contentType}",
            "authId": "${authId}"
        },
        "requestBody": {
        "userAlias": "用户显示名称",
        "jobNumber": "用户工号",
        "orgName": "用户所属组织名称",
        "orgAlias": "用户所属组织显示名称",
        "orgNumber": "组织工号",
        "roleNames": ["用户角色"],
        "roleAlias": ["用户角色显示名称"],
        "dingId": "用户钉钉id",
        "weCorpId": "用户企业微信Id",
    "paramInfos":[
                {
          "name":"参数名称",
            "value":"参数值"
        }
     ]
  }
}

参数说明

• 返回结果

成功时的返回格式：

{
    "success": true
}

出错时返回格式：

{
  "success":false,
  "code":"错误码",
  "msg":"错误信息"
}

2 访问发布后的大屏

2.1 通过匿名身份的方式访问

页面访问规范

Request Method：GET
Request URL：{http}://{ip}:{port}/{lczServer}/lczMatrix/index.html#/publish/{releaseId}

releaseId:发布后的唯一访问key

注意

1. 此模式只有在系统开启了允许匿名访问的情况下才支持
2. 此模式下，因为无用户身份，所以不支持不同用户访问时，数据权限范围不一样的需求

2.2 通过指定用户凭证的方式访问

页面访问规范

Request Method：GET
Request URL：{http}://{ip}:{port}/{lczServer}/lczMatrix/index.html#/publish/{releaseId}/{auth}

请求参数

注意！
参数的格式如果是字符串对象，必须先用base64编码,再进行URLEncode编码。
以java为例：
String auth = “{"authId": "124557abc"}”;
auth = URLEncoder.encode(new BASE64Encoder().encode(auth.getBytes(“UTF-8”)),”UTF-8”)

2.3 通过指定认证的方式访问

2.3.1 标准方式

Request Method：GET
Request URL：{http}://{ip}:{port}/{lczServer}/lczMatrix/index.html#/publish/{releaseId}/{auth}

2.3.1.1 明文方式请求参数

2.3.1.2 密文方式请求参数

2.3.2 参数化方式

V6.8.2版本开始支持通过此方式访问数智大屏发布文件。

Request Method：GET
Request URL：{http}://{ip}:{port}/{lczServer}/lczMatrix/index.html#/publish/{releaseId}?authId=xxxx&privilege_type=xxxx&validateVariants=xxxxx&v=xxx&其他扩展参数

releaseId:发布后的唯一访问key

注意：以下参数值都需求进行URLEncode编码。

2.3.2.1 明文方式请求参数

2.3.2.2 密文方式请求参数

3 访问大屏管理页面

大屏管理页面访问规范

Request Method：GET
Request URL：{http}://{ip}:{port}/{lczServer}/lczMatrix/index.html#/{targetVolume}/{auth}

3.1 通过指定用户凭证的方式访问

请求参数

3.2 通过指定认证的方式访问

请求参数

4 访问大屏设计文件

页面访问规范

Request Method：GET
Request URL：{http}://{ip}:{port}/{lczServer}/lczMatrix/index.html#/design/{fileName}/{targetVolume}/{auth}

4.1 通过指定用户凭证的方式访问

请求参数

4.2 通过指定认证的方式访问

请求参数