Cloud APIs

Owned by BrightSign TechDocs
Last updated: Mar 06, 2024
3 min read

 

BrightSign cloud APIs can be categorized as follows:

  • Basic Authorization APIs control access to all of the BSN.cloud or BrightSignNetwork.com resources in your network.

  • B-Deploy (Provisioning) APIs provide tools for managing automated deployment packages.

  • BSN.cloud and .com Service APIs expose the functionality of our BrightAuthor and BrightAuthor:connected content management systems and let you monitor and manage BrightSign players.

Note that the diagrams below describe bsn.cloud servers and APIs, but BrightSignNetwork.com servers and APIs work in the same way.

Basic Authorization APIs

 

AccessAPIs.png
Image 1: BrightSign Authorization API communication 

An OAuth (bearer) token gives users authorization to communicate with APIs and send requests to the B-Deploy or Remote DWS APIs.

  • Use this API to get a Person OAuth2 Access/Refresh token, which returns list of networks. Then, as an authenticated user, you can send a User OAuth2 Access/Refresh token to the correct network. This allows you to access the network within the scope of what you are allowed to do. 

  • This API returns either a valid token that gives you access to any version of the bsn.cloud APIs, or a valid token that gives you access to any version of the BrightSignNetwork .com APIs.

  • The bsn.cloud and BrightSignNetwork.com base URLs are:

B-Deploy (Provisioning) APIs

SetupAPIs.png
Image 2: BrightSign B-Deploy API communication

B-Deploy APIs are available through BSN.cloud for automated deployment of players in the field. These APIs deliver the setup to players and allow creation and modification of the setup packages. They consist of Provisioning Server and Provisioning Setup Server APIs:

  • The Provisioning Server (PVS) returns an URL when given a serial number for any bsn.cloud or bsn connected device. The PVS provides only REST APIs.

  • The Provisioning Setup Server (PSS) stores and serves setup packages, presentation packages and firmware updates. The PSS provides a UI (in addition to REST APIs), which makes calls to PVS to add and retrieve serial numbers and URLs. 

BSN.cloud and .com Service APIs

These APIs expose the functionality of our BrightAuthor and BrightAuthor:connected content management systems using a standard set of endpoints, entities, and methods. Developers can use these APIs to build custom content management interfaces with some or all of the features that we have developed for our own content management system. These APIs can also be used for device/fleet management.

BSN.cloud APIs allow users of our cloud-based infrastructure to interact with networked BrightSign players. Partners can use the BSN.cloud APIs with or without their own servers. 

BrightSignNetwork.com APIs use the older BrightSign network to interact with BrightSign players.