Puntos de conexión de aprovisionamiento (2022/06)
Los recursos de Provisioning permiten a los usuarios configurar reproductores o cambiar configuraciones de reproductores.
URL base para este endpoint: https://api.bsn.cloud/2022/06/REST/Provisioning
_________________________________________________________________________
POST /Setups/Tokens/
Emite un token que le permite registrar reproductores en la red actual
Token de Scope requerido
bsn.api.main.devices.setups.token.create
______________________________________________________________
Cuerpo de la solicitud
______________________________________________________________
Ejemplo de solicitud
Los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera:
POST /2022/06/REST/Provisioning/Setups/Tokens/ 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 No hay cuerpo de solicitud, ya que la información requerida se pasa en la URL.
______________________________________________________________
Respuesta exitosa
200: Se ha emitido un token de configuración para reproductores en la red especificada
Ejemplo
{
"token": {{token}},
"scope": "cert",
"validFrom": "2024-05-21T00:00:00Z",
"validTo": "2024-11-17T00:00:00Z"
}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
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
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
GET /Setups/Tokens/{token}/
Valida un token de configuración de reproductor en la red actual y recupera sus metadatos
Token de Scope requerido
bsn.api.main.devices.setups.token.validate
______________________________________________________________
Segmento
- token string: Un token OAuth2 para el registro de reproductores en la red actual
______________________________________________________________
Ejemplo de solicitud
Los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera:
- token se establece en {{Token}}
GET /2022/06/REST/Provisioning/Setups/Tokens/{{Token}}/ 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 ______________________________________________________________
Respuesta exitosa
200: Devuelve una Entidad de información del token
Ejemplo
{
"token": {{token}},
"scope": "cert",
"validFrom": "2024-05-16T16:36:04.000Z",
"validTo": "2026-05-16T16:36:04.000Z"
}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 (el token ha expirado o no es válido)
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 /Setups/Tokens/{token}/
Revoca un token de configuración del reproductor en la red actual
Token de alcance requerido
bsn.api.main.devices.setups.token.revoke
______________________________________________________________
Segmento
- token string: Un token OAuth2 para el registro del reproductor en la red actual
______________________________________________________________
Ejemplo de solicitud
Los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera:
- token se establece en {{Token}}
DELETE /2022/06/REST/Provisioning/Setups/Tokens/{{Token}}/ 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
204: El token de configuración del reproductor ha sido revocado
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 (el token ha expirado o no es válido)
406: El servidor no puede devolver la representación de datos que solicitó (según se especifica en el encabezado "Accept")
500: Cualquier código 500 es un error interno del servidor