How can we help?

Searching:

0 results found

Devices/Get (Specific)

GET /odata/Devices/[deviceId]

Description

Gets the details of a specific Device, as specified by the Device’s ID. This Device ID is returned in the response of Devices/Post.

To get the details of all the Devices of the applications allowed to the logged‑in user, see Devices/Get (List).

See the following for request and response details ‒

See Also

Request ‒ Devices/Get (Specific)

Property Type Description Mandatory
deviceId String This is the unique identifier automatically assigned by Axonize when a Device is created. This deviceId is returned in the response of the Devices/Post. Y

Example JSON Devices/Get (Specific) Request

curl -X GET \

https://api.stg.axonize.com/odata/devices/58c6898fb88c391588c91b2d \

-H ‘Authorization: Token’ \

-H ‘Content-Type: application/json’ \

-H ‘appId: 801A048A-9F23-429F-BF0D-B6D35B22771E’ \

Response ‒ Devices/Get (Specific)

For the requested Device, the response provides the properties in Devices/Post. In addition, the response that is returned also contains the following properties.

Property Type Description Mandatory
strong>alarmInstances Array of Objects The list of AlarmInstance IDs active on the device.
alarmInstance/_id String The AlarmInstance ID.
alarmInstance/name String Not in use.
isHub Boolean Specifies whether the device is a gateway (True) or not.
settings/lastSync DateTime The last timestamp when a reading was received from the Device.
settings/reportedValue String The value received from the updated physical Device by the Axonize Device SDK as the updatedValue, after it has been updated. This value should be the same as the desiredValue (described above).
isAlarmed Boolean True if an alarm is currently active in the Axonize System for this Device.

AlarmInstances can be dismissed in the Axonize Portal or using the Axonize Device API.

lastReadingTime Date The time that the last reading was received by the Axonize Server from the Device.
lastReadings An Array of Readings This is the event sent by the Device. This property comprises the following properties.
lastReadings/type Integer The type of this event is defined in the Event Manifest. For example, an event whose type equals 7 represents a temperature event.
lastReadings/datetime Date The timestamp of the event as inserted in the event by the Device. This date includes the time zone of the Device.

Note ‒ The Device can enter any date/time, not necessarily the exact time that the event occurred.

lastReadings/name String The name of the event.
lastReadings/value String The value of the reading. For example, the temperature.
lastReadings/unit String The unit of the reading. For example, whether the temperature is Celsius or Fahrenheit.
lastReadings/deviceId String The unique identifier of the specific Device.
isConnected Boolean Indicates the Device’s connectivity status to the Axonize Server. True indicates that the Device responded to the most recent keepAlive ping by the Axonize Server.

Each Device’s Product has a keepAlive field that indicates the frequency at which the Devices of this Product are checked for connectivity.

In addition, each Device can also have an optional keepAliveThreshold, which specifies the frequency at which this specific Device is checked for connectivity. A value in this field overrides the keepAlive field of the Device’s Product.

additionalProperties Not in use.
token Not in use.
parseReading Not in use.
diagram Not in use.
enableDirectMethod Not in use.
alarmInstancesCount Int Specify the number of active alarm instances on the device

Example JSON Devices/Get (Specific) Response

Status 200 ‒ OK

{

“@odata.context”: “http://stg-axonizeapi-axonize.stg-ase-axonize.p.azurewebsites.net/odata/$metadata#Devices/$entity”,

“productId”: “58564ddd66701d07a838fc48”,

“productName”: null,

“serialNumber”: “123456”,

“topic”: null,

“groupId”: null,

“active”: false,

“firstTimeRegistrationDate”: “0001-01-01T00:00:00Z”,

“activationDate”: “0001-01-01T00:00:00Z”,

“token”: null,

“commandsProtocol”: “Undefined”,

“lastReadingTime”: “0001-01-01T00:00:00Z”,

“isConnected”: false,

“hubId”: null,

“hubPrimaryKey”: “9hH+rsEQTHw64jS3sum5ZfMeN4F3DNcg7uA4YUULfzA=”,

“hubSecondaryKey”: “NVKWYAIbcpoJ0vJ+TfyBU8CY8fN5R+mfjkPCIVyODLA=”,

“customId”: “FMS6320-1”,

“keepAliveThreshold”: 0,

“isAlarmed”: false,

“virtualDeviceStatus”: “NotAvailable”,

“virtualDeviceEvents”: null,

“redisKey”: null,

“diagram”: null,

“streamUrl”: null,

“parentId”: null,

“name”: “new name1”,

“id”: “58c6898fb88c391588c91b2d”,

“appId”: “801A048A-9F23-429F-BF0D-B6D35B22771E'”,

“createDate”: “2017-03-13T11:59:11.61Z”,

“createUser”: “5851631e4e41925b98f08e15”,

“updateDate”: “0001-01-01T00:00:00Z”,

“updateUser”: null,

“lastReadings”: [],

“additionalProperties”: [],

“userDefinedLocation”: null,

“currentLocation”: null,

“coords”: null,

“ancestors”: []

}