MSA Grid RESTful API Startup Manual page 33

CallDeviceMethod – SetBACnetPropertyValue (v.1, v.2)
Description: Set BACnet property value by sending a 'writeProperty' request out on BACnet.
HTTP Verb: POST
URL:
/rest/method/fieldpop-api/callDeviceMethod
Parameters:
•
happn_token – token obtained from the login request.
•
deviceID – the IIoT gateway ID (see Section 3.1.1).
•
deviceAPIVersion – see Section 2.3.5.
•
methodName –
setBACnetPropertyValue
"
•
deviceInstance – the BACnet device instance.
•
objectType – the BACnet object type.
•
objectInstance – the BACnet object instance.
•
propertyIdentifier – the BACnet property identifier.
•
propertyValue – the value to write.
•
priority (optional) – priority to set from 1 to 16.
Example – URL: (HTTP POST)
/rest/method/fieldpop-api/callDeviceMethod?happn_token=eyJ0eXAiOiJKV1QiLC
Example – JSON body:
{
"parameters": {
"deviceID": "gateway_1",
"deviceAPIVersion": "2",
"methodName": "setBACnetPropertyValue",
"deviceInstance": 200,
"objectType": "analog-value",
"objectInstance": 0,
"propertyIdentifier": "present-value",
"propertyValue": {
"type": "REAL",
"value": 444
},
"priority": 16
}
}
Example – JSON Response:
{
"message": "Call successful",
"data": null,
"error": null
}
"
Grid RESTful API Start-up Guide
Install OpenVPN Client
33