Get Latest Measurement Points¶
Get the real-time data of the measurement points of a single device by specifing the device and measurement points.
Request Format¶
POST http://{apigw-address}/edge-service/v1/measurepoints?action=queryLatest
Request Parameters (URI)¶
Note
Use one of the following methods to specify the device:
- Include
assetId
in the request - Include
productKey
+deviceKey
in the request
Name | Data type | Required or not | Description |
---|---|---|---|
orgId | String | true | The organization ID which the asset belongs to. |
assetId | String | false (See Note above) | The device’s assetId. |
productKey | String | false (See Note above) | The device’s product key. To be used with deviceKey . |
deviceKey | String | false (See Note above) | The device’s device key. To be used with productKey . |
Request Parameters(Body)¶
Name | Data type | Required or not | Description |
---|---|---|---|
measurepointIds | String Array | false | An array of measurement point IDs, used to specify the measurement points to be included in the response.
|
Response Parameters¶
Name | Data type | Description |
---|---|---|
data | List<Measurepoint> | A list of the latest measurement point data. |
data.pointId | String | The measurement point ID. |
data.dataType | String | The measurement point type, including ARRAY, BOOL, DATE, ENUM, INT, FLOAT, DOUBLE, STRUCT, STRING,TEXT, NUMBER, TIMESTAMP, FILE, MAP, and so on. |
data.subDataType | String |
|
data.time | Long | The UTC timestamp (milliseconds). |
data.usingOem | Integer | Specifies whether this measurement point is using the device’s oem timestamp on the cloud template mapping configuration. 1 = using, 0 = not using. |
data.oemTime | Long | The UTC timestamp (milliseconds) sent by the device. 0 indicates that no timestamp is sent. |
data.value | Object | The measurement point value. |
Error Codes¶
Code | Description |
---|---|
400 | Illegal orgId. |
1000 | Parameter error. |
9999 | Internal error. |
1000201 | The device does not exist. |
Samples¶
Request Sample¶
url: http://{ip}:{port}/edge-service/v1/measurepoints?action=queryLatest&orgId=yourOrgId&assetId=yourAssetId
method: POST
requestBody:
{
"measurepointIds":[
"point1","point2"
]
}
Return Sample¶
{
"status": 0,
"msg": "success",
"submsg": null,
"data": [
{
"pointId": "point1",
"dataType": "INT",
"subDataType": null,
"time": 1536667537046,
"usingOem": 1,
"oemTime": 1536667537046,
"value": 88
},
{
"pointId": "point2",
"dataType": "ARRAY",
"subDataType": "INT",
"time": 1536667537046,
"usingOem": 1,
"oemTime": 0,
"value": [11,22,33]
}
]
}
Exception Sample¶
{
"status": 400,
"msg": "Invalid Argument orgId",
"submsg": "orgId does not exist"
}