---
title: Puntos de conexión de DeviceWebPages (2022/06)
slug: develop/es/puntos-de-conexion-de-devicewebpages-202206
docTags:
createdAt: 2025-03-11T07:03:30.743Z
---
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ón](docId\:cOT2DfqiG9WykoYa94HEX) 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ágina](docId\:cOT2DfqiG9WykoYa94HEX) 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`
```text
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 paginada](docId:1GSmBtULb07Tf6mcfQCxP) de instancias de [Entidad WebPage](docId\:egvgxZ6SosQH2qH8nSsgo) 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**
```json
{
"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ón](docId\:cOT2DfqiG9WykoYa94HEX) 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'`
```text
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ón](docId\:cOT2DfqiG9WykoYa94HEX) 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'`
```text
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`
```text
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](docId\:egvgxZ6SosQH2qH8nSsgo)
**Ejemplo**
Este es un ejemplo de una respuesta de nivel 200:
```json
{
"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`.
```text
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`
```text
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](docId\:egvgxZ6SosQH2qH8nSsgo)
**Ejemplo**
Este es un ejemplo de una respuesta de nivel 200:
```json
{
"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`.
```text
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:
```text
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 comerciales](docId\:BB_TAuFfpLMvkrODV93I7)
:::ExpandableHeading
Ejemplo
```json
{
"uid": "74c0bd18-cb38-4a7a-b78d-127ffd5716d0",
"singularName": "Full Control",
"pluralName": "Device Web Page (Full Control)",
"fullName": "Device Web Page (Full Control)",
"targetEntity": "DeviceWebPage",
"appliance": "Instance, Collection",
"parent": null,
"descendants": [
{
"uid": "b484e2f0-af97-41a2-996f-731816e907af",
"singularName": "View Device Web Page",
"pluralName": "View Device Web Pages",
"fullName": "Device Web Page (Full Control) - View Device Web Pages",
"targetEntity": "DeviceWebPage",
"appliance": "Instance, Collection",
"parent": {
"uid": "74c0bd18-cb38-4a7a-b78d-127ffd5716d0",
"singularName": "Full Control",
"pluralName": "Device Web Page (Full Control)",
"fullName": "Device Web Page (Full Control)",
"targetEntity": "DeviceWebPage",
"appliance": "Instance, Collection",
"parent": null,
"descendants": null,
"permissions": null
},
"descendants": [],
"permissions": [
{
"entityId": null,
"operationUID": "b484e2f0-af97-41a2-996f-731816e907af",
"principal": {
"name": "Network Managers",
"isCustom": false,
"type": "Role",
"id": 5
},
"isFixed": true,
"isInherited": false,
"isAllowed": true,
"creationDate": "2020-03-05T16:59:06.553Z"
},
{
"entityId": null,
"operationUID": "b484e2f0-af97-41a2-996f-731816e907af",
"principal": {
"name": "Viewers",
"isCustom": false,
"type": "Role",
"id": 6
},
"isFixed": true,
"isInherited": false,
"isAllowed": true,
"creationDate": "2020-03-05T16:59:07.067Z"
},
{
"entityId": null,
"operationUID": "b484e2f0-af97-41a2-996f-731816e907af",
"principal": {
"name": "Administrators",
"isCustom": false,
"type": "Role",
"id": 1
},
"isFixed": true,
"isInherited": true,
"isAllowed": true,
"creationDate": "2020-03-05T16:59:05.08Z"
},
{
"entityId": null,
"operationUID": "b484e2f0-af97-41a2-996f-731816e907af",
"principal": {
"name": "General Managers",
"isCustom": false,
"type": "Role",
"id": 2
},
"isFixed": true,
"isInherited": true,
"isAllowed": true,
"creationDate": "2020-03-05T16:59:05.34Z"
},
{
"entityId": null,
"operationUID": "b484e2f0-af97-41a2-996f-731816e907af",
"principal": {
"name": "Creators",
"isCustom": false,
"type": "Role",
"id": 3
},
"isFixed": true,
"isInherited": true,
"isAllowed": true,
"creationDate": "2020-03-05T16:59:05.587Z"
},
{
"entityId": null,
"operationUID": "b484e2f0-af97-41a2-996f-731816e907af",
"principal": {
"name": "Publishers",
"isCustom": false,
"type": "Role",
"id": 4
},
"isFixed": true,
"isInherited": true,
"isAllowed": false,
"creationDate": "2020-03-05T16:59:05.907Z"
}
]
},
{
"uid": "fecc26f4-31aa-4a7a-a206-afabf885d1e6",
"singularName": "Upload Device Web Page",
"pluralName": "Upload Device Web Page",
"fullName": "Device Web Page (Full Control) - Upload Device Web Page",
"targetEntity": "DeviceWebPage",
"appliance": "Collection",
"parent": {
"uid": "74c0bd18-cb38-4a7a-b78d-127ffd5716d0",
"singularName": "Full Control",
"pluralName": "Device Web Page (Full Control)",
"fullName": "Device Web Page (Full Control)",
"targetEntity": "DeviceWebPage",
"appliance": "Instance, Collection",
"parent": null,
"descendants": null,
"permissions": null
},
"descendants": [],
"permissions": [
{
"entityId": null,
"operationUID": "fecc26f4-31aa-4a7a-a206-afabf885d1e6",
"principal": {
"name": "Administrators",
"isCustom": false,
"type": "Role",
"id": 1
},
"isFixed": true,
"isInherited": true,
"isAllowed": true,
"creationDate": "2020-03-05T16:59:05.08Z"
},
{
"entityId": null,
"operationUID": "fecc26f4-31aa-4a7a-a206-afabf885d1e6",
"principal": {
"name": "General Managers",
"isCustom": false,
"type": "Role",
"id": 2
},
"isFixed": true,
"isInherited": true,
"isAllowed": true,
"creationDate": "2020-03-05T16:59:05.34Z"
},
{
"entityId": null,
"operationUID": "fecc26f4-31aa-4a7a-a206-afabf885d1e6",
"principal": {
"name": "Creators",
"isCustom": false,
"type": "Role",
"id": 3
},
"isFixed": true,
"isInherited": true,
"isAllowed": true,
"creationDate": "2020-03-05T16:59:05.587Z"
},
{
"entityId": null,
"operationUID": "fecc26f4-31aa-4a7a-a206-afabf885d1e6",
"principal": {
"name": "Publishers",
"isCustom": false,
"type": "Role",
"id": 4
},
"isFixed": true,
"isInherited": true,
"isAllowed": false,
"creationDate": "2020-03-05T16:59:05.907Z"
},
{
"entityId": null,
"operationUID": "fecc26f4-31aa-4a7a-a206-afabf885d1e6",
"principal": {
"name": "Network Managers",
"isCustom": false,
"type": "Role",
"id": 5
},
"isFixed": true,
"isInherited": true,
"isAllowed": false,
"creationDate": "2020-03-05T16:59:06.54Z"
},
{
"entityId": null,
"operationUID": "fecc26f4-31aa-4a7a-a206-afabf885d1e6",
"principal": {
"name": "Viewers",
"isCustom": false,
"type": "Role",
"id": 6
},
"isFixed": true,
"isInherited": true,
"isAllowed": false,
"creationDate": "2020-03-05T16:59:07.053Z"
}
]
},
{
"uid": "5c6ef943-d660-4907-aa56-e91903ff1772",
"singularName": "Update Device Web Page",
"pluralName": "Update Device Web Page",
"fullName": "Device Web Page (Full Control) - Update Device Web Page",
"targetEntity": "DeviceWebPage",
"appliance": "Instance, Collection",
"parent": {
"uid": "74c0bd18-cb38-4a7a-b78d-127ffd5716d0",
"singularName": "Full Control",
"pluralName": "Device Web Page (Full Control)",
"fullName": "Device Web Page (Full Control)",
"targetEntity": "DeviceWebPage",
"appliance": "Instance, Collection",
"parent": null,
"descendants": null,
"permissions": null
},
"descendants": [],
"permissions": [
{
"entityId": null,
"operationUID": "5c6ef943-d660-4907-aa56-e91903ff1772",
"principal": {
"name": "Administrators",
"isCustom": false,
"type": "Role",
"id": 1
},
"isFixed": true,
"isInherited": true,
"isAllowed": true,
"creationDate": "2020-03-05T16:59:05.08Z"
},
{
"entityId": null,
"operationUID": "5c6ef943-d660-4907-aa56-e91903ff1772",
"principal": {
"name": "General Managers",
"isCustom": false,
"type": "Role",
"id": 2
},
"isFixed": true,
"isInherited": true,
"isAllowed": true,
"creationDate": "2020-03-05T16:59:05.34Z"
},
{
"entityId": null,
"operationUID": "5c6ef943-d660-4907-aa56-e91903ff1772",
"principal": {
"name": "Creators",
"isCustom": false,
"type": "Role",
"id": 3
},
"isFixed": true,
"isInherited": true,
"isAllowed": true,
"creationDate": "2020-03-05T16:59:05.587Z"
},
{
"entityId": null,
"operationUID": "5c6ef943-d660-4907-aa56-e91903ff1772",
"principal": {
"name": "Publishers",
"isCustom": false,
"type": "Role",
"id": 4
},
"isFixed": true,
"isInherited": true,
"isAllowed": false,
"creationDate": "2020-03-05T16:59:05.907Z"
},
{
"entityId": null,
"operationUID": "5c6ef943-d660-4907-aa56-e91903ff1772",
"principal": {
"name": "Network Managers",
"isCustom": false,
"type": "Role",
"id": 5
},
"isFixed": true,
"isInherited": true,
"isAllowed": false,
"creationDate": "2020-03-05T16:59:06.54Z"
},
{
"entityId": null,
"operationUID": "5c6ef943-d660-4907-aa56-e91903ff1772",
"principal": {
"name": "Viewers",
"isCustom": false,
"type": "Role",
"id": 6
},
"isFixed": true,
"isInherited": true,
"isAllowed": false,
"creationDate": "2020-03-05T16:59:07.053Z"
}
]
},
{
"uid": "ba132cfb-475f-44ab-bfe5-eeadb23af065",
"singularName": "Assign Device Web Page",
"pluralName": "Assign Device Web Page",
"fullName": "Device Web Page (Full Control) - Assign Device Web Page",
"targetEntity": "DeviceWebPage",
"appliance": "Instance, Collection",
"parent": {
"uid": "74c0bd18-cb38-4a7a-b78d-127ffd5716d0",
"singularName": "Full Control",
"pluralName": "Device Web Page (Full Control)",
"fullName": "Device Web Page (Full Control)",
"targetEntity": "DeviceWebPage",
"appliance": "Instance, Collection",
"parent": null,
"descendants": null,
"permissions": null
},
"descendants": [],
"permissions": [
{
"entityId": null,
"operationUID": "ba132cfb-475f-44ab-bfe5-eeadb23af065",
"principal": {
"name": "Administrators",
"isCustom": false,
"type": "Role",
"id": 1
},
"isFixed": true,
"isInherited": true,
"isAllowed": true,
"creationDate": "2020-03-05T16:59:05.08Z"
},
{
"entityId": null,
"operationUID": "ba132cfb-475f-44ab-bfe5-eeadb23af065",
"principal": {
"name": "General Managers",
"isCustom": false,
"type": "Role",
"id": 2
},
"isFixed": true,
"isInherited": true,
"isAllowed": true,
"creationDate": "2020-03-05T16:59:05.34Z"
},
{
"entityId": null,
"operationUID": "ba132cfb-475f-44ab-bfe5-eeadb23af065",
"principal": {
"name": "Creators",
"isCustom": false,
"type": "Role",
"id": 3
},
"isFixed": true,
"isInherited": true,
"isAllowed": true,
"creationDate": "2020-03-05T16:59:05.587Z"
},
{
"entityId": null,
"operationUID": "ba132cfb-475f-44ab-bfe5-eeadb23af065",
"principal": {
"name": "Publishers",
"isCustom": false,
"type": "Role",
"id": 4
},
"isFixed": true,
"isInherited": true,
"isAllowed": false,
"creationDate": "2020-03-05T16:59:05.907Z"
},
{
"entityId": null,
"operationUID": "ba132cfb-475f-44ab-bfe5-eeadb23af065",
"principal": {
"name": "Network Managers",
"isCustom": false,
"type": "Role",
"id": 5
},
"isFixed": true,
"isInherited": true,
"isAllowed": false,
"creationDate": "2020-03-05T16:59:06.54Z"
},
{
"entityId": null,
"operationUID": "ba132cfb-475f-44ab-bfe5-eeadb23af065",
"principal": {
"name": "Viewers",
"isCustom": false,
"type": "Role",
"id": 6
},
"isFixed": true,
"isInherited": true,
"isAllowed": false,
"creationDate": "2020-03-05T16:59:07.053Z"
}
]
},
{
"uid": "e0a3a34b-74d9-46ac-a2f5-d03674cb9ac3",
"singularName": "Unassign Device Web Page",
"pluralName": "Unassign Device Web Page",
"fullName": "Device Web Page (Full Control) - Unassign Device Web Page",
"targetEntity": "DeviceWebPage",
"appliance": "Instance, Collection",
"parent": {
"uid": "74c0bd18-cb38-4a7a-b78d-127ffd5716d0",
"singularName": "Full Control",
"pluralName": "Device Web Page (Full Control)",
"fullName": "Device Web Page (Full Control)",
"targetEntity": "DeviceWebPage",
"appliance": "Instance, Collection",
"parent": null,
"descendants": null,
"permissions": null
},
"descendants": [],
"permissions": [
{
"entityId": null,
"operationUID": "e0a3a34b-74d9-46ac-a2f5-d03674cb9ac3",
"principal": {
"name": "Administrators",
"isCustom": false,
"type": "Role",
"id": 1
},
"isFixed": true,
"isInherited": true,
"isAllowed": true,
"creationDate": "2020-03-05T16:59:05.08Z"
},
{
"entityId": null,
"operationUID": "e0a3a34b-74d9-46ac-a2f5-d03674cb9ac3",
"principal": {
"name": "General Managers",
"isCustom": false,
"type": "Role",
"id": 2
},
"isFixed": true,
"isInherited": true,
"isAllowed": true,
"creationDate": "2020-03-05T16:59:05.34Z"
},
{
"entityId": null,
"operationUID": "e0a3a34b-74d9-46ac-a2f5-d03674cb9ac3",
"principal": {
"name": "Creators",
"isCustom": false,
"type": "Role",
"id": 3
},
"isFixed": true,
"isInherited": true,
"isAllowed": true,
"creationDate": "2020-03-05T16:59:05.587Z"
},
{
"entityId": null,
"operationUID": "e0a3a34b-74d9-46ac-a2f5-d03674cb9ac3",
"principal": {
"name": "Publishers",
"isCustom": false,
"type": "Role",
"id": 4
},
"isFixed": true,
"isInherited": true,
"isAllowed": false,
"creationDate": "2020-03-05T16:59:05.907Z"
},
{
"entityId": null,
"operationUID": "e0a3a34b-74d9-46ac-a2f5-d03674cb9ac3",
"principal": {
"name": "Network Managers",
"isCustom": false,
"type": "Role",
"id": 5
},
"isFixed": true,
"isInherited": true,
"isAllowed": false,
"creationDate": "2020-03-05T16:59:06.54Z"
},
{
"entityId": null,
"operationUID": "e0a3a34b-74d9-46ac-a2f5-d03674cb9ac3",
"principal": {
"name": "Viewers",
"isCustom": false,
"type": "Role",
"id": 6
},
"isFixed": true,
"isInherited": true,
"isAllowed": false,
"creationDate": "2020-03-05T16:59:07.053Z"
}
]
},
{
"uid": "136c2201-f5f9-4f16-be52-35db9b1444d0",
"singularName": "Edit Permissions",
"pluralName": "Edit Permissions",
"fullName": "Device Web Page (Full Control) - Edit Permissions",
"targetEntity": "DeviceWebPage",
"appliance": "Collection",
"parent": {
"uid": "74c0bd18-cb38-4a7a-b78d-127ffd5716d0",
"singularName": "Full Control",
"pluralName": "Device Web Page (Full Control)",
"fullName": "Device Web Page (Full Control)",
"targetEntity": "DeviceWebPage",
"appliance": "Instance, Collection",
"parent": null,
"descendants": null,
"permissions": null
},
"descendants": [],
"permissions": [
{
"entityId": null,
"operationUID": "136c2201-f5f9-4f16-be52-35db9b1444d0",
"principal": {
"name": "Administrators",
"isCustom": false,
"type": "Role",
"id": 1
},
"isFixed": true,
"isInherited": true,
"isAllowed": true,
"creationDate": "2020-03-05T16:59:05.08Z"
},
{
"entityId": null,
"operationUID": "136c2201-f5f9-4f16-be52-35db9b1444d0",
"principal": {
"name": "General Managers",
"isCustom": false,
"type": "Role",
"id": 2
},
"isFixed": true,
"isInherited": true,
"isAllowed": true,
"creationDate": "2020-03-05T16:59:05.34Z"
},
{
"entityId": null,
"operationUID": "136c2201-f5f9-4f16-be52-35db9b1444d0",
"principal": {
"name": "Creators",
"isCustom": false,
"type": "Role",
"id": 3
},
"isFixed": true,
"isInherited": true,
"isAllowed": true,
"creationDate": "2020-03-05T16:59:05.587Z"
},
{
"entityId": null,
"operationUID": "136c2201-f5f9-4f16-be52-35db9b1444d0",
"principal": {
"name": "Publishers",
"isCustom": false,
"type": "Role",
"id": 4
},
"isFixed": true,
"isInherited": true,
"isAllowed": false,
"creationDate": "2020-03-05T16:59:05.907Z"
},
{
"entityId": null,
"operationUID": "136c2201-f5f9-4f16-be52-35db9b1444d0",
"principal": {
"name": "Network Managers",
"isCustom": false,
"type": "Role",
"id": 5
},
"isFixed": true,
"isInherited": true,
"isAllowed": false,
"creationDate": "2020-03-05T16:59:06.54Z"
},
{
"entityId": null,
"operationUID": "136c2201-f5f9-4f16-be52-35db9b1444d0",
"principal": {
"name": "Viewers",
"isCustom": false,
"type": "Role",
"id": 6
},
"isFixed": true,
"isInherited": true,
"isAllowed": false,
"creationDate": "2020-03-05T16:59:07.053Z"
}
]
},
{
"uid": "220b7755-3d09-4934-b583-69beb2d4976a",
"singularName": "Delete Device Web Page",
"pluralName": "Delete Device Web Page",
"fullName": "Device Web Page (Full Control) - Delete Device Web Page",
"targetEntity": "DeviceWebPage",
"appliance": "Instance, Collection",
"parent": {
"uid": "74c0bd18-cb38-4a7a-b78d-127ffd5716d0",
"singularName": "Full Control",
"pluralName": "Device Web Page (Full Control)",
"fullName": "Device Web Page (Full Control)",
"targetEntity": "DeviceWebPage",
"appliance": "Instance, Collection",
"parent": null,
"descendants": null,
"permissions": null
},
"descendants": [],
"permissions": [
{
"entityId": null,
"operationUID": "220b7755-3d09-4934-b583-69beb2d4976a",
"principal": {
"name": "Network Managers",
"isCustom": false,
"type": "Role",
"id": 5
},
"isFixed": true,
"isInherited": false,
"isAllowed": true,
"creationDate": "2020-03-05T16:59:06.567Z"
},
{
"entityId": null,
"operationUID": "220b7755-3d09-4934-b583-69beb2d4976a",
"principal": {
"name": "Administrators",
"isCustom": false,
"type": "Role",
"id": 1
},
"isFixed": true,
"isInherited": true,
"isAllowed": true,
"creationDate": "2020-03-05T16:59:05.08Z"
},
{
"entityId": null,
"operationUID": "220b7755-3d09-4934-b583-69beb2d4976a",
"principal": {
"name": "General Managers",
"isCustom": false,
"type": "Role",
"id": 2
},
"isFixed": true,
"isInherited": true,
"isAllowed": true,
"creationDate": "2020-03-05T16:59:05.34Z"
},
{
"entityId": null,
"operationUID": "220b7755-3d09-4934-b583-69beb2d4976a",
"principal": {
"name": "Creators",
"isCustom": false,
"type": "Role",
"id": 3
},
"isFixed": true,
"isInherited": true,
"isAllowed": true,
"creationDate": "2020-03-05T16:59:05.587Z"
},
{
"entityId": null,
"operationUID": "220b7755-3d09-4934-b583-69beb2d4976a",
"principal": {
"name": "Publishers",
"isCustom": false,
"type": "Role",
"id": 4
},
"isFixed": true,
"isInherited": true,
"isAllowed": false,
"creationDate": "2020-03-05T16:59:05.907Z"
},
{
"entityId": null,
"operationUID": "220b7755-3d09-4934-b583-69beb2d4976a",
"principal": {
"name": "Viewers",
"isCustom": false,
"type": "Role",
"id": 6
},
"isFixed": true,
"isInherited": true,
"isAllowed": false,
"creationDate": "2020-03-05T16:59:07.053Z"
}
]
}
],
"permissions": [
{
"entityId": null,
"operationUID": "74c0bd18-cb38-4a7a-b78d-127ffd5716d0",
"principal": {
"name": "Administrators",
"isCustom": false,
"type": "Role",
"id": 1
},
"isFixed": true,
"isInherited": false,
"isAllowed": true,
"creationDate": "2020-03-05T16:59:05.08Z"
},
{
"entityId": null,
"operationUID": "74c0bd18-cb38-4a7a-b78d-127ffd5716d0",
"principal": {
"name": "General Managers",
"isCustom": false,
"type": "Role",
"id": 2
},
"isFixed": true,
"isInherited": false,
"isAllowed": true,
"creationDate": "2020-03-05T16:59:05.34Z"
},
{
"entityId": null,
"operationUID": "74c0bd18-cb38-4a7a-b78d-127ffd5716d0",
"principal": {
"name": "Creators",
"isCustom": false,
"type": "Role",
"id": 3
},
"isFixed": true,
"isInherited": false,
"isAllowed": true,
"creationDate": "2020-03-05T16:59:05.587Z"
},
{
"entityId": null,
"operationUID": "74c0bd18-cb38-4a7a-b78d-127ffd5716d0",
"principal": {
"name": "Publishers",
"isCustom": false,
"type": "Role",
"id": 4
},
"isFixed": true,
"isInherited": false,
"isAllowed": false,
"creationDate": "2020-03-05T16:59:05.907Z"
},
{
"entityId": null,
"operationUID": "74c0bd18-cb38-4a7a-b78d-127ffd5716d0",
"principal": {
"name": "Network Managers",
"isCustom": false,
"type": "Role",
"id": 5
},
"isFixed": true,
"isInherited": false,
"isAllowed": false,
"creationDate": "2020-03-05T16:59:06.54Z"
},
{
"entityId": null,
"operationUID": "74c0bd18-cb38-4a7a-b78d-127ffd5716d0",
"principal": {
"name": "Viewers",
"isCustom": false,
"type": "Role",
"id": 6
},
"isFixed": true,
"isInherited": false,
"isAllowed": false,
"creationDate": "2020-03-05T16:59:07.053Z"
}
]
}
```
:::
**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`
```text
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 [Permiso](docId\:hc70CptqCOfQdZw2spAEK)
**Ejemplo**
```json
[
{
"entityId": 546701,
"operationUID": "5c6ef943-d660-4907-aa56-e91903ff1772",
"principal": {
"login": "JaneDoe@brightsign.biZ",
"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 [Permiso](docId\:hc70CptqCOfQdZw2spAEK)
\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_
**Ejemplo de solicitud**
Los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera:
- `id` se establece en `646879`
```text
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: 316
```
Este es el cuerpo de solicitud de ejemplo:
```json
[
{
"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 [Permiso](docId\:hc70CptqCOfQdZw2spAEK) 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`
```text
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: 316
```
Este es el cuerpo de solicitud de ejemplo:
```json
[
{
"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`
```text
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 [Permiso](docId\:hc70CptqCOfQdZw2spAEK)
**Ejemplo**
```json
[
{
"entityId": 546701,
"operationUID": "5c6ef943-d660-4907-aa56-e91903ff1772",
"principal": {
"login": "JaneDoe@brightsign.biZ",
"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 [Permiso](docId\:hc70CptqCOfQdZw2spAEK)
\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_
**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`
```text
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: 316
```
Este es el cuerpo de solicitud de ejemplo:
```json
[
{
"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 [Permiso](docId\:hc70CptqCOfQdZw2spAEK) 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`
```text
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: 316
```
Este es el cuerpo de la solicitud de ejemplo:
```json
[
{
"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