API DWS remotas
6 min
remote dws le permite ver y modificar configuraciones en un reproductor brightsign a través de internet la api de remote dws es un framework rest que permite que una aplicación cliente se integre con la funcionalidad de remote dws la aplicación cliente realiza llamadas rest al servidor brightsign websockets, que a su vez envía mensajes websockets a los reproductores brightsign dependiendo de la operación, el reproductor brightsign puede devolver información al servidor brightsign websockets, que se retransmitirá en la respuesta rest del servidor a la aplicación cliente url rest la url base de la api de dws remoto es https //ws bsn cloud/rest/v1/ https //ws bsn cloud/rest/v1/ tenga en cuenta que la sección rest distingue entre mayúsculas y minúsculas y el servidor puede devolver el código 404 si las mayúsculas y minúsculas no coinciden exactamente autenticación todas las llamadas a la api de remote dws requieren un token de acceso oauth2 válido que puede emitirse ya sea para un usuario o para la aplicación cliente el reproductor de destino debe pertenecer a la misma red para la cual se otorgó el token siga la guía autenticación docid\ u nj27ezais8kncux2mf para registrar sus aplicaciones y obtener tokens de acceso que concedan acceso a la api de remote dws encabezados de solicitud debe incluir los siguientes encabezados de solicitud en su solicitud el encabezado content type solo es necesario cuando se envía contenido en llamadas api post o put headers { 	'accept' 'application/json, application/vnd bsn error+json', 	'authorization' 'bearer {{useraccesstoken}}', 	'content type' 'application/json', } formato del mensaje de solicitud las solicitudes http a los recursos de remote dws deben tener formato json y contener los siguientes parámetros url destinationtype \<font color="#704ae0">string\</font> el tipo de dispositivo el único valor aceptado actualmente es "player" destinationname \<font color="#704ae0">string\</font> el número de serie del dispositivo las solicitudes que requieren un cuerpo json deben tener un objeto data externo por ejemplo, si una ruta espera habilitado \<font color="#704ae0">bool\</font> entonces el cuerpo json completo se vería así { "data" { "enabled" false } } algunas solicitudes también requieren propiedades específicas del recurso en la url o el cuerpo de la solicitud, como se detalla en las secciones parámetros url y cuerpo de la solicitud a continuación formato del mensaje de respuesta el servidor responderá a una solicitud rest con un mensaje de éxito o error, que también puede contener propiedades específicas del recurso, como se detalla en las secciones cuerpo de la respuesta a continuación los objetos json devueltos tendrán un objeto externo que contiene los métodos siguientes, donde data es un objeto de error o de resultado que contiene los valores devueltos ruta \<font color="#704ae0">string\</font> la ruta a la que se envió la solicitud método \<font color="#704ae0">string\</font> el método de solicitud datos \<font color="#704ae0">object\</font> los datos devueltos por ejemplo { "route" "/v1/info", "method" "get", "data" { "result" { "model" "ls424" } } }