根据设备编码和指标名获取离指定时间点最近的实测数据

POST

/api/v1/iot/latest-timeseries-by-time

关键词：设备、设备指标、时间点、实测数据、获取、查询
使用场景：
该接口一般用于基于某个时间点创建的预案中，如果需要查询该预案时刻下的最近实测数据，则使用该接口，若要查询实时数据，请用/api/v3/iot/latest-timeseries接口
输入：设备编码、指标名称、时间点
输出：设备编码、指标的时间序列数据

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

timePoint

string <date-time>

必需

待查询的时间点，即查询该时刻之前的最新一条实测数据

queryDeviceIndicatorList

array[object (QueryDeviceIndicatorInput) {2}] | null

可选

待查询的设备指标列表

deviceCode

string

必需

设备编码，如：测试水厂出厂

>= 1 字符

indicator

string

必需

指标名称，如：ceshi_1_shuichang_flow

>= 1 字符

示例

{
    "timePoint": "2019-05-30T13:41:57.658Z",
    "queryDeviceIndicatorList": [
        {
            "deviceCode": "测试水厂出厂",
            "indicator": "ceshi_1_shuichang_flow"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://online-products.dhichina.cn/gateway/iot-service/api/v1/iot/latest-timeseries-by-time' \
--header 'Content-Type: application/json' \
--data-raw '{
    "timePoint": "2019-05-30T13:41:57.658Z",
    "queryDeviceIndicatorList": [
        {
            "deviceCode": "测试水厂出厂",
            "indicator": "ceshi_1_shuichang_flow"
        }
    ]
}'

返回响应

🟢200成功

text/plain

Success

Body

array of:

deviceCode

string

必需

设备编码，如：测试水厂出厂

>= 1 字符

indicator

string | null

可选

指标名称，如：ceshi_1_shuichang_flow

string | null

时间

可选

string | null

数值

可选

示例

[
    {
        "deviceCode": "string",
        "indicator": "string",
        "t": "string",
        "v": "string"
    }
]

修改于 2025-07-14 05:55:00

根据设备编码和指标名获取最新实测数据,只从数据库中读取，不读缓存数据

以结构化的数据格式通过消息队列批量保存或更新实测数据