2020/10 to 2022/06

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 on this page the player models enumeration (2022/06) docid\ ncyirexrelr0umcgcujhe 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) docid 67k46yiodtyk8c0wy2j45 has been extended by the "raptor" and "cobra" elements the videomode enumeration (2022/06) docid\ q4as hqbf2tnwfzxv7aca 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) docid\ uzvwhpbopgry2z9pqo9gd has been extended by the xcx55firmware string string and xtx45 xdx35 hdx25 ls4x5 hs1x5firmware string string properties business operations appliance changes the previous bsn cloud main rest http api versions provide the business operations tree and related permissions through the operations endpoint (2020/10) docid\ bzqitjt5r9qcfpu ebklk , 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) docid\ ei98k7oul6z5i 5b d6js was extended by the appliance property 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 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 where you define instance specific permissions, display only business operations which have " instance " values in brightauthor\ connected, this would be in entity properties panels such as content, where you can define object permissions for specific instances where you define permissions or collections of entities, display only the business operations which have "collection " values in brightauthor\ connected, this would be in 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 the 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 https //datatracker ietf org/doc/html/rfc7232 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) docid\ y77uiecedvnrz0wes8vpl was extended by the lastmodifieddate datetime property network subscription entity (2022/06) docid 4aekl8ouwp1jzomqcj2id the lastmodifieddate datetime datetime 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 datetime 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) docid\ hxqkcdyfcsluuceocwoje was extended by the lastmodifieddate datetime 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) docid\ uaqtzanltnrcjbzf4vjdw structure definition the automaticsubscriptionsmanagementenabled bool bool property has been added to the structure the automatictaggedplaylistapprovementenabled bool bool property has been renamed to automatictaggedplaylistapprovalenabled