Feeds Endpoints (2017/01)

ON THIS PAGE

Use this endpoint to manage Live Text and Live Media feeds on the network

/feeds/text/

GET

Returns a list of Live Text (RSS) feeds on the network.

Parameters

marker: A value specifying which page to retrieve. This value is useful if the isTruncated entry in the response body of the previous GET call indicates that the number of LiveTextFeed instances exceeds the pageSize.
pageSize: The maximum number of LiveTextFeed instances that can be contained in the response body
filter: An expression for filtering search results.
sort: An expression for sorting the search results. The sort expression specifies the entry used for sorting and the ascending/descending (ASC/DESC) sorting order (e.g. "[liveTextFeed].[creationDate] ASC")

Response Body

[int] totalItemCount: The total number of LiveTextFeed instances relevant to the query
[int] pageSize: The maximum number of LiveTextFeed instances that can be returned in a single response
[bool] isTruncated: A flag indicating whether the totalItemCount exceeds the pageSize
[string] nextMarker: A value that can be included with a subsequent GET call to return additional results that have been truncated
[string] sortExpression: The sort expression specified in the URL
[string] filterExpression: The filter expression specified in the URL
[LiveTextFeed[]] items: An array of LiveTextFeed object instances. Each LiveTextFeed instance can have the following entries:
- [int] id: A unique identifier for the LiveTextFeed instance
- [string] name: The name of the Live Text feed
- [string] physicalPath: The location of the feed XML file in the server directory
- [int] fileSize: The size of the feed XML file (in bytes)
- [string] fileHash: The hash algorithm and the value that results from performing the hash algorithm on the file. The string is formatted as "{algorithm}:{value}" (e.g. "SHA1:6DB465879088280AAC52DC22B07ED0AD493A99D4").
- [string] creationDate: A UTC timestamp indicating when the Live Text feed was created on BSN. The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ.
- [Item[]] items: An array of Item object instances representing RSS feed entries. The server currently returns a null value for this parameter.
- [Presentation[]] presentations: An array of Presentation object instances representing presentations that use the Live Text feed. Each Presentation instance can have the following values:
  - [int] id: A unique identifier for the Presentation instance
  - [string] name: The presentation name
  - [string] type: The presentation type
- [Permission[]] permissions: An array of Permission object instances representing permissions rules assigned to the Live Text feed

POST

Adds a new Live Text feed (RSS) to the network

Request Body

[string] name: The name of the Live Text feed
[Item[]] items: An array of Item object instances representing RSS feed entries. Each Item instance should have the following values:
- [string] title: The key (RSS item title) of the entry
- [string] description: The value (RSS item description) of the entry
- [bool] validityStartDate: A UTC value that determines the validity start date for the entry (i.e. the point at which it will start being included in the Live Text feed).The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ. A null value specifies that the item is valid immediately when added to the Live Text feed.
- [bool] validityEndDate: A UTC Value that determines the validity end date for the associated entry (i.e. the point at which it will no longer be included in the Live Text Feed). The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ. A null value specifies that the item will be valid until it is removed from the Live Text feed manually by a user.

Response Body

[int] id: A unique identifier for the LiveTextFeed instance
[string] name: The name of the Live Text feed
[string] physicalPath: The location of the feed XML file in the server directory
[int] fileSize: The size of the feed XML file (in bytes)
[string] fileHash: The hash algorithm and the value that results from performing the hash algorithm on the file. The string is formatted as "{algorithm}:{value}" (e.g. "SHA1:6DB465879088280AAC52DC22B07ED0AD493A99D4").
[string] creationDate: A UTC timestamp indicating when the Live Text feed was created on BSN. The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ.
[Item[]] items: An array of Item object instances representing RSS feed entries. Each Item instance should have the following values:
- [string] title: The key (RSS item title) of the entry
- [string] description: The value (RSS item description) of the entry
- [bool] validityStartDate: A UTC value that determines the validity start date for the entry (i.e. the point at which it will start being included in the Live Text feed).The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ. A null value specifies that the item is valid immediately when added to the Live Text feed.
- [bool] validityEndDate: A UTC Value that determines the validity end date for the associated entry (i.e. the point at which it will no longer be included in the Live Text Feed). The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ. A null value specifies that the item will be valid until it is removed from the Live Text feed manually by a user.
[Presentation[]] presentations: An array of Presentation object instances representing presentations that use the Live Text feed. Each Presentation instance can have the following values:
- [int] id: A unique identifier for the Presentation instance
- [string] name: The presentation name
- [string] type: The presentation type
[Permission[]] permissions: An array of Permission object instances representing permissions rules assigned to the Live Text feed

/feeds/text/count/

GET

Retrieves the number of Live Text feeds on the network that match the specified filter criteria. If no filter is included, this call returns the total number of Live Text feeds on the network.

Parameters

filter: An expression for filtering search results.

Response Body

The number of Live Text feeds is returned as an integer value.

/feeds/text/operations/

GET

Returns Business Operations for Live Text feeds.

Response Body

[string] uid: A unique identifier for the LiveTextFeed instance.
[string] singularName: The name of the operation in singular form. This value is useful for displaying in entity properties dialogs.
[string] pluralName: The name of the operation in plural form. This value is useful for displaying in User and Role properties dialogs.
[string] fullName: The name of the current operation along with its parent operations (if any). Since many operation names aren't unique, this value is useful for differentiating similar business operations.
[string] targetEntity: The object type affected by the operation (in this case, "LiveTextFeed")
[Operation{}] parent: An Operation instance indicating the operation from which permissions are inherited. This value will be Null if there is no parent operation.
[Operations[]] descendants: An array of Operation instances that inherit permissions from this operation. This value is Null if there are no descendant operations.
[Permissions[] permissions: An array of Permission instances indicating permissions associated with this operation

/feeds/text/{feed_id||name}/

GET

Returns the LiveTextFeed instance with the specified ID or name.

Response Body

[int] id: A unique identifier for the LiveTextFeed instance
[string] name: The name of the Live Text feed
[string] physicalPath: The location of the feed XML file in the server directory
[int] fileSize: The size of the feed XML file (in bytes)
[string] fileHash: The hash algorithm and the value that results from performing the hash algorithm on the file. The string is formatted as "{algorithm}:{value}" (e.g. "SHA1:6DB465879088280AAC52DC22B07ED0AD493A99D4").
[string] creationDate: A UTC timestamp indicating when the Live Text feed was created on BSN. The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ.
[Item[]] items: An array of Item object instances representing RSS feed entries. Each Item instance should have the following values:
- [string] title: The key (RSS item title) of the entry
- [string] description: The value (RSS item description) of the entry
- [bool] validityStartDate: A UTC value that determines the validity start date for the entry (i.e. the point at which it will start being included in the Live Text feed).The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ. A null value specifies that the item is valid immediately when added to the Live Text feed.
- [bool] validityEndDate: A UTC Value that determines the validity end date for the associated entry (i.e. the point at which it will no longer be included in the Live Text Feed). The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ. A null value specifies that the item will be valid until it is removed from the Live Text feed manually by a user.
[Presentation[]] presentations: An array of Presentation object instances representing presentations that use the Live Text feed. Each Presentation instance can have the following values:
- [int] id: A unique identifier for the Presentation instance
- [string] name: The presentation name
- [string] type: The presentation type
[Permission[]] permissions: An array of Permission object instances representing permissions rules assigned to the Live Text feed

PUT

Modifies the specified LiveDataFeed instance using the entries in the request body.

Request Body

[string] name: The name of the Live Text feed
[Item[]] items: An array of Item object instances representing RSS feed entries. Each Item instance should have the following values:
- [string] title: The key (RSS item title) of the entry
- [string] description: The value (RSS item description) of the entry
- [bool] validityStartDate: A UTC value that determines the validity start date for the entry (i.e. the point at which it will start being included in the Live Text feed).The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ. A null value specifies that the item is valid immediately when added to the Live Text feed.
- [bool] validityEndDate: A UTC Value that determines the validity end date for the associated entry (i.e. the point at which it will no longer be included in the Live Text Feed). The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ. A null value specifies that the item will be valid until it is removed from the Live Text feed manually by a user.

Response Body

[int] id: A unique identifier for the LiveTextFeed instance
[string] name: The name of the Live Text feed
[string] physicalPath: The location of the feed XML file in the server directory
[int] fileSize: The size of the feed XML file (in bytes)
[string] fileHash: The hash algorithm and the value that results from performing the hash algorithm on the file. The string is formatted as "{algorithm}:{value}" (e.g. "SHA1:6DB465879088280AAC52DC22B07ED0AD493A99D4").
[string] creationDate: A UTC timestamp indicating when the Live Text feed was created on BSN. The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ.
[Item[]] items: An array of Item object instances representing RSS feed entries. Each Item instance should have the following values:
- [string] title: The key (RSS item title) of the entry
- [string] description: The value (RSS item description) of the entry
- [bool] validityStartDate: A UTC value that determines the validity start date for the entry (i.e. the point at which it will start being included in the Live Text feed).The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ. A null value specifies that the item is valid immediately when added to the Live Text feed.
- [bool] validityEndDate: A UTC Value that determines the validity end date for the associated entry (i.e. the point at which it will no longer be included in the Live Text Feed). The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ. A null value specifies that the item will be valid until it is removed from the Live Text feed manually by a user.
[Presentation[]] presentations: An array of Presentation object instances representing presentations that use the Live Text feed. Each Presentation instance can have the following values:
- [int] id: A unique identifier for the Presentation instance
- [string] name: The presentation name
- [string] type: The presentation type
[Permission[]] permissions: An array of Permission object instances representing permissions rules assigned to the Live Text feed

DELETE

Removes the specified LiveTextFeed instance from the network. The server returns code 204 if successful and code 404 if the LiveTextFeed instance could not be found.

/feeds/media/

GET

Returns a list of Live Media (MRSS) feeds on the network.

Parameters

marker: A value specifying which page to retrieve. This value is useful if the isTruncated entry in the response body of the previous GET call indicates that the number of LiveMediaFeed instances exceeds the pageSize.
pageSize: The maximum number of LiveMediaFeed instances that can be contained in the response body
filter: An expression for filtering search results.
sort: An expression for sorting the search results. The sort expression specifies the entry used for sorting and the ascending/descending (ASC/DESC) sorting order (e.g. "[liveMediaFeed].[creationDate] ASC")

Response Body

[int] totalItemCount: The total number of LiveMediaFeed instances relevant to the query
[int] pageSize: The maximum number of LiveMediaFeed instances that can be returned in a single response
[bool] isTruncated: A flag indicating whether the totalItemCount exceeds the pageSize
[string] nextMarker: A value that can be included with a subsequent GET call to return additional results that have been truncated
[string] sortExpression: The sort expression specified in the URL
[string] filterExpression: The filter expression specified in the URL
[LiveMediaFeed[]] items: An array of LiveMediaFeed object instances. Each LiveMediaFeed instance can have the following entries:
- [int] id: A unique identifier for the LiveMediaFeed instance
- [string] name: The name of the Live Media feed
- [string] ttl: The amount of time that the Live Media feed can be cached on the client (i.e. player) before it is refreshed from the source. Note that the caching behavior of the media files themselves is determined by settings on the player. The duration is formatted as "HH:MM:SS".
- [string] physicalPath: The location of the feed XML file in the server directory
- [int] fileSize: The size of the feed XML file (in bytes)
- [string] fileHash: The hash algorithm and the value that results from performing the hash algorithm on the file. The string is formatted as "{algorithm}:{value}" (e.g. "SHA1:6DB465879088280AAC52DC22B07ED0AD493A99D4").
- [string] creationDate: A UTC timestamp indicating when the Live Media feed was created on BSN. The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ.
- [Content[]] content: An array of Content object instances representing MRSS feed entries. The server currently returns a null value for this parameter.
- [Presentation[]] presentations: An array of Presentation object instances representing presentations that use the Live Media feed. Each Presentation instance can have the following values:
  - [int] id: A unique identifier for the Presentation instance
  - [string] name: The presentation name
  - [string] type: The presentation type
- [Permission[]] permissions: An array of Permission object instances representing permissions rules assigned to the Live Media feed

POST

Adds a new Live Media feed (MRSS) to the network

Request Body

[string] name: The name of the Media RSS feed
[string] ttl: The amount of time that the Live Media feed can be cached on the client (i.e. player) before it is refreshed from the source. Note that the caching behavior of the media files themselves is determined by settings on the player. The duration is formatted as "HH:MM:SS".
[Item[]] items: An array of Item object instances representing MRSS feed entries. Each Item instance should have the following values:
- [int] contentId: The ID of the Content instance associated with the MRSS entry
- [string] fileName: The filename of the Content instance associated with the MRSS entry
- [string] title: The key (MRSS item title) of the entry
- [string] description: The value (MRSS item description) of the entry
- [string] displayDuration: The amount of time an image file will be displayed before transitioning to the next entry. The duration is formatted as "HH:MM:SS". This value does not apply to audio or video files and will default to a "00:00:00" value regardless of the passed value.
- [bool] validityStartDate: A UTC value that determines the validity start date for the entry (i.e. the point at which it will start being included in the Live Media feed).The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ. A null value specifies that the item is valid immediately when added to the Live Media feed.
- [bool] validityEndDate: A UTC Value that determines the validity end date for the associated entry (i.e. the point at which it will no longer be included in the Live Media Feed). The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ. A null value specifies that the item will be valid until it is removed from the Live Media feed manually by a user.
- [object] customFields: An object containing key:value pairs. Each pair corresponds to a custom field associated with the MRSS entry. If the entry does not have custom fields, this parameter should be set to null.

Response Body

[int] id: A unique identifier for the LiveMediaFeed instance
[string] name: The name of the Live Media feed
[string] ttl: The amount of time that the Live Media feed can be cached on the client (i.e. player) before it is refreshed from the source. Note that the caching behavior of the media files themselves is determined by settings on the player. The duration is formatted as "HH:MM:SS".
[string] physicalPath: The location of the feed XML file in the server directory
[int] fileSize: The size of the feed XML file (in bytes)
[string] fileHash: The hash algorithm and the value that results from performing the hash algorithm on the file. The string is formatted as "{algorithm}:{value}" (e.g. "SHA1:6DB465879088280AAC52DC22B07ED0AD493A99D4").
[string] creationDate: A UTC timestamp indicating when the Live Media feed was created on BSN. The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ.
[FeedContent[]] content: An array of FeedContent object instances representing MRSS feed entries. Each FeedContent instance can have the following values:
- [int] contentId: The ID of the Content instance associated with the MRSS entry
- [string] fileName: The filename of the Content instance associated with the MRSS entry
- [string] title: The key (MRSS item title) of the entry
- [string] description: The value (MRSS item description) of the entry
- [string] displayDuration: The amount of time an image file will be displayed before transitioning to the next entry. The duration is formatted as "HH:MM:SS". This value does not apply to audio or video files and will default to a "00:00:00" value regardless of the passed value.
- [bool] validityStartDate: A UTC value that determines the validity start date for the entry (i.e. the point at which it will start being included in the Live Media feed).The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ. A null value specifies that the item is valid immediately when added to the Live Media feed.
- [bool] validityEndDate: A UTC Value that determines the validity end date for the associated entry (i.e. the point at which it will no longer be included in the Live Media Feed). The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ. A null value specifies that the item will be valid until it is removed from the Live Media feed manually by a user.
- [CustomField] customFields: An object containing key:value pairs. Each pair corresponds to a custom field associated with the MRSS entry.
[Presentation[]] presentations: An array of Presentation object instances indicating presentations scheduled for the group. This parameter is null when the group is created.
[Permission[]] permissions: An array of Permission object instances representing permissions rules assigned to the Live Media feed

/feeds/media/count/

GET

Retrieves the number of Live Media feeds on the network that match the specified filter criteria. If no filter is included, this call returns the total number of Live Text feeds on the network.

Parameters

filter: An expression for filtering search results.

Response Body

The number of Live Media feeds is returned as an integer value.

/feeds/media/operations/

GET

Returns Business Operations for Live Media feeds.

Response Body

[string] uid: A unique identifier for the LiveMediaFeed instance.
[string] singularName: The name of the operation in singular form. This value is useful for displaying in entity properties dialogs.
[string] pluralName: The name of the operation in plural form. This value is useful for displaying in User and Role properties dialogs.
[string] fullName: The name of the current operation along with its parent operations (if any). Since many operation names aren't unique, this value is useful for differentiating similar business operations.
[string] targetEntity: The object type affected by the operation (in this case, "LiveMediaFeed")
[Operation{}] parent: An Operation instance indicating the operation from which permissions are inherited. This value will be Null if there is no parent operation.
[Operations[]] descendants: An array of Operation instances that inherit permissions from this operation. This value is Null if there are no descendant operations.
[Permissions[] permissions: An array of Permission instances indicating permissions associated with this operation

/feeds/media/{feed_id||feed_name}/

GET

Returns the LiveMediaFeed instance with the specified ID or name.

Response Body

[int] id: A unique identifier for the LiveMediaFeed instance
[string] name: The name of the Live Media feed
[string] ttl: The amount of time that the Live Media feed can be cached on the client (i.e. player) before it is refreshed from the source. Note that the caching behavior of the media files themselves is determined by settings on the player. The duration is formatted as "HH:MM:SS".
[string] physicalPath: The location of the feed XML file in the server directory
[int] fileSize: The size of the feed XML file (in bytes)
[string] fileHash: The hash algorithm and the value that results from performing the hash algorithm on the file. The string is formatted as "{algorithm}:{value}" (e.g. "SHA1:6DB465879088280AAC52DC22B07ED0AD493A99D4").
[string] creationDate: A UTC timestamp indicating when the Live Media feed was created on BSN. The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ.
[FeedContent[]] content: An array of FeedContent object instances representing MRSS feed entries. Each FeedContent instance can have the following values:
- [int] contentId: The ID of the Content instance associated with the MRSS entry
- [string] fileName: The filename of the Content instance associated with the MRSS entry
- [string] title: The key (MRSS item title) of the entry
- [string] description: The value (MRSS item description) of the entry
- [string] displayDuration: The amount of time an image file will be displayed before transitioning to the next entry. The duration is formatted as "HH:MM:SS". This value does not apply to audio or video files and will default to a "00:00:00" value regardless of the passed value.
- [bool] validityStartDate: A UTC value that determines the validity start date for the entry (i.e. the point at which it will start being included in the Live Media feed).The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ. A null value specifies that the item is valid immediately when added to the Live Media feed.
- [bool] validityEndDate: A UTC Value that determines the validity end date for the associated entry (i.e. the point at which it will no longer be included in the Live Media Feed). The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ. A null value specifies that the item will be valid until it is removed from the Live Media feed manually by a user.
- [CustomField] customFields: An object containing key:value pairs. Each pair corresponds to a custom field associated with the MRSS entry.
[Presentation[]] presentations: An array of Presentation object instances indicating presentations scheduled for the group. Each Presentation instance can have the following values:
- [int] id: A unique identifier for the Presentation instance
- [string] name: The presentation name
- [string] type: The presentation type
[Permission[]] permissions: An array of Permission object instances representing permissions rules assigned to the Live Media feed

PUT

Modifies the specified LiveMediaFeed instance with the values in the request body.

Request Body

[string] name: The name of the Live Media feed
[string] ttl: The amount of time that the Live Media feed can be cached on the client (i.e. player) before it is refreshed from the source. Note that the caching behavior of the media files themselves is determined by settings on the player. The duration is formatted as "HH:MM:SS".
[FeedContent[]] content: An array of FeedContent object instances representing MRSS feed entries. Each FeedContent instance can have the following values:
- [int] contentId: The ID of the Content instance associated with the MRSS entry
- [string] fileName: The filename of the Content instance associated with the MRSS entry
- [string] title: The key (MRSS item title) of the entry
- [string] description: The value (MRSS item description) of the entry
- [string] displayDuration: The amount of time an image file will be displayed before transitioning to the next entry. The duration is formatted as "HH:MM:SS". This value does not apply to audio or video files and will default to a "00:00:00" value regardless of the passed value.
- [bool] validityStartDate: A UTC value that determines the validity start date for the entry (i.e. the point at which it will start being included in the Live Media feed).The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ. A null value specifies that the item is valid immediately when added to the Live Media feed.
- [bool] validityEndDate: A UTC Value that determines the validity end date for the associated entry (i.e. the point at which it will no longer be included in the Live Media Feed). The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ. A null value specifies that the item will be valid until it is removed from the Live Media feed manually by a user.
- [CustomField] customFields: An object containing key:value pairs. Each pair corresponds to a custom field associated with the MRSS entry.

Response Body

[int] id: A unique identifier for the LiveMediaFeed instance
[string] name: The name of the Live Media feed
[string] ttl: The amount of time that the Live Media feed can be cached on the client (i.e. player) before it is refreshed from the source. Note that the caching behavior of the media files themselves is determined by settings on the player. The duration is formatted as "HH:MM:SS".
[string] physicalPath: The location of the feed XML file in the server directory
[int] fileSize: The size of the feed XML file (in bytes)
[string] fileHash: The hash algorithm and the value that results from performing the hash algorithm on the file. The string is formatted as "{algorithm}:{value}" (e.g. "SHA1:6DB465879088280AAC52DC22B07ED0AD493A99D4").
[string] creationDate: A UTC timestamp indicating when the Live Media feed was created on BSN. The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ.
[FeedContent[]] content: An array of FeedContent object instances representing MRSS feed entries. Each FeedContent instance can have the following values:
- [int] contentId: The ID of the Content instance associated with the MRSS entry
- [string] fileName: The filename of the Content instance associated with the MRSS entry
- [string] title: The key (MRSS item title) of the entry
- [string] description: The value (MRSS item description) of the entry
- [string] displayDuration: The amount of time an image file will be displayed before transitioning to the next entry. The duration is formatted as "HH:MM:SS". This value does not apply to audio or video files and will default to a "00:00:00" value regardless of the passed value.
- [bool] validityStartDate: A UTC value that determines the validity start date for the entry (i.e. the point at which it will start being included in the Live Media feed).The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ. A null value specifies that the item is valid immediately when added to the Live Media feed.
- [bool] validityEndDate: A UTC Value that determines the validity end date for the associated entry (i.e. the point at which it will no longer be included in the Live Media Feed). The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ. A null value specifies that the item will be valid until it is removed from the Live Media feed manually by a user.
- [CustomField] customFields: An object containing key:value pairs. Each pair corresponds to a custom field associated with the MRSS entry.
[Presentation[]] presentations: An array of Presentation object instances indicating presentations scheduled for the group. Each Presentation instance can have the following values:
- [int] id: A unique identifier for the Presentation instance
- [string] name: The presentation name
- [string] type: The presentation type
[Permission[]] permissions: An array of Permission object instances representing permissions rules assigned to the Live Media feed

DELETE

Removes the specified LiveMediaFeed instance from the network. The server returns code 204 if successful and code 404 if the LiveTextFeed instance could not be found.