API - Search try-outs
Search all upcoming public try-outs within a geographical area
URL: http://api.localhost.com:3000/try_outs
HTTP Method: Get
Parameters
- key - Your API key Required
- page - Results page number (default is 1)
- keywords - Search for a try-out name and the associated idea tags
- location_id - A location ID to find try-outs closest too Required
Error codes
- 401 - Not Authorized
- 404 - Not Found
- 500 - Internal Server Error
Available API methods
The following API methods are available to use.
Ideas
- Get idea details - Returns details of an idea
- Search ideas - Search all active ideas
Locations
- Get location details - Returns details of a location
- Search for a location - Returns details of a location
Try-outs
- Get try-out details - Returns details of a try-out
- Search try-outs - Search all upcoming public try-outs within a geographical area
Users
- Get user details - Returns details of a user
- Get a users friends list - Displays a users friends list
- Get a users ideas list - Returns a list of ideas that the user has added
- Search for a user - Search for a user by name and email address
Example Response
<try-outs type="array">
<try_out>
<date>2008-08-23</date>
<description>Take a trip over to your local festival.</description>
<id type="integer">7</id>
<idea_id type="integer">7</idea_id>
<location>
<administrative_division_1_name>England</administrative_division_1_name>
<administrative_division_2_name>Borough of Reading</administrative_division_2_name>
<city>Reading</city>
<country>United Kingdom</country>
<latitude>51.464298</latitude>
<longitude>-0.983442</longitude>
<location>Richfield Avenue</location>
<postcode/>
</location>
<name>Go to a music festival</name>
<time>11am till 11:30pm</time>
<updated_at>Tue Jun 24 12:28:34 UTC 2008</updated_at>
<user_id>6</user_id>
<who_can_attend>Anyone</who_can_attend>
</try_out>
<try_out>
<date>2008-08-23</date>
<description>Take a trip over to your local festival.</description>
<id type="integer">8</id>
<idea_id type="integer">7</idea_id>
<location>
<administrative_division_1_name>England</administrative_division_1_name>
<administrative_division_2_name/>
<city>London</city>
<country>United Kingdom</country>
<latitude>51.464298</latitude>
<longitude>-0.983442</longitude>
<location>Richfield Avenue</location>
<postcode/>
</location>
<name>Go to a music festival</name>
<time>From 11am</time>
<updated_at>Tue Jun 24 12:28:34 UTC 2008</updated_at>
<user_id>6</user_id>
<who_can_attend>Anyone</who_can_attend>
</try_out>
</try-outs>
