Devices Endpoints (.com)

This endpoint allows for management and monitoring of devices on the network. For constraints on headers, see REST API.

/Devices/

GET

Retrieves a list of devices on the network.

Parameters

[string] filter: An expression for filtering search results.
[string] sort: An expression for sorting the search results. The sort expression specifies the entry used for sorting and the ascending/descending (ASC/DESC) sorting order (e.g. "[device].[serial] ASC")
[string] marker: A value specifying which page to retrieve. This value is useful if the isTruncated entry in the response body of the previous GET call indicates that the number of Device instances exceeds the pageSize.
[int] pageSize: The maximum number of Device instances that can be contained in the response body

Response Body

Returns a paged list of Player Entity instances on a network. This will return not more than 100 entities along with the information necessary to return any other remaining pages.

/Devices/Regions/{*locationPath}/

GET

Returns a region which contains all the players located in the specified path.

Parameters

[string] locationPath: The parts of the returned player location path (country, province, city, etc.) that are common to all players.
[string] filter: An expression for filtering search results.

Response Body

Returns the Players Region Entity.

/Devices/Count/

GET

Retrieves the number of devices on the network matching the specified filter criteria. If no filter is included, this call returns the total number of devices on the network.

Parameters

[string] filter: An expression for filtering search results.

Response Body

The device count is returned as an integer value.

/Devices/{id:int}/

GET

Return the information for a device, specified by device id, on a network

Parameters

[int] id: A unique identifier for the device instance

Response Body

Returns the Player Entity

PUT

Update the specified device (specified by id).

Parameters

[int] id: A unique identifier for the device instance

Request Body

The Player Entity

Response Body

On success this method returns a status code 2XX, on failure it returns a status code of 5XX.

ON THIS PAGE

/Devices/{serial}/

GET

Return the specified device information (specified by serial number)

Parameters

[string] serial: The device serial number

Response Body

Returns the Player Entity

PUT

Update a device, specified by serial number, on a network.

Parameters

[string] serial: The device serial number

Request Body

The Player Entity

Response Body

On success this method returns a status code 2XX, on failure it returns a status code of 5XX.

/Devices/{deviceId:int}/Beacons/{beaconId:int?}/

GET

Returns a list of Apple, EddystoneUrl, or Eddystone Uid device beacons associated with a specified device.

Parameters

[int] deviceId: The unique identifier for the device instance
[int] beaconId: The unique identifier of the device beacon

Response Body

Returns the Player Beacon Entity

/Devices/{serial}/Beacons/{beaconId:int?}/

GET

Returns a list of Apple, EddystoneUrl, or Eddystone Uid device beacons associated with a specified device.

Parameters

[string] serial: The serial number for the device instance
[int] beaconId: The unique identifier of the device beacon

Response Body

Returns the Player Beacon Entity

/Devices/{id:int}/Beacons/

POST

Create a device beacon.

Parameters

[int] id: A unique identifier for the device instance

Request Body

The Player Beacon Entity

Response Body

Returns a 201 status code and the new resource created and referenced by the Uri (given by the location header field) in the response. The response includes the Player Beacon Entity.

/Devices/{serial}/Beacons/

POST

Create a device beacon.

Parameters

[string] serial: The serial number of the device instance

Request Body

The Player Beacon Entity

Response Body

Returns a 201 status code and the new resource created and referenced by the Uri (given by the location header field) in the response. The response includes the Player Beacon Entity.

/Devices/{deviceId:int}/Beacons/{beaconId:int}/

DELETE

Delete a specified device beacon from a specified device.

Parameters

[int] deviceId: A unique identifier for the device instance
[int] beaconId: The unique identifier of the device beacon

Response Body

On success this method returns a status code 2XX, on failure it returns a status code of 5XX.

/Devices/{serial}/Beacons/{beaconId:int}/

DELETE

Delete a specified device beacon from a specified device.

Parameters

[string] serial: The serial number of the device instance
[int] beaconId: The unique identifier of the device beacon

Response Body

On success this method returns a status code 2XX, on failure it returns a status code of 5XX.

/Devices/{id:int}/Errors/

GET

Returns a list of errors associated with the specified device.

Parameters

[int] id: A unique identifier for the device that is reporting the errors
[string] marker: A value specifying which page to retrieve. This value is useful if the isTruncated entry in the response body of the previous GET call indicates that the number of error instances exceeds the pageSize.
[int] pageSize: The maximum number of error instances that can be contained in the response body

Response Body

Returns the Player Error Entity

/Devices/{serial}/Errors/

GET

Returns a list of errors associated with a device (specified by serial number).

Parameters

[string] serial: The serial number of the device that is reporting the errors
[string] marker: A value specifying which page to retrieve. This value is useful if the isTruncated entry in the response body of the previous GET call indicates that the number of Error instances exceeds the pageSize.
[int] pageSize: The maximum number of Error instances that can be contained in the response body

Response Body

Returns the Player Error Entity

/Devices/{id:int}/Downloads/

GET

Returns the downloads associated with a device (specified by device id).

Parameters

[int] id: The unique identifier for the device that has the download instances
[string] marker: A value specifying which page to retrieve. This value is useful if the isTruncated entry in the response body of the previous GET call indicates that the number of download instances exceeds the pageSize.
[int] pageSize: The maximum number of download instances that can be contained in the response body

Response Body

Returns the Player Download Entity

/Devices/{serial}/Downloads/

GET

Returns a list of downloads carried out by a device (specified by serial number).

Parameters

[string] serial: The serial number of the device that has the download instances
[string] marker: A value specifying which page to retrieve. This value is useful if the isTruncated entry in the response body of the previous GET call indicates that the number of download instances exceeds the pageSize.
[int] pageSize: The maximum number of download instances that can be contained in the response body

Response Body

Returns the Player Download Entity

/Devices/{id:int}/ScreenShots/

GET

Returns a list of screenshots uploaded by a device (specified by device id)

Parameters

[int] id: A unique identifier for the device instance
[string] marker: A value specifying which page to retrieve. This value is useful if the isTruncated entry in the response body of the previous GET call indicates that the number of Screenshot instances exceeds the pageSize.
[int] pageSize: The maximum number of Screenshot instances that can be contained in the response body

Response Body

Returns the ScreenShot Entity

/Devices/{serial}/ScreenShots/

GET

Returns a list of screenshots uploaded by a device (specified by device serial number).

Parameters

[string] serial: The device serial number
[string] marker: A value specifying which page to retrieve. This value is useful if the isTruncated entry in the response body of the previous GET call indicates that the number of Screenshot instances exceeds the pageSize.
[int] pageSize: The maximum number of Screenshot instances that can be contained in the response body

Response Body

Returns the ScreenShot Entity

/Devices/{id:int}/Tags/

GET

Returns a list of tags associated with a specified device

Parameters

[int] id: A unique identifier for the device instance

Response Body

A collection of key value pairs where the key is tag name, and the value is tag value. See the Tags entry in Player Entity for more information.

POST

Adds tags to a specified device (specified by device id).

Parameters

[int] id: A unique identifier for the device instance

Request Body

[Dictionary<string, string>] tags: Creates one or more tags. The specified tags must not be previously defined since this method won't override existing tag values. See the Tags entry in Player Entity for more information.

Response Body

On success this method returns a status code 2XX, on failure it returns a status code of 5XX.

DELETE

Remove tags from a specified device (specified by device id).

Parameters

[int] id: A unique identifier for the device instance

Request Body

[List<string>] list: A list of tag keys

Response Body

On success this method returns a status code 2XX, on failure it returns a status code of 5XX.

/Devices/{serial}/Tags/

GET

Returns a list of tags associated with a specified device (specified by device serial number).

Parameters

[string] serial: The device serial number

Response Body

A collection of key value pairs where the key is tag name, and the value is tag value. See the Tags entry in Device Entity for more information.

POST

Adds one or more tags to a specified device (specified by device serial number).

Parameters

[string] serial: The device serial number

Request Body

[Dictionary<string, string>] tags: Creates one or more tags. The specified tags must not be previously defined since this method won't override existing tag values. See the Tags entry in Player Entity for more information.

Response Body

On success this method returns a status code 2XX, on failure it returns a status code of 5XX.

DELETE

Removes one or more tags from a specified device (specified by device serial number).

Parameters

[string] serial: The device serial number

Request Body

[List<string>] list: A list of tag keys

Response Body

On success this method returns a status code 2XX, on failure it returns a status code of 5XX.

/Devices/Operations/

GET

Returns Business Operations for devices.

Response Body

/Devices/Models/

GET

Returns a list of player models that are supported by BSN.

Response Body

The response body is an array of strings specifying supported player models.

/Devices/Models/{model}

GET

Returns the model number of the specified model.

Response Body

If the specified model is supported, the server returns a string containing the model number (e.g. "XT1143").

/Devices/Models/{model}/Connectors/

GET

Returns a list of video connectors supported by the specified model.

Response Body

The response body is an array of strings specifying video connectors supported by the model. The following are valid values:

"HDMI"
"VGA"
"Component"

/Devices/Models/{model}/Connectors/{connector?}/

GET

Returns the specified video connector if it's supported by the specified player model.

Parameters

[string] model
[string] connector

Response Body

If the specified video connector is supported, the response body will contain the connector name as a string. Otherwise, it will return code 404.

/Devices/Models/{model}/Connectors/{connector}/VideoModes/

GET

Returns a list of video modes supported by the specified connector on the specified model.

Response Body

The response body is an array of strings listing video modes supported by the specified connector on the specified model.