API Method /venues/ical
This function returns an iCalendar (RFC-2445) (not XML) document of events occuring at a specified venue.
Arguments
- authentication
- This method controls access via authentication.
- id string
- The id of the venue to use as the feed source.
-
-
Example Request
Here's an example search URL:
http://api.eventful.com/rest/venues/ical?...&keywords=concert&location=san+diego
Output Parameters
Output from this function is an VCALENDAR block with the following constructs:
- METHOD string
- Always "PUBLISH". Required by iCal format.
- CALSCALE string
- Always "GREGORIAN". Required by iCal format.
- PRODID string
- Required by iCal format.
- VERSION string
- Required by iCal format.
- X-WR-CALNAME string
- The venue name.
- VEVENT array
- An array of VEVENT events. Each event entry has the following structure:
- DTSTART string
- The event start time, in ISO 8601 format (e.g. "20050301T190000").
- DTEND string
- The event end time, in ISO 8601 format (e.g. "20050301T190000").
- DTSTAMP string
- The last modified time, in ISO 8601 format (e.g. "20050301T190000").
- SUMMARY string
- The event title.
- DESCRIPTION string
- The event description.
- LOCATION string
- The venue name.
- SEQUENCE integer
- Always 0.
- UID string
- The unique ID for this event.
- URL string
- URL of associated event on Eventful site.
Example iCalendar Response (indented for clarity, actual response does not contain spaces.)
BEGIN:VCALENDAR
METHOD:PUBLISH
CALSCALE:GREGORIAN
PRODID:-//EVDB//www.evdb.com//EN
VERSION:2.0
X-WR-CALNAME:University of California\, San Diego (UCSD)
BEGIN:VEVENT
DTSTART:20051113T140000
DTSTAMP:20051029T234505Z
SUMMARY:Free Sunday Afternoon Tours of UCSD @UCSD
DESCRIPTION:...
LOCATION:University of California\, San Diego (UCSD)
SEQUENCE:0
UID:E0-001-000437754-7
URL:http://eventful.com/E0-001-000437754-7
END:VEVENT
...
END:VCALENDAR
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.
-
-