---
title: Puntos de control de rDWS
slug: develop/es/puntos-de-control-de-rdws
docTags: 
createdAt: 2025-03-11T07:03:32.132Z
---

URL base para estos endpoints:  ***https\://ws.bsn.cloud/rest/v1/***

*\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_*

## PUT /control/reboot/ 

Reinicia el reproductor. El reproductor no enviará una respuesta a una solicitud de reinicio.

**Cuerpo de la solicitud**

- `informe_de_fallo` <font color="#704ae0">bool</font>: Establecerlo en `verdadero` reinicia el reproductor y guarda un archivo de informe de bloqueo en la carpeta brightsign-dumps. Debe usar esto solo cuando el servicio de atención al cliente de BrightSign se lo indique, ya que puede necesitar el informe de bloqueo para ayudarle a solucionar problemas de un reproductor.
- `factory_reset` <font color="#704ae0">bool</font>: Establecerlo en `verdadero` restablece el reproductor a los valores predeterminados de fábrica, borrando todas las configuraciones persistentes del registro para redes, seguridad y otras aplicaciones.
- `autorun` <font color="#704ae0">string</font>: Establecerlo en `desactivar` deshabilita el script autorun actual (esto es útil para depuración).

**Ejemplo de solicitud (Reinicio simple)**

Esta solicitud no tiene cuerpo.

```text
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
```

**Ejemplo de solicitud (Informe de bloqueo)**

```none
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
```

Este es el cuerpo de solicitud de ejemplo:

```json
{
    "data": {
        "crash_report": true
    }
}
```

**Ejemplo de solicitud (Restablecimiento de fábrica)**

```text
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: 57
```

Este es el cuerpo de solicitud de ejemplo:

```json
{
    "data": {
        "factory_reset": true
    }
}
```

**Ejemplo de solicitud (Deshabilitar Autorun)**

```text
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
```

Este es el cuerpo de solicitud de ejemplo:

```json
{
    "data": {
        "autorun": "disable"
    }
}
```

**Cuerpo de la respuesta**

El servidor devolverá un mensaje de éxito o error. Una respuesta correcta casi siempre provocará un reinicio, lo que se indicará en la respuesta.

- `resultado` <font color="#704ae0">object</font>: El objeto de respuesta
  - `éxito` <font color="#704ae0">bool</font>: Indica si la operación fue correcta o no
  - `reiniciar` <font color="#704ae0">bool</font>: Indica si el reproductor se está reiniciando o no

**Ejemplos de respuesta**

**Informe de bloqueo**

```json
{
    "data": {
        "result": {
            "success": true,
            "message": "A reboot has been initiated (with crash report)"
        }
    },
    "route": "/v1/control/reboot",
    "method": "PUT"
}
```

**Restablecimiento de fábrica**

```json
{
    "data": {
        "result": {
            "success": true,
            "message": "A reboot has been initiated (with factory reset)"
        }
    },
    "route": "/v1/control/reboot",
    "method": "PUT"
}
```

**Deshabilitar Autorun**

```json
{
    "data": {
        "result": {
            "success": true,
            "message": "A reboot has been initiated"
        }
    },
    "route": "/v1/control/reboot",
    "method": "PUT"
}
```

## GET /control/dws-password/ 

Recupera información sobre la contraseña actual del DWS local (pero no la contraseña en sí), como si la contraseña está en blanco o no es válida

**Ejemplo de solicitud**

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

**Cuerpo de la respuesta**

- `éxito` <font color="#704ae0">bool</font>: Un indicador que señala si la contraseña se leyó correctamente
- `contraseña` <font color="#704ae0">Password{ }</font>: Un objeto Password que describe la contraseña del DWS. Los siguientes son valores posibles:
  - `isResultValid` <font color="#704ae0">bool</font>: Un indicador que señala si la contraseña del DWS es válida
  - `isBlank` <font color="#704ae0">bool</font>: Un indicador que señala si la contraseña del DWS está en blanco (es decir, no se requiere contraseña)

**Ejemplo de respuesta**

```json
{
    "route": "/v1/control/dws-password",
    "method": "GET",
    "data": {
        "result": {
            "success": true,
            "password": {
                "isResultValid": true,
                "isBlank": true
            }
        }
    }
}
```

## PUT /control/dws-password/ 

Establece una nueva contraseña para el DWS local (o elimina el requisito de contraseña en versiones anteriores de BOS).

**Cuerpo de la solicitud**

- `contraseña` <font color="#704ae0">string</font>: La nueva contraseña del DWS local para el reproductor.  <font color="#4d4d4d">A partir de BOS 9.0.128 y BOS 9.1.75, esta API aplica requisitos de contraseña fuerte, por lo que pasar una cadena vacía provocará un error.</font> <font color="#4d4d4d">En versiones anteriores de BOS, l</font><font color="#4d4d4d">a ausencia de este parámetro (o una cadena vacía) elimina el requisito de contraseña para el DWS.</font>
- `contraseña_anterior` <font color="#704ae0">string</font>: La contraseña anterior del DWS. Este parámetro debe incluirse. Este valor puede ser una cadena vacía para indicar que la contraseña anterior estaba en blanco.

**Ejemplo de solicitud**

```text
PUT /rest/v1/control/dws-password/?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: 106
```

Este es el cuerpo de solicitud de ejemplo:

```json
{
	"data": {
		"password": "newpassword",
		"previous_password": "oldpassword"
	}
}
```

**Cuerpo de la respuesta**

- `éxito` <font color="#704ae0">bool</font>: Un indicador que señala si la contraseña se estableció correctamente
- `reiniciar` <font color="#704ae0">bool</font>: Un indicador que señala si el reproductor se reiniciará para establecer la contraseña

**Ejemplo de respuesta**

```json
{
    "data": {
        "result": {
            "success": true,
            "reboot": false
        }
    },
    "route": "/v1/control/dws-password",
    "method": "PUT"
}
```

##

## GET /control/local-dws/ 

Recupera el estado actual del DWS local

**Ejemplo de solicitud**

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

**Cuerpo de la respuesta**

- `éxito` <font color="#704ae0">bool</font>: Un indicador que señala si el DWS local está habilitado o deshabilitado

**Ejemplo de respuesta**

```json
{
    "route": "/v1/control/local-dws",
    "method": "GET",
    "data": {
        "result": {
            "success": true,
            "value": true
        }
    }
}
```

****

## PUT /control/local-dws/ 

Habilita o deshabilita el DWS local

**Cuerpo de la solicitud**

- `habilitar` <font color="#704ae0">bool</font>: Un indicador que señala si el DWS local debe habilitarse o deshabilitarse

**Ejemplo de solicitud**

```text
PUT /rest/v1/control/local-dws/?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: 50
```

Este es el cuerpo de solicitud de ejemplo:

```json
{
    "data": {
        "enable": true
    }
}
```

**Cuerpo de la respuesta**

- `éxito` <font color="#704ae0">bool</font>: Un indicador que señala si el DWS local se habilitó o deshabilitó correctamente
- `reiniciar` <font color="#704ae0">bool</font>: Un indicador que señala si el reproductor se reiniciará para habilitar/deshabilitar el DWS local

**Ejemplo de respuesta**

```json
{
    "data": {
        "result": {
            "success": true,
            "reboot": true
        }
    },
    "route": "/v1/control/local-dws",
    "method": "PUT"
}
```

****

## PUT /control/ssh-host-keys/reset/

Restablece las claves de host SSH regenerando nuevos pares de claves de host. Esto es útil por motivos de seguridad o cuando las claves de host se han visto comprometidas. El sistema determinará automáticamente si se requiere un reinicio, a menos que el parámetro reboot lo anule.

**Ejemplo de solicitud**

```text
PUT /rest/v1/control/ssh-host-keys/reset/ HTTP/1.1
Host: {{playerIP}}
Authorization: {{DigestAuth}}
Accept: application/json
Content-Type: application/json
Content-Length: 56
```

**Cuerpo de la solicitud**

Este es el cuerpo de solicitud opcional de ejemplo:

```json
{
    "data": {
        "reboot": "true"
    }
}
```

**Ejemplo de respuesta**

```json
{
    "data": {
        "result": {
            "success": true,
            "value": true
        }
    }
}
```

##

## PUT /control/dws-default-certs/reset/

Restablece los certificados predeterminados de DWS regenerando nuevos pares de certificados. Esto es útil por motivos de seguridad o cuando los certificados se han visto comprometidos. El sistema se reiniciará para activar los nuevos certificados, a menos que el parámetro reboot lo anule.

**Ejemplo de solicitud**

```text
PUT /rest/v1/control/dws-default-certs/reset/ HTTP/1.1
Host: {{playerIP}}
Authorization: {{DigestAuth}}
Accept: application/json
Content-Type: application/json
Content-Length: 56
```

**Cuerpo de la solicitud**

Este es el cuerpo de solicitud opcional de ejemplo:

```json
{
    "data": {
        "reboot": "true"
    }
}
```

**Ejemplo de respuesta**

```json
{
    "data": {
        "result": {
            "success": true,
            "value": true
        }
    }
}
```



