rDWS Control Endpoints

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

_________________________________________________________________________

PUT /control/reboot/ 

Reboots the player. The player will not send a response to a reboot request.

Request Body Parameters

  • crash_report bool: Pass the body parameter {“crash_report": true}. To be used only when directed by BrightSign customer service. This will reboot the player and save a crash-report file to the brightsign-dumps folder. Customer service may request the crash report when helping you troubleshoot a player.

  • factory_reset bool: Pass the body parameter {“factory_reset”: true}. This resets the player to factory defaults, erasing all persistent registry settings for networking, security, and other applications.

  • autorun string: Pass the body parameter {“autorun”: “disable”}. This disables the current autorun script, and this is especially helpful for debugging purposes.

Request Example

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

Request Example (Crash Report)

PUT /rest/v1/control/reboot/?destinationType=player&destinationName={{deviceSerial}} HTTP/1.1 Host: ws.bsn.cloud Authorization: Bearer {{UserAccessToken}} Accept: application/json, application/vnd.bsn.error+json Content-Type: application/json Content-Length: 56

This is the example request body:

{ "data": { "crash_report": true } }

Request Example (Factory Reset)

This is the example request body:

Request Example (Disable Autorun)

This is the example request body:

Response Body

The server will return a success or error message. A successful response will almost always cause a reboot which will be indicated in the response.

  • resultobject: The response object

    • successbool: Whether or not the operation was successful

    • rebootbool: Whether or not the player is rebooting

GET /control/dws-password/ 

Retrieves information about the current password of the local DWS (but not the password itself) such as whether the password is blank or invalid

Request Example

Response Body

  • success bool: A flag indicating whether the password was successfully read

  • password Password{ }: A Password object that describes the DWS password. The following are possible values:

    • isResultValid bool: A flag indicating whether the DWS password is valid

    • isBlank bool: A flag indicating whether the DWS password is blank (i.e. no password is required)

 

PUT /control/dws-password/ 

Sets a new password for the local DWS (or removes the password requirement)

Request Body Parameters

  • password string: The new local DWS password for the player. The absence of this parameter (or a blank string) will remove the password requirement for the DWS.

  • previous_password string: The previous DWS password. This parameter must be included. This value can be an empty string to indicate that the previous password was blank.

Request Example

This is the example request body:

Response Body

  • success bool: A flag indicating whether the password was successfully set

  • reboot bool: A flag indicating whether the player will reboot to set the password

 

GET /control/local-dws/ 

Retrieves the current state of the local DWS

Request Example

Response Body

  • success bool: A flag indicating whether the local DWS is enabled or disabled

 

PUT /control/local-dws/ 

Enables or disables the local DWS

Request Body

  • enable bool: A flag indicating whether the local DWS should be enabled or disabled

Request Example

This is the example request body:

Response Body

  • success bool: A flag indicating whether the local DWS was successfully enabled or disabled

  • reboot bool: A flag indicating whether the player will reboot to enable/disable the local DWS