MSA Grid RESTful API Startup Manual page 21

SetDeviceData (BACnet Explorer NG)
Description: Retrieve the data available under the specified device and data path.
HTTP Verb: POST
URL:
/rest/method/fieldpop-api/setDeviceData
Query String Parameters:
•
happn_token - token obtained from the login request.
HTTP Headers:
•
Content-Type -
application/json
Body Parameters (JSON):
•
parameters - object containing the following fields:
o
deviceID - this can be obtained from the local Grid GUI on the device (also visible on the
Grid website by clicking on the device pin on the map)
o
path - the path of the value to get (must be 3 levels deep:
"deviceInstance/objectType:objectInstance/propertyIdentifier"
o
value - ASN.1 representation of the property value to set
o
options - object containing the following fields:
▪
asn1 - must be set to true since default representation might change in the future
▪
priority (optional) - priority to set from 1 to 16
Example Body Parameters:
{
"parameters": {
"deviceID": "bigelf_rkr",
"path": "200/analog-value:0/present-value",
"value": {
"value": 24,
"type": "REAL"
},
"options": {
"asn1": true,
"priority": 16
}
}
}
Example JSON Response:
{
"message": "Call successful",
"data": null,
"error": null
}
Grid RESTful API Start-up Guide
Install OpenVPN Client
)
21