API Method /venues/links/new
Adds a new link to a venue. See http://eventful.com/venues/V0-001-000102695-2 for an example interface.
Arguments
- authentication
- This method requires user authentication.
- id string
- The ID of the venue to which this link is being added.
- link string
- The URL of the link. (e.g. "http://foo.com")
- description string
- The title of the link. (e.g. "Foo Laboratories") (optional)
- link_type_id integer
- The ID of the link type, as found in this list:
| ID | Link Type |
|---|
| 15 | Blog |
| 2 | Box Office |
| 8 | Chat |
| 1 | Info |
| 3 | News |
| 17 | Official Site |
| 18 | Podcast |
| 4 | Review |
| 5 | Sponsor |
| 6 | Tickets |
| 14 | Webcast |
| 19 | Website |
| 16 | Other |
Example Request
Here's an example request URL:
http://api.evdb.com/rest/venues/links/new?...&id=V0-001-000102695-2&link=http://foo.com&description=Foo&link_type_id=17
Output Parameters
Output from this function is an XML block with the following constructs:
- status string
- ok
- messagestring
- Link added successfully.
Example XML Response
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
<message>Link added successfully.</message>
</response>
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 field was not provided.