Puntos de conexión de DeviceWebPages (2022/06)
Estos endpoints permiten a los usuarios administrar páginas web de dispositivos en la red.
URL base para estos endpoints: https://api.bsn.cloud/2022/06/REST/DeviceWebPages
_________________________________________________________________________
GET /
Devuelve una lista de páginas web del reproductor
Token de Scope requerido
bsn.api.main.devicewebpages.retrieve
______________________________________________________________
Parámetros de Query String
- filtro string opcional: Una expresiónexpresión para filtrar los resultados de búsqueda. El valor predeterminado es null.
- ordenar string opcional: Una expresión para ordenar los resultados de búsqueda. La expresión de ordenación especifica la entrada utilizada para ordenar y el orden de clasificación ascendente/descendente (ASC/DESC) (consulte esta páginaesta página para obtener más información). El valor predeterminado es null.
- marcador string opcional: Un valor que especifica qué página recuperar. Este valor es útil si la entrada isTruncated en el cuerpo de respuesta de la llamada GET anterior indica que el número de instancias de páginas web de dispositivos supera el pageSize. Este parámetro solo es requerido si usted necesita más elementos en la lista paginada que el pageSize (100).
- pageSize int opcional: La cantidad máxima de instancias de páginas web del reproductor que puede contenerse en el cuerpo de respuesta. De forma predeterminada, este valor es el tamaño máximo de página permitido (100).
______________________________________________________________
Ejemplo de solicitud
Los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera:
- marcador valor se establece en el valor de propiedad [PagedList].[NextMarker] de la respuesta anterior de la API de BSN.Cloud.
- pageSize se establece en 1
- filtro se establece en [Name] CONTIENE 'Page' Y [UploadDate] ESTÁ EN EL RANGO '2020-07-01' Y '2023-11-01'
- ordenar se establece en [Name] DESC
GET /2022/06/REST/DeviceWebPages/?marker=TWF0dHNJbnRlcm5hbFBhZ2UsOTczMTk1NQ%3D%3D&pageSize=1&filter=%5BName%5D%20CONTAINS%20%27Page%27%20AND%20%5BUploadDate%5D%20IS%20IN%20THE%20RANGE%20%272020-07-01%27%20AND%20%272023-11-01%27&sort=%5BName%5D%20DESC HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate______________________________________________________________
Cuerpo de respuesta exitoso
200: Devuelve una lista paginadalista paginada de instancias de Entidad WebPage en una red. Esto no devolverá más de 100 entidades junto con la información necesaria para devolver cualquier otra página restante.
Ejemplo
{
"items": [ {
"id": 11335061,
"name": "HTML_Red_Dot_Test-WebPage",
"uploadDate": "2023-10-17T14:24:21.63Z",
"lastModifiedDate": "2023-10-17T14:24:21.63Z",
"indexFile": {
"fileName": "village-of-menomonee-falls-events.html",
"physicalPath": "https://bsncloud.s3.amazonaws.com/ContentCloud/ee9d33406bf95280fd4bfa4a03ec9965",
"relativePath": "\\",
"fileSize": 1569,
"fileHash": "SHA1:2614BFE3EC74FEE729FB6EQ291E6324E0432317E"
},
"assets": null,
"presentations": [ {
"id": 242058,
"name": "HTML_Red_Dot_Test",
"type": "Presentation",
"link": null
}],
"permissions": []
}],
"totalItemCount": 9,
"matchingItemCount": 6,
"pageSize": 1,
"nextMarker": "SFRNTF9SZWRfRG90X1Rlc3QtV2ViUGFnZSwxMTM0NTA1MA==",
"prevMarker": "SFRNTF9SZWRfRG90X1Rlc3QtV2ViUGFnZSwxMTM0NTA134hU",
"isTruncated": true,
"sortExpression": "[Name] DESC",
"filterExpression": "[Name] CONTAINS 'Page' AND [UploadDate] IS IN THE RANGE '2020-07-01T00:00:00.000Z' AND '2023-11-01T00:00:00.000Z'"
}Error
300: La representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas)
400: La solicitud está malformada y, por lo tanto, no es válida
401: El token de acceso no es válido o no se especificó
403: El token de acceso proporcionado, aunque válido, no proporciona acceso a este método
406: El servidor no puede devolver la representación de datos que solicitó (según se especifica en el encabezado "Accept")
5XX: Cualquier código 500 es un error interno del servidor
DELETE /
Elimina páginas web de reproductores, especificadas por un filtro, de una red. Esto permite eliminar múltiples páginas web de reproductores a la vez.
Token de alcance requerido
bsn.api.main.devicewebpages.delete
______________________________________________________________
Parámetro de cadena de consulta
- filtro string required: Una expresiónexpresión para filtrar los resultados de búsqueda. El valor predeterminado es null.
______________________________________________________________
Ejemplo de solicitud
Los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera:
- filtro se establece en [UploadDate] ESTÁ EN EL RANGO '2020-07-01' Y '2020-08-01'
DELETE /2022/06/REST/DeviceWebPages/?filter=%5BName%5D%20CONTAINS%20%27Default%27 HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate______________________________________________________________
Cuerpo de la respuesta correcta
200: Devuelve el número de páginas web de reproductores afectadas como un valor entero.
Respuesta de error
300: La representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas)
400: La solicitud está malformada y, por lo tanto, no es válida. Por ejemplo, no puede eliminar una página web de dispositivo que esté siendo utilizada por una presentación.
401: El token de acceso no es válido o no se especificó
403: El token de acceso proporcionado, aunque válido, no proporciona acceso a este método
406: El servidor no puede devolver la representación de datos que solicitó (según se especifica en el encabezado "Accept")
5XX: Cualquier código 500 es un error interno del servidor
GET /Count/
Devuelve el número de páginas web del reproductor en un dispositivo
Token de Scope requerido
bsn.api.main.devicewebpages.retrieve
______________________________________________________________
Parámetro de cadena de consulta
- filtro string opcional: Una expresiónexpresión para filtrar resultados de búsqueda. El valor predeterminado es null.
______________________________________________________________
Ejemplo de solicitud
Los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera:
- filtro se establece en [UploadDate] ESTÁ EN EL RANGO '2018-01-01' Y '2023-09-01'
GET /2022/06/REST/DeviceWebPages/Count/?filter=%5BUploadDate%5D%20IS%20IN%20THE%20RANGE%20%272018-01-01%27%20AND%20%272023-09-01 HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate______________________________________________________________
Cuerpo de la respuesta exitosa
200: El recuento de páginas web del reproductor se devuelve como un valor entero.
Respuesta de error
300: La representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas)
400: La solicitud tiene un formato incorrecto y, por lo tanto, no es válida
401: El token de acceso no es válido o no se especificó
403: El token de acceso proporcionado, aunque válido, no proporciona acceso a este método
406: El servidor no puede devolver la representación de datos que usted solicitó (según se especifica en el encabezado "Accept")
5XX: Cualquier código 500 es un error interno del servidor
GET /{id}/
Devuelve la página web del reproductor especificada
Token de Scope requerido
bsn.api.main.devicewebpages.retrieve
______________________________________________________________
Segmento
- id int: Un identificador único para la página web del reproductor
______________________________________________________________
Ejemplo de solicitud
Los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera:
- id se establece en 646879
- El valor opcional del encabezado If-Modified-Since es igual al valor del encabezado Última modificación recuperado de la respuesta anterior de GET /id o OBTENER /nombre
GET /2022/06/REST/DeviceWebPages/646879/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
If-Modified-Since: Wed, 20 Dec 2023 21:30:34 GMT
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate______________________________________________________________
Respuesta exitosa con cuerpo
200: Devuelve la Entidad WebPage
Ejemplo
Este es un ejemplo de una respuesta de nivel 200:
{
"id": 646879,
"name": "Default_PresentationWebPage",
"uploadDate": "2020-07-27T16:23:35Z",
"lastModifiedDate": "2023-12-20T21:30:35.093Z",
"indexFile": {
"fileName": "_deviceWebPage.html",
"physicalPath": "https://bsncloud.s3.amazonaws.com/Testing/5ced8fc8c47741c190a19c41f56c85d3",
"relativePath": "\\",
"fileSize": 116305,
"fileHash": "SHA1:F84HF1B0D0361BDC4C2072EBE8C21B16P0HA0031"
},
"assets": [],
"presentations": [
{
"id": 15762,
"name": "CC_Testing",
"type": "Presentation",
"link": null
}
],
"permissions": []
}Respuesta correcta
304: El recurso no fue modificado desde la hora especificada en el encabezado “If-Modified-Since”
Respuesta de error
300: La representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas)
400: La solicitud está mal formada y, por lo tanto, no es válida
401: El token de acceso no es válido o no fue especificado
403: El token de acceso proporcionado, aunque válido, no proporciona acceso a este método
404: El servidor no puede encontrar el recurso solicitado (la ruta no existe)
406: El servidor no puede devolver la representación de datos que solicitó (según se especifica en el encabezado "Accept")
5XX: Cualquier código 500 es un error interno del servidor
DELETE /{id}/
Elimina la página web del reproductor especificada
Token de Scope requerido
bsn.api.main.devicewebpages.delete
______________________________________________________________
Segmento
- id int: Un identificador único para la página web del reproductor que se eliminará
______________________________________________________________
Ejemplo de solicitud
Los parámetros y encabezados de la solicitud de ejemplo están configurados de la siguiente manera:
- id está configurado como 646879
- El valor opcional del encabezado If-Unmodified-Since es igual al valor del encabezado Última modificación recuperado de la respuesta de GET /id o OBTENER /nombre.
DELETE /2022/06/REST/DeviceWebPages/646879/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
If-Unmodified-Since: Wed, 20 Dec 2023 21:30:34 GMT
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate______________________________________________________________
Respuesta correcta
204: La(s) página(s) web del reproductor especificada(s) fueron eliminadas
Respuesta de error
300: La representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas)
400: La solicitud está mal formada y, por lo tanto, no es válida. Por ejemplo, no puede eliminar una página web del dispositivo que está siendo utilizada por una presentación.
401: El token de acceso no es válido o no fue especificado
403: El token de acceso proporcionado, aunque válido, no proporciona acceso a este método
404: El servidor no puede encontrar el recurso solicitado (la ruta no existe)
406: El servidor no puede devolver la representación de datos que solicitó (como se especifica en el encabezado "Accept")
412: Falló la condición previa (el recurso cambió desde la hora especificada en el valor del encabezado “If-Unmodified-Since”)
5XX: Cualquier código 500 es un error interno del servidor
GET /{name}/
Devuelve la página web del reproductor especificada
Token de Scope requerido
bsn.api.main.devicewebpages.retrieve
______________________________________________________________
Segmento
- nombre string: El nombre de la página web del reproductor
______________________________________________________________
Ejemplo de solicitud
Los parámetros y encabezados de ejemplo de la solicitud se configuran de la siguiente manera:
- nombre se establece en Default_PresentationWebPage
- El valor opcional del encabezado If-Modified-Since es igual al valor del encabezado Última modificación recuperado de la respuesta anterior de GET /id o OBTENER /nombre
GET /2022/06/REST/DeviceWebPages/Default_PresentationWebPage/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
If-Modified-Since: Wed, 20 Dec 2023 21:30:34 GMT
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate______________________________________________________________
Respuesta correcta con cuerpo
200: Devuelve la Entidad WebPage
Ejemplo
Este es un ejemplo de una respuesta de nivel 200:
{
"id": 646879,
"name": "Default_PresentationWebPage",
"uploadDate": "2020-07-27T16:23:35Z",
"lastModifiedDate": "2023-12-20T21:30:35.093Z",
"indexFile": {
"fileName": "_deviceWebPage.html",
"physicalPath": "https://bsncloud.s3.amazonaws.com/JaneDoeTesting/5ced8fc8c47741c190a19c41f56c85d3",
"relativePath": "\\",
"fileSize": 116305,
"fileHash": "SHA1:F841N1A0D4351BDC4C2072EBC8C21B1550DA0061"
},
"assets": [],
"presentations": [
{
"id": 15762,
"name": "CC_Testing",
"type": "Presentation",
"link": null
}
],
"permissions": []
}Respuesta correcta
304: El recurso no se modificó desde la hora especificada en el encabezado “If-Modified-Since”
Respuesta de error
300: La representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas)
400: La solicitud está mal formada y por lo tanto no es válida
401: El token de acceso no es válido o no se especificó
403: El token de acceso proporcionado, aunque válido, no proporciona acceso a este método
404: El servidor no puede encontrar el recurso solicitado (la ruta no existe)
406: El servidor no puede devolver la representación de datos que solicitó (como se especifica en el encabezado "Accept")
5XX: Cualquier código 500 es un error interno del servidor
DELETE /{name}/
Elimina la página web del reproductor especificada
Token de ámbito requerido
bsn.api.main.devicewebpages.delete
______________________________________________________________
Segmento
- nombre string: El nombre de la página web del reproductor que se eliminará
______________________________________________________________
Ejemplo de solicitud
Los parámetros y encabezados de la solicitud de ejemplo se configuran de la siguiente manera:
- nombre se establece en Default_PresentationWebPage
- El valor opcional del encabezado If-Unmodified-Since es igual al valor del encabezado Última modificación recuperado de la respuesta de GET /id o OBTENER /nombre.
DELETE /2022/06/REST/DeviceWebPages/Default_PresentationWebPage/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
If-Unmodified-Since: Wed, 20 Dec 2023 21:30:34 GMT
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate______________________________________________________________
Respuesta correcta
204: La(s) página(s) web del reproductor especificada(s) fueron eliminadas
Respuesta de error
300: La representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas)
400: La solicitud está mal formada y, por lo tanto, no es válida. Por ejemplo, no puede eliminar una página web de dispositivo que esté en uso por una presentación.
401: El token de acceso no es válido o no se especificó
403: El token de acceso proporcionado, aunque válido, no proporciona acceso a este método
404: El servidor no puede encontrar el recurso solicitado (la ruta no existe)
406: El servidor no puede devolver la representación de datos que solicitó (como se especifica en el encabezado "Accept")
412: La condición previa falló (el recurso cambió desde el momento especificado en el valor del encabezado “If-Unmodified-Since”)
5XX: Cualquier código 500 es un error interno del servidor
GET /Operations/
Devuelve permisos operativos otorgados a roles para operaciones comerciales específicas
Token de ámbito requerido
bsn.api.main.operations.retrieve
______________________________________________________________
Ejemplo de solicitud
Los parámetros y encabezados de la solicitud de ejemplo se configuran de la siguiente manera:
GET /2022/06/REST/DeviceWebPages/Operations/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate______________________________________________________________
Cuerpo de la respuesta correcta
200: Devuelve la Entidad de operaciones comercialesEntidad de operaciones comerciales
Respuesta de error
300: La representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas)
400: La solicitud está mal formada y, por lo tanto, no es válida
401: El token de acceso no es válido o no se especificó
403: El token de acceso suministrado, aunque válido, no proporciona acceso a este método
406: El servidor no puede devolver la representación de datos que solicitó (como se especifica en el encabezado "Accept")
5XX: Cualquier código 500 es un error interno del servidor
GET /{id}/Permissions/
Incluye permisos de objeto para una instancia determinada de página web del reproductor.
Token de Scope requerido
bsn.api.main.devicewebpages.retrieve
______________________________________________________________
Segmento
- id int: Un identificador único para la página web del reproductor
______________________________________________________________
Ejemplo de solicitud
Los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera:
- id se establece en 646879
GET /2022/06/REST/DeviceWebPages/646879/Permissions/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate______________________________________________________________
Cuerpo de la respuesta correcta
200: Devuelve una matriz de entidades PermisoPermission
Ejemplo
[
{
"entityId": 546701,
"operationUID": "5c6ef943-d660-4907-aa56-e91903ff1772",
"principal": {
"login": "[email protected]",
"type": "User",
"id": 102359
},
"isFixed": false,
"isInherited": false,
"isAllowed": true,
"creationDate": "2023-10-11T18:46:30.1Z"
}
]Respuesta de error
300: La representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas)
400: La solicitud está mal formada y, por lo tanto, no es válida
401: El token de acceso no es válido o no se especificó
403: El token de acceso suministrado, aunque válido, no proporciona acceso a este método
404: El servidor no puede encontrar el recurso solicitado (la ruta no existe)
406: El servidor no puede devolver la representación de datos que solicitó (como se especifica en el encabezado "Accept")
5XX: Cualquier código 500 es un error interno del servidor
POST /{id}/Permissions/
Agrega permisos para una página web del reproductor
Token de Scope requerido
bsn.api.main.devicewebpages.update
______________________________________________________________
Segmento
- id int: Un identificador único para la página web del reproductor
______________________________________________________________
Cuerpo de la solicitud
- Una matriz de entidades de PermisoPermission
______________________________________________________________
Ejemplo de solicitud
Los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera:
- id se establece en 646879
POST /2022/06/REST/DeviceWebPages/646879/Permissions/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate
Content-Type: application/json
Content-Length: 316Este es el cuerpo de solicitud de ejemplo:
[
{
"entityId": 546701,
"operationUID": "5c6ef943-d660-4907-aa56-e91903ff1772",
"principal": {
"name": "Custom",
"isCustom": true,
"type": "Role",
"id": 0
},
"isFixed": false,
"isInherited": false,
"isAllowed": true,
"creationDate": "2023-10-11T18:46:30.1Z"
}
]______________________________________________________________
Respuesta satisfactoria
204: Los permisos especificados se otorgaron correctamente
Respuesta de error
400: La solicitud o el cuerpo de la solicitud tienen un formato incorrecto y, por lo tanto, no son válidos, o se rechazan de acuerdo con las reglas de negocio
401: El token de acceso no es válido o no se especificó
403: El token de acceso proporcionado, aunque válido, no proporciona acceso a este método
404: El servidor no puede encontrar el recurso solicitado (la ruta no existe)
415: El servidor no puede aceptar la representación de datos que usted envió (según se especifica en el encabezado "Content-Type")
5XX: Cualquier código 500 es un error interno del servidor
DELETE /{id}/Permissions/
Elimina permisos de una página web del reproductor
Token de Scope requerido
bsn.api.main.devicewebpages.update
______________________________________________________________
Segmento
- id int: Un identificador único para la página web del reproductor
______________________________________________________________
Cuerpo de la solicitud
- Una matriz de entidades de PermisoPermission entities
______________________________________________________________
Ejemplo de solicitud
Los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera:
- id se establece en 646879
DELETE /2022/06/REST/DeviceWebPages/646879/Permissions/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate
Content-Type: application/json
Content-Length: 316Este es el cuerpo de solicitud de ejemplo:
[
{
"entityId": 546701,
"operationUID": "5c6ef943-d660-4907-aa56-e91903ff1772",
"principal": {
"name": "Custom",
"isCustom": true,
"type": "Role",
"id": 0
},
"isFixed": false,
"isInherited": false,
"isAllowed": true,
"creationDate": "2023-10-11T18:46:30.1Z"
}
]______________________________________________________________
Respuesta correcta
204: Los permisos especificados se eliminaron correctamente de la página web del reproductor
Respuesta de error
300: La representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas)
400: La solicitud o el cuerpo de la solicitud tienen un formato incorrecto y, por lo tanto, no son válidos, o se rechazan de acuerdo con las reglas de negocio
401: El token de acceso no es válido o no se especificó
403: El token de acceso proporcionado, aunque válido, no proporciona acceso a este método
404: El servidor no puede encontrar el recurso solicitado (la ruta no existe)
406: El servidor no puede devolver la representación de datos que solicitó (como se especifica en el encabezado "Accept")
5XX: Cualquier código 500 es un error interno del servidor
GET /{name}/Permissions/
Incluye permisos de objeto para una instancia determinada de la página web del reproductor.
Token de Scope requerido
bsn.api.main.devicewebpages.retrieve
______________________________________________________________
Segmento
- nombre string: El nombre de la página web del reproductor
______________________________________________________________
Ejemplo de solicitud
Los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera:
- nombre se establece en Default_PresentationWebPage
GET /2022/06/REST/DeviceWebPages/Default_PresentationWebPage/Permissions/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate______________________________________________________________
Cuerpo de la respuesta correcta
200: Devuelve una matriz de entidades de PermisoPermission
Ejemplo
[
{
"entityId": 546701,
"operationUID": "5c6ef943-d660-4907-aa56-e91903ff1772",
"principal": {
"login": "[email protected]",
"type": "User",
"id": 102359
},
"isFixed": false,
"isInherited": false,
"isAllowed": true,
"creationDate": "2023-10-11T18:46:30.1Z"
}
]Respuesta de error
300: La representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas)
400: La solicitud tiene un formato incorrecto y, por lo tanto, no es válida
401: El token de acceso no es válido o no se especificó
403: El token de acceso proporcionado, aunque válido, no proporciona acceso a este método
404: El servidor no puede encontrar el recurso solicitado (la ruta no existe)
406: El servidor no puede devolver la representación de datos que solicitó (como se especifica en el encabezado "Accept")
5XX: Cualquier código 500 es un error interno del servidor
POST /{name}/Permissions/
Agrega permisos para una página web de reproductor
Token de Scope requerido
bsn.api.main.devicewebpages.update
______________________________________________________________
Segmento
- nombre string: El nombre de la página web del reproductor
______________________________________________________________
Cuerpo de la solicitud
- Una matriz de entidades PermisoPermission
______________________________________________________________
Ejemplo de solicitud
Los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera:
- nombre se establece en Default_PresentationWebPage
POST /2022/06/REST/DeviceWebPages/Default_PresentationWebPage/Permissions/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate
Content-Type: application/json
Content-Length: 316Este es el cuerpo de solicitud de ejemplo:
[
{
"entityId": 546701,
"operationUID": "5c6ef943-d660-4907-aa56-e91903ff1772",
"principal": {
"name": "Custom",
"isCustom": true,
"type": "Role",
"id": 0
},
"isFixed": false,
"isInherited": false,
"isAllowed": true,
"creationDate": "2023-10-11T18:46:30.1Z"
}
]______________________________________________________________
Respuesta exitosa
204: Los permisos especificados se concedieron correctamente
Respuesta de error
400: La solicitud o el cuerpo de la solicitud tienen un formato incorrecto y, por lo tanto, no son válidos, o se rechazan de acuerdo con las reglas de negocio
401: El token de acceso no es válido o no se especificó
403: El token de acceso proporcionado, aunque es válido, no proporciona acceso a este método
404: El servidor no puede encontrar el recurso solicitado (la ruta no existe)
415: El servidor no puede aceptar la representación de datos que envió (como se especifica en el encabezado "Content-Type")
5XX: Cualquier código 500 es un error interno del servidor
DELETE /{name}/Permissions/
Elimina permisos de una página web de reproductor
Token de Scope requerido
bsn.api.main.devicewebpages.update
______________________________________________________________
Segmento
- nombre string: El nombre de la página web del reproductor
______________________________________________________________
Cuerpo de la solicitud
- Un arreglo de PermisoPermission entidades
______________________________________________________________
Ejemplo de solicitud
Los parámetros y encabezados de la solicitud de ejemplo se configuran de la siguiente manera:
- nombre se establece en Default_PresentationWebPage
DELETE /2022/06/REST/DeviceWebPages/Default_PresentationWebPage/Permissions/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate
Content-Type: application/json
Content-Length: 316Este es el cuerpo de la solicitud de ejemplo:
[
{
"entityId": 546701,
"operationUID": "5c6ef943-d660-4907-aa56-e91903ff1772",
"principal": {
"name": "Custom",
"isCustom": true,
"type": "Role",
"id": 0
},
"isFixed": false,
"isInherited": false,
"isAllowed": true,
"creationDate": "2023-10-11T18:46:30.1Z"
}
]______________________________________________________________
Respuesta correcta
204: Los permisos especificados se eliminaron correctamente de la página web del reproductor
Respuesta de error
300: No se pudo devolver la representación solicitada porque es ambigua (hay varias representaciones solicitadas)
400: La solicitud o el cuerpo de la solicitud están mal formados y, por lo tanto, no son válidos, o se rechazan de acuerdo con las reglas de negocio
401: El token de acceso no es válido o no se especificó
403: El token de acceso proporcionado, aunque válido, no proporciona acceso a este método
404: El servidor no puede encontrar el recurso solicitado (la ruta no existe)
406: El servidor no puede devolver la representación de datos que usted solicitó (como se especifica en el encabezado "Accept")
5XX: Cualquier código 500 es un error interno del servidor