rDWS Display Control Endpoints

These display-control APIs can only be used on Moka displays that have built-in BrightSign players and are only available in BOS 9.0.189 and above.

Base URL for these endpoints: https://ws.bsn.cloud/rest/

_________________________________________________________________________

GET /v1/display-control/

Returns all control settings for a display that is connected to a BrightSign player.

Request Example

GET /rest/v1/display-control/?destinationType=player&destinationName={{playerSerial}} HTTP/1.1
Host: ws.bsn.cloud
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json

Response Body

200: This returns the display control settings, as shown in the example below.

Response Example

{
  "data": {
    "result": {
      "tvInfo": {
        "macAddress": "ff:ff:ff:ff:ff:ff",
        "wifiMacAddress": "ff:ff:ff:ff:ff:ff",
        "serialNo": "1234567890",
        "osVersion": "V8-AM963BS-0020015",
        "hwRevision": 1
      },
      "whiteBalance": {
        "redBalance": 120,
        "greenBalance": 120,
        "blueBalance": 120
      },
      "volume": 50,
      "brightness": 50,
      "contrast": 50,
      "idleStandbyTimeout": 50,
      "powerSetting": "on",
      "videoOutput": "HDMI1",
      "sdConnection": "brightsign",
      "alwaysConnectedEnabled": true
    }
  }
}

GET /v1/display-control/brightness/

Returns the brightness settings for a display that is connected to a BrightSign player.

Request Example

GET /rest/v1/display-control/brightness/?destinationType=player&destinationName={{playerSerial}} HTTP/1.1
Host: ws.bsn.cloud
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json

Response Body

200: This returns the brightness setting for the display, as shown in the example below.

Response Example

PUT /v1/display-control/brightness/

Changes the brightness setting of a display connected to a BrightSign player.

Request Example

This is the example request body:

Response Body

200: This returns the updated brightness setting for the display, as shown in the example below.

Response Example

GET /v1/display-control/contrast/

Returns the contrast settings for a display that is connected to a BrightSign player.

Request Example

Response Body

200: This returns the contrast setting for the display, as shown in the example below.

Response Example

PUT /v1/display-control/contrast/

Changes the contrast of a display connected to a BrightSign player.

Request Example

This is the example request body:

Response Body

200: This returns the updated contrast setting for the display, as shown in the example below.

Response Example

GET /v1/display-control/always-connected/

Returns the connection settings for a display that is connected to a BrightSign player.

Request Example

Response Body

200: This returns the connection setting for the display, as shown in the example below.

Response Example

PUT /v1/display-control/always-connected/

Changes the connection setting of a display connected to a BrightSign player.

Request Example

This is the example request body:

Response Body

200: Returns the connection setting for the display as true, as shown in the example below.

Response Example

PUT /v1/display-control/firmware/

Changes the firmware setting for a display connected to a BrightSign player.

Request Example

The example request body can be filepath or url:

Response Body

202: This updates the firmware and reboots the player, as shown in the example below.

Response Example

GET /v1/display-control/info/

Returns the settings about the BrightSign player that is connected to a display

Request Example

Response Body

200: This returns information about a display that is connected to a BrightSign player, as shown in the example below.

Response Example

GET /v1/display-control/power-settings/

Returns the power settings for a display that is connected to a BrightSign player.

Request Example

Response Body

200: This returns the power setting for the display, as shown in the example below.

Response Example

PUT /v1/display-control/power-settings/

Changes the power setting for a display connected to a BrightSign player.

Request Example

This is the example request body:

Response Body

200: This returns the updated power setting for the display, as shown in the example below.

Response Example

GET /v1/display-control/standby-timeout/

Returns the standby/timeout settings for a display that is connected to a BrightSign player.

Request Example

Response Body

200: This returns the standby/timeout setting for the display, as shown in the example below.

Response Example

PUT /v1/display-control/standby-timeout/

Changes the standby/timeout setting of a display connected to a BrightSign player.

Request Example

This is the example request body:

Response Body

200: This returns the updated standby/timeout setting for the display, as shown in the example below.

Response Example

GET /v1/display-control/sd-connection/

Returns the SD connection settings for a display that is connected to a BrightSign player.

Request Example

Response Body

200: This returns the SD connection setting for the display, as shown in the example below.

Response Example

PUT /v1/display-control/sd-connection/

Changes the SD connection setting of a display connected to a BrightSign player. The SD card control is passed either to the display (display) or the BrightSign player (brightsign)

Request Example

This is the example request body:

Response Body

200: This returns the updated SD connection setting for the display, as shown in the example below.

Response Example

GET /v1/display-control/video-output/

Returns the video output settings for a display that is connected to a BrightSign player.

Request Example

Response Body

200: This returns the video output setting for the display, as shown in the example below.

Response Example

PUT /v1/display-control/video-output/

Changes the video output setting of a display connected to a BrightSign player.

Request Example

This is the example request body:

Response Body

200: This returns the updated video output connection setting for the display, as shown in the example below.

Response Example

GET /v1/display-control/volume/

Returns the volume settings for a display that is connected to a BrightSign player.

Request Example

Response Body

200: This returns the volume setting for the display, as shown in the example below.

Response Example

PUT /v1/display-control/volume/

Changes the volume of a display connected to a BrightSign player.

Request Example

This is the example request body:

Response Body

200: This returns the updated volume setting for the display, as shown in the example below.

Response Example

GET /v1/display-control/white-balance/

Returns the white balance settings for a display that is connected to a BrightSign player.

Request Example

Response Body

200: This returns the white balance setting for the display, as shown in the example below.

Response Example

PUT /v1/display-control/white-balance/

Changes the white-balance of a display connected to a BrightSign player.

Request Example

This is the example request body:

Response Body

200: This returns the updated white balance setting for the display, as shown in the example below.

Response Example

Documentation

rDWS Display Control Endpoints

Analytics

GET /v1/display-control/

GET /v1/display-control/brightness/

PUT /v1/display-control/brightness/

GET /v1/display-control/contrast/

PUT /v1/display-control/contrast/

GET /v1/display-control/always-connected/

PUT /v1/display-control/always-connected/

PUT /v1/display-control/firmware/

GET /v1/display-control/info/

GET /v1/display-control/power-settings/

PUT /v1/display-control/power-settings/

GET /v1/display-control/standby-timeout/

PUT /v1/display-control/standby-timeout/

GET /v1/display-control/sd-connection/

PUT /v1/display-control/sd-connection/

GET /v1/display-control/video-output/

PUT /v1/display-control/video-output/

GET /v1/display-control/volume/

PUT /v1/display-control/volume/

GET /v1/display-control/white-balance/

PUT /v1/display-control/white-balance/

Related content