Page Comparison

Overview

The BSN.cloud Main REST-HTTP API version 2022/06 introduces Series 5 players and support for 8K video modes, updates the BrightWall implementation, addresses user permissions usability issues, and aligns change tracking and conditional request handling across all resources. Please review the following breaking changes, which were made for that purpose. Client applications which currently use BSN.cloud Main REST-HTTP API version 2020/10 must update to version 2022/06 get full access to these new features.

Series 5 Changes

This section describes the updates that were made to the 2022/06 version of the BSN.cloud Main REST-HTTP API  to support LS5, HD5, XD5, XT5, and XC5 BrightSign players. More information about Series 5 and their unique features is available at BrightSign Series 5 Digital Signage Players | BrightSign®.

• The Player Models Enumeration (2022/06) has been extended by the "XC2055", "XC4055", "LS425", "LS445", "HS125", "HS145", "HD225", "HD1025", "XD235", "XD1035", "XT245", "XT1145", and "XT2145" elements.

• The Player Family Enumeration (2022/06) has been extended by the "Raptor" and "Cobra" elements.

• The VideoMode Enumeration (2022/06

  )(DOCS-1182

  ) has been extended by the "7680x4320x60p", "7680x4320x59.94p", "7680x4320x50p", "7680x4320x30p", "7680x4320x29.97p", "7680x4320x25p", "7680x4320x24p", "7680x4320x23.976p", "3072x2048x30p", "1536x2048x30p" elements.

• The Regular Groups Entity (2022/06) has been extended by the

  [

  XCX55Firmware string

  ] XCX55Firmware and [string] XTX45

  and XTX45_XDX35_HDX25_LS4X5_HS1X5Firmware string properties.

Business Operations Appliance Changes

In previous The previous BSN.cloud Main REST-HTTP API versions , provide the business operations listed also included non-applicable operations. We addressed this usability bug by providing new information in the OperationAppliance property as shown below: tree and related permissions through the Operations Endpoint (2020/10), and similar resources related to each securable entity. However some business operations naturally apply only to collections of entities, while others only apply to entity instances, and the previous version of the API did not provide enough information to distinguish between them. The following changes have been made in version 2022/06 to address this usability issue:

• The Business Operations Entity (2022/06)

   

  was extended by the

  [OperationAppliance]

  Appliance property

  .The

  and the OperationAppliance OperationAppliance enumeration was defined. It may have one or more unique {"Instance", "Collection", "Unknown"} values:

  • The "Instance" value indicates that the given business operation applies to specific entity instances.

  • The "Collection" value indicates that the given business operation applies to collections of entities in a network and associated folders

    , and may be shown on the "Permissions" page and the Folder Properties panel

    .

  • The "Unknown" value is reserved for forward compatibility with new enumeration values, which may be defined in the next versions of the BSN.cloud Main REST-HTTP API.

Please update your client and display as follows:

• In places where

  Where you define

  permissions or collections of entities

  instance-specific permissions, display only

  the BusinessOperations

  business operations which have "

  Collection

  Instance" values. In BrightAuthor:connected, this would be

  the Admin > Permissions page

  in entity properties panels such as Content, where you can

  create custom roles and

  define

  player

  object permissions for specific instances.

  In places where

• Where you define

  instance-specific permissions, please display only BusinessOperations

  permissions or collections of entities, display only the business operations which have "

  Instance

  Collection" values. In BrightAuthor:connected, this would be in

  the entity properties panels (Content, Player Group, Presentation) where you can define object permissions for specific instances

  Admin > Roles & Permissions, where you create custom roles and define player permissions.

• The "Unknown" value may be ignored by client applications, but indicates the changes in the Business Operation appliance available in the next BSN.cloud Main REST-HTTP API versions.

HTTP Conditional Request Support

Most of our entities already support conditional requests according to rfc7232, but conditional request were missing for the following three entities and have now been implemented:

• Network Entity (2022/06)
• Network Subscription Entity (2022/06)
• Player Subscription Entity (2022/06)

Network Settings Structure Fixes

We provided new information in some entities (LastModifiedDate and AutomaticSubscriptionsManagementEnabled), which can be implemented if you wish. Other minor fixes have also been implementedThe BSN.cloud Main REST-HTTP API implements HTTP conditional request handling by exposing Last-Modified response headers and handling If-Modified-Since and If-Unmodified-Since request headers in accordance to RFC 7232. However this was missing in the Network, NetworkSubscription, and PlayerSubscription entities, so the following changes have been made in order to align them with other entities:

• Network Entity (2022/06) was extended by the

  [DateTime] LastModifiedDate propertyNetwork Settings Entity (2022/06);
• The [bool] AutomaticSubscriptionsManagementEnabled property has been added to the structure.
The [bool] AutomaticTaggedPlaylistApprovementEnabled property has been renamed to AutomaticTaggedPlaylistApprovalEnabled

LastModifiedDate DateTime property.

• Network Subscription Entity (2022/06):

  • The

    [

    LastModifiedDate DateTime

    ] LastModifiedDate

    property is no longer nullable.

  • The GET ~/2022/06/REST/Self/Networks/{networkId}/Subscription/ and GET ~/2022/06/REST/Self/Networks/{networkId}/Subscription/methods set the Last-Modified HTTP response header to the

    [

    LastModifiedDate DateTime

    ] LastModifiedDate

    property value of the returned entity.

  • The PUT ~/2022/06/REST/Self/Networks/{networkId}/Subscription/ and PUT ~/2022/06/REST/Self/Networks/{networkId}/Subscription/methods accept the optional If-Unmodified-Since HTTP Request Header and evaluate condition against the target entity.

• Player Subscription Entity (2022/06)

  was

   was extended by the

  [DateTime]LastModifiedDate property

  LastModifiedDate DateTime property.

Network Settings Structure Fixes

A client application update is required to reference the new property set in the Network Settings Entity (2022/06) structure definition:

• The AutomaticSubscriptionsManagementEnabled bool property has been added to the structure.

• The AutomaticTaggedPlaylistApprovementEnabled bool property has been renamed to AutomaticTaggedPlaylistApprovalEnabled.