V2.1 Get Latest Measurement Points¶

获取设备上传的最新测点数据（包括设备上传的原始数据，镜像数据；但不包括通过 StreamSet 的计算点和离线消息集成的数据），该最新测点数据可以通过 HTTP，MQTT，CoAP 等协议上传。通过老的 EnOS API 上传的数据（即通过接口/connectService/products/{productKey}/devices/measurepoints），也可以通过该接口获取。

如果你在使用 API 批量更新相关测点相关信息后调用当前 API，建议两次调用间隔 2 秒左右，以免获取到未更新数据。

该 API 支持在 EnOS 2.1.0 及以上环境中使用。

请求格式¶

POST https://{apigw-address}/connect-service/v2.1/measurepoints?action=queryLatest

请求参数（URI）¶

备注

本表非必需字段中，必须使用以下任意一种方式来指定设备：

assetId
productKey + deviceKey

名称	位置（Path/Query）	必需/可选	数据类型	描述
orgId	Query	必需	String	资产所属的组织 ID。如何获取 orgId 信息>>
assetId	Query	可选（见上述注解）	String	资产 ID。如何获取 assetId 信息>>
productKey	Query	可选（见上述注解）	String	设备的 product key，需与 `deviceKey` 一起使用。如何获取设备的三元组信息>>
deviceKey	Query	可选（见上述注解）	String	设备的 device key，需与 `productKey` 一起使用。如何获取设备的三元组信息>>

请求参数 (Body)¶

名称	必需/可选	数据类型	描述
measurepointIds	可选	String数组	由测点标识符（字符串）组成的数组。用于指定需要返回的测点。如果没有提供，则返回所有测点的最新值。

响应参数¶

名称	数据类型	描述
data	`MeasurepointStatus` 结构体数组	测点相关的数据。`MeasurepointStatus` 的结构见下表。

MeasurepointStatus 结构体¶

名称	数据类型	描述
id	String	测点ID
time	String	测点更新时间。
value	根据模型定义确定	测点值。

示例¶

请求示例¶

url: https://{apigw-address}/connect-service/v2.1/measurepoints?action=queryLatest&orgId=yourOrgId&assetId=yourAssetId
method: POST
requestBody:
{
    "measurepointIds":[
        "temp"
    ]
}

响应示例¶

{
    "code": 0,
    "msg": "OK",
    "requestId": "5c48cad3-3e33-4e0e-be43-9ca628ba3ae5",
    "data": [
        {
            "id": "temp",
            "time": "1579590343468",
            "value": 0.3084426
        }
    ]
}

SDK 示例¶

你可以在 Github 上获取接入服务的 SDK 示例：

Java
Python