API Method /calendars/events/rss
This function returns an RSS 2.0 (Specification) feed of events contained in a specified calendar.
Arguments
- authentication
- This method controls access via optional user authentication.
- id string
- The id of the calendar to use as the feed source.
-
-
Example Request
Here's an example search URL:
http://api.evdb.com/rest/calendars/events/rss?...&id=C0-001-000002448-9
Output Parameters
Output from this function is an XML-formed RSS 2.0 channel with the following constructs:
- title string
- Title of calendar.
- link string
- Source of RSS feed. (http://eventful.com/)
- description string
- Calendar description.
- language string
- Default "en-US".
- copyright string
- Required by RSS 2.0 format.
- category string
- Required by RSS 2.0 format.
- generator string
- Required by RSS 2.0 format.
- docs string
- Required by RSS 2.0 format.
- ttl string
- Required by RSS 2.0 format.
- item tag
- Each item entry has the following structure:
- title string
- The event title.
- description string
- The event description. In RSS, this includes the start time, end time, venue, venueid, tags, and description.
- category string
- Unused.
- pubDate string
- The timestampt of the most recent modification. (e.g. "Mon, 26 Sep 2005 08:33:28 -0700")
- guid string
- The unique ID for this event, it is the event's Eventful URL.
- link string
- URL of associated event on Eventful site.
- pubDate string
- Required by RSS 2.0 format.
- lastBuildDate string
- Required by RSS 2.0 format.
Example RSS 2.0 Response
<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0">
<channel>
<title>inging in Los Angeles</title>
<link>http://eventful.com</link>
<description>...</description>
<language>en-US</language>
<copyright>...</copyright>
<category>Events</category>
<generator>EVDB RSS Generator v1.2</generator>
<docs>http://blogs.law.harvard.edu/tech/rss</docs>
<ttl>60</ttl>
<item>
<title>Los Angeles Ducati Bike Night</title>
<link>http://eventful.com/events/E0-001-000487927-6</link>
<description>...</description>
<category></category>
<pubDate>Wed, 02 Nov 2005 19:46:53 -0800</pubDate>
<guid isPermaLink="true">http://eventful.com/events/E0-001-000487927-6</guid>
</item>
...
<pubDate>Wed, 02 Nov 2005 19:46:53 -0800</pubDate>
<lastBuildDate>Wed, 02 Nov 2005 19:46:53 -0800</lastBuildDate>
</channel>
</rss>
Error Codes
This method may return these errors in an error document:
- Authentication error
- The specified user was not found or provided invalid credentials.
- Missing parameter
- A mandatory parameter was not set.
- Not found
- There is no venue with that identifier.
-
-