Puntos de control de rDWS

19 min

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 \bool\ 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 \bool\ 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 \string\ establecerlo en desactivar deshabilita el script autorun actual (esto es útil para depuración) ejemplo de solicitud (reinicio simple) esta solicitud no tiene cuerpo 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) 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 { "data" { "crash report" true } } ejemplo de solicitud (restablecimiento de fábrica) 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 { "data" { "factory reset" true } } ejemplo de solicitud (deshabilitar autorun) 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 { "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 \object\ el objeto de respuesta éxito \bool\ indica si la operación fue correcta o no reiniciar \bool\ indica si el reproductor se está reiniciando o no ejemplos de respuesta informe de bloqueo { "data" { "result" { "success" true, "message" "a reboot has been initiated (with crash report)" } }, "route" "/v1/control/reboot", "method" "put" } restablecimiento de fábrica { "data" { "result" { "success" true, "message" "a reboot has been initiated (with factory reset)" } }, "route" "/v1/control/reboot", "method" "put" } deshabilitar autorun { "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 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 \bool\ un indicador que señala si la contraseña se leyó correctamente contraseña \password{ }\ un objeto password que describe la contraseña del dws los siguientes son valores posibles isresultvalid \bool\ un indicador que señala si la contraseña del dws es válida isblank \bool\ un indicador que señala si la contraseña del dws está en blanco (es decir, no se requiere contraseña) ejemplo de respuesta { "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 \string\ la nueva contraseña del dws local para el reproductor \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 \ \en versiones anteriores de bos, l\ \a ausencia de este parámetro (o una cadena vacía) elimina el requisito de contraseña para el dws \ contraseña anterior \string\ 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 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 { 	"data" { 	 "password" "newpassword", 	 "previous password" "oldpassword" 	} } cuerpo de la respuesta éxito \bool\ un indicador que señala si la contraseña se estableció correctamente reiniciar \bool\ un indicador que señala si el reproductor se reiniciará para establecer la contraseña ejemplo de respuesta { "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 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 \bool\ un indicador que señala si el dws local está habilitado o deshabilitado ejemplo de respuesta { "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 \bool\ un indicador que señala si el dws local debe habilitarse o deshabilitarse ejemplo de solicitud 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 { "data" { "enable" true } } cuerpo de la respuesta éxito \bool\ un indicador que señala si el dws local se habilitó o deshabilitó correctamente reiniciar \bool\ un indicador que señala si el reproductor se reiniciará para habilitar/deshabilitar el dws local ejemplo de respuesta { "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 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 { "data" { "reboot" "true" } } ejemplo de respuesta { "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 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 { "data" { "reboot" "true" } } ejemplo de respuesta { "data" { "result" { "success" true, "value" true } } }