GetDeviceOnlineHeatmap - 查询终端设备在线热点图

更新时间:
复制 MD 格式

查询指定终端设备在指定日期内按分钟统计的在线时段分布。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

GET  HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

DevTag

string

终端设备 ID。

2987b3e0-8108-2f99-4d18-3b4f1c1****

SaseUserId

string

用户 ID。取值来源:

su_e8f218fb171edd167c2ad917d21f53148bdefc510ca1f3c3cc0249d3643d****

Date

string

待查询的日期,格式为 yyyyMMdd,长度固定为 8 个字符。在线数据仅保留 8 天,超出保留期的日期将返回空列表。

20260809

返回参数

名称

类型

描述

示例值

object

Schema of Response

RequestId

string

Id of the request

D6707286-A50E-57B1-B2CF-EFAC59E850D8

DeviceOnlineHeatmap

array

在线时段分布。

array

一个在线的分钟刻度,固定包含 3 个元素,依次为小时、分钟、在线状态。例如[9,30,1]表示 09:30 该终端设备在线。

integer

刻度值。第 1 个元素为小时,取值范围:0~23。第 2 个元素为分钟,取值范围:0~59。第 3 个元素为在线状态,固定取值为 1,表示在线。

9

示例

正常返回示例

JSON格式

{
  "RequestId": "D6707286-A50E-57B1-B2CF-EFAC59E850D8",
  "DeviceOnlineHeatmap": [
    [
      9
    ]
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情