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）¶
注解
本表非必需字段中，必须使用以下任意一种方式来指定设备：
assetIdproductKey+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
}
]
}