跳到主要内容
版本：5.9.0

仪表板相关API

1. 仪表板相关API 概述​

Public API，是指观远数据为系统集成提供的标准化开放接口。系统集成，通常是指将各个分离的设备(如个人电脑)、系统、功能和信息等集成到相互关联的、统一和协调的系统之中，使资源达到充分共享，实现集中、高效、便利的管理。系统集成实现的关键在于解决系统之间的互连和互操作性问题，是一个多厂商、多协议和面向各种应用的体系结构。

观远数据提供一套简便的验证机制，来供私有化部署用户进行外部系统和账户对接集成，实现集中、高效、便利的管理。本文将为您详细介绍观远数据为您提供的与仪表板相关的 Public API。

2. 仪表板相关API 列表速览​

目前，与仪表板相关的 Public API 共包含4个，列表如下：

序号接口描述PATH
1获取页面列表POST /public-api/page/list
2搜索页面POST /public-api/page/search?q=xx&&offset=0&&limit=10
3获取指定页面有读权限的用户列表POST /public-api/page/:pgId/get-readable-owners
4以树状结构获取页面列表POST /public-api/page-tree?pgType=:pgType

3. 仪表板相关API 具体说明​

特别说明：当前文档中的页面与仪表板含义基本一致。 页面包含仪表板与数据大屏两大类型。

3.1 获取页面列表​

3.1.1 接口简介​

请求方式： POST

请求地址：/public-api/page/list

3.1.2 参数说明​

参数名参数值说明Location类型是否必填备注
token应用TokenBodyString是在观远平台中获得

3.1.3 请求与响应示例​

POST Body Sample:

{
  "token":"a430012ed74b342ef90b7275",
}

Response Sample:

{
    "result": "ok",
    "response": [
        {
            "pgId": "0ac483ab81b54ce184157100",
            "domId": "demo",
            "name": "集团总览",
            "uId": "d9f1ec1b629946b2b00f1d60",  // 页面创建者
            "pgType": "PAGE",        //页面类型："OVERVIEW"（概览）、"PAGE"（普通页面）、 "LARGE_SCREEN"(数据大屏)
            "parentDirId": "rc135f11b39a842d8b5475d4"    //页面所属文件夹ID
        },
        ……
    ]
}

3.2 根据页面名称关键词搜索页面​

3.2.1 接口简介​

请求方式：POST

请求地址：/public-api/page/search?q=:q&&offset=:offset&&limit=:limit

3.2.2 参数说明​

参数名参数值说明Location类型是否必填备注
token应用TokenBodyString是在观远平台中获得
q要搜索的数据集名称模糊词urlString是--
offset搜索结果的起始位置urlString否默认值0
limit从起始位置取多少条urlString否默认值10

3.2.3 请求与响应示例​

POST Body Sample:

{
  "token":"a430012ed74b342ef90b7275",
}

Response Sample:

'{
    "result": "ok",
    "response": {
      "total": 6,
      "offset": 0,
      "limit": 10,
      "list": [
        {
            "pgId": "0ac483ab81b54ce184157100",
            "domId": "demo",
            "name": "集团总览",
            "uId": "d9f1ec1b629946b2b00f1d60",  // 页面创建者
            "pgType": "PAGE",        //页面类型："OVERVIEW"（概览）、"PAGE"（普通页面）、 "LARGE_SCREEN"(数据大屏)
            "parentDirId": "rc135f11b39a842d8b5475d4"，    //页面所属文件夹ID
            "meta": {
                    "authorizedOnMobile": false,//是否发布在移动端
                    "authorizedOnPC": true //是否发布在桌面
                }
        },
        ……
    ]
    }
}

3.3 获取指定页面有读权限的用户列表​

3.3.1 接口简介​

请求方式：POST

请求地址：/public-api/page/:pgId/get-readable-owners

3.3.2 参数说明​

参数名参数值说明Location类型是否必填备注
token应用TokenBodyString是在观远平台中获得
pdId页面IDURLString是--

3.3.3 请求与响应示例​

POST Body Sample:

{
  "token":"a430012ed74b342ef90b7275",
}

Response Sample:

{
    "result": "ok",
    "response": {
        "ownerUsers": [
            {
                "name": "zhangsan",
                "id": "h9aaad4c93bc1496891321e7",
                "email": "zhangsan@guandata.com",
                "loginId": "zhangsan"
            },
            ……
        ],
        "ownerGroups": [
            {
                "name": "zln34",
                "id": "m62d41e027dfb4e10a4b4a80"
            },
            ……
            ],
        "readableUsers": [
            ……
        ],
        "readableGroups": [
            ……
        ]
    }
}

3.4 以树状结构获取页面列表​

3.4.1 接口简介​

请求方式：POST

请求地址：/public-api/page-tree?pgType=:pgType

3.4.2 参数说明​

参数名参数值说明Location类型是否必填备注
token应用TokenBodyString是在观远平台中获得
pgType页面类型URLString是普通页面：PAGE;大屏页面：LARGE_SCREEN

3.4.3 请求与响应示例​

POST Body Sample:

{
  "token":"a430012ed74b342ef90b7275",
}

Response Sample:

{
  "result": "ok",
  "response": {
    "id": "q40e0658fdc284e2aaa07f34",
    "parentDirId": "",
    "name": "根目录",
    "contents": [
      {
        "id": "rb0dae7523f4d464ab84f819",
        "parentDirId": "hfc8e4cb8e7e242b98d957d2",
        "name": "123_副本",
        "isPage": true,
        "ctime": "2022-04-29T11:44:21.00Z",
        "pgType": "LARGE_SCREEN"
      }
    ],
    "isPage": false, // false表示文件夹
    "ctime": "2020-01-10T13:49:36.00Z"
  }
}