The API > JSON API > REST Resources > Devices > GET

Overview

Returns information of newly learned-in devices, that are not yet in the database. These devices are shown in the WebInterface under "New Device". Each time the client issues the command, it will get all the devices that are listed as New Devices.

Client to Gateway:

Resource Path	HTTP method
/devices?newDevice=true	GET

Response Gateway to Client:

parameter		datatype	value / formatting	description
header		object	{}
devices		array of objects	[{}]
	deviceId	string	4 byte hex value	SenderID of Enocean device, EnOcean modules usually send telegrams with their unique 32-bit Chip ID. In the other case, these are the Base ID of the EnOcean device.

example:

Basic structure of gateway response:

http://hostname:api_port/devices?newDevice=true

{
  "header" : {
    "httpStatus" : 200,
    "content" : "devices",
    "gateway" : "DC-GW/EO-IP v0.99.1",
    "timestamp" : "2016-05-11T16:33:24.997+0200"
  },
  "devices" : [ {
    "deviceId" : "018FBB0B"
  }, {
    "deviceId" : "0191047D"
  } ]
}

GET /devices?newDevice=true

GET /devices?newDevice=true