JSON feeds, RSS feeds and ICS files are web feeds for syndicating content to third-party apps and platforms. These feeds are useful because they make it easy to collect and organise data, and then present that data, or use that data in a variety of different ways.
JSON feeds provide an easy-to-read format for exchanging data between different systems. They are easy to parse, manipulate and integrate with a wide variety of programming languages and platforms. This makes it a great option for developers who want to build web applications that can access and consume data from different sources, such as Events created in your MSL System. JSON feeds can be used to export event information from your MSL System for display on external websites.
RSS feeds allow users to easily stay updated with the latest content from their favourite websites, and other online sources. Instead of having to manually visit a website to check for updates, users can subscribe to the website's RSS feed and receive updates automatically. This makes it much easier and more efficient to stay informed about the latest Events taking place at your Students' Union or Venue.
ICS files are commonly used to store and exchange calendar information between different applications or devices. ICS files can include Event details such as the start and end time of an event, its location, description, and other relevant information. ICS files are exported ready to be imported into a user's calendar application.
TABLE OF CONTENTS
You can access this feature from your MSL website.
For further information, see Events Overview.
Events Feeds Querystring Parameters
This table lists and explains the Querystring Parameters that can be used by Events Feeds:
| URL Parameter Name | Data Type | Definition |
|---|---|---|
| subtree | True/False | This specifies whether to include results from child organisations of the specified Organisation ID. The default value is False. |
| imagesize | String | This specifies the thumbnail sizes in image URLs e.g. 'small' / 'medium' / 'large'. These sizes must be set on a website and feed basis, along with the resize type. Names are not limited to small/medium/large, allowing for specific requirements. For further information, see How to Set Up JSON Events Feeds. This parameter is only applicable to JSON feeds. |
| types | Comma-separated list of Event Types (system names) | Specify a comma-separated list of Event Types (the system name, rather than the display name) e.g. types=pop,Frisky. This data type is case insensitive and will include events if any of their types match any of the specified values. For further information, see Event Types. This parameter is only applicable to JSON feeds. |
| date | Date string in format 'yyyy-mm-dd' | If specified, the feed will only include events that are taking place on that specific date. This parameter overrides the 'from' and 'to' dates. |
| from | Date string in format 'yyyy-mm-dd' | If from and to dates are specified, the feed will only include events in that date range. |
| to | Date string in format 'yyyy-mm-dd' | If from and to dates are specified, the feed will only include events in that date range. |
| includeOngoing | True/False | If includeOngoing=false is not specified, the feed will include all ongoing events by default, rather than only those with a start or end date in the specified date range. This parameter is only applicable to JSON feeds. |
| programmeOnly | True/False | If programmeOnly=false is not specified, the feed will only include programme events. For further information, see Events in Events Admin. |
| includeTicketPrices | True/False | This specifies whether to include the MinTicketPrice and MaxTicketPrice values. This parameter is only applicable to JSON feeds. |