API
|
Starting in version 0.2.11, the Ubuntu LoCo Directory provides a collection of Restful/JSON APIs for accessing the data it provides.
Contents
Available Services
All services support GET requests only, there is no write-support available at this time. Service URLs return Collections of objects if no id is given, or an individual Entity if the entity's id is appended to the end of the url. When using a Collection path, a query string may be used to filter the results using fieldname=value.
Teams
URL: http://loco.ubuntu.com/services/teams/
Returns a collections of LoCo Team objects. An individual team can be referenced by appending the team id to the end of the url.
Examples:
http://loco.ubuntu.com/services/teams/13/ - Entity URL for the Florida LoCo Team.
http://loco.ubuntu.com/services/teams/?approved=1 - List only Approved LoCo teams
http://loco.ubuntu.com/services/teams/?countries__name=United+States - List all LoCo teams in the United States
Global Events
URL: http://loco.ubuntu.com/services/global/
Returns a collections of Global Event objects. An individual event can be referenced by appending the event id to the end of the url.
Examples:
http://loco.ubuntu.com/services/global/17/ - Entity URL for the Ubuntu Hour Global Event.
http://loco.ubuntu.com/services/global/?date_end__gte=2010-06-21 - List events ending on or after June 21st, 2010.
Team Events
URL: http://loco.ubuntu.com/services/events/
Returns a collections of Team Event objects. An individual event can be referenced by appending the event id to the end of the url.
Examples:
http://loco.ubuntu.com/services/events/1/ - The first Team event registered in the LoCo Directory
http://loco.ubuntu.com/services/events/?date_begin__gte=2010-06-21 - List events starting on or after June 21st, 2010.
http://loco.ubuntu.com/services/events/?teams=13 - List events for the Florida LoCo Team.
http://loco.ubuntu.com/services/events/?global_event=17 - List all team events that are part of the Ubuntu Hour Global Event.
Venues
URL: http://loco.ubuntu.com/services/venues/
Returns a collections of Event Venue objects. An individual venue can be referenced by appending the venue id to the end of the url.
Examples:
http://loco.ubuntu.com/services/venues/1/ - The first venue registered in the LoCo Directory
http://loco.ubuntu.com/services/venues/?country=231 - List of venues in the United States.
http://loco.ubuntu.com/services/venues/?teamevent__teams=13 - List of event venues used by the Florida LoCo Team.
http://loco.ubuntu.com/services/venues/?teamevent__date_end__gte=2010-06-21 - List of venues for events ending on or after June 21st, 2010.
Comments
URL: http://loco.ubuntu.com/services/comments/
Returns a collections of user Comment objects. An individual comment can be referenced by appending the comment id to the end of the url.
Examples:
http://loco.ubuntu.com/services/comments/1/ - The first comment registered in the LoCo Directory
http://loco.ubuntu.com/services/comments/?team_event=2 - List of comments for a specific Team Event.
http://loco.ubuntu.com/services/comments/?comment_by=32 - List of comments made by a specific user.
Attendees
URL: http://loco.ubuntu.com/services/attendees/
Returns a collections of registration Attendee objects. An individual attendee can be referenced by appending the attendee id to the end of the url.
Examples:
http://loco.ubuntu.com/services/attendees/1/ - The first registered Attendee in the LoCo Directory
http://loco.ubuntu.com/services/attendees/?team_event=2 - List of attendees registered for a specific Team Event.
http://loco.ubuntu.com/services/attendees/?attendee=32 - List of registrations for a specific user
http://loco.ubuntu.com/services/attendees/?attendee=32&team_event__date_begin__gte=2010-06-21 - List of registrations for a specific user for events starting on or after June 21st, 2010.
Team Meetings
URL: http://loco.ubuntu.com/services/meeting/
Returns a collections of Team IRC Meeting objects. An individual meeting can be referenced by appending the meeting id to the end of the url.
Examples:
http://loco.ubuntu.com/services/meeting/1/ - The first Team IRC Meeting registered in the LoCo Directory
http://loco.ubuntu.com/services/meeting/?date_begin__gte=2010-06-21 - List meetings starting on or after June 21st, 2010.
http://loco.ubuntu.com/services/meeting/?teams=13 - List meetings for the Florida LoCo Team.
http://loco.ubuntu.com/services/meeting/?chair__user=32 - List all team meetings being chaired by a specific user.
http://loco.ubuntu.com/services/meeting/?agenda__owner__user=32 - List of team meetings where a specific user has an agenda item
Agenda Items
URL: http://loco.ubuntu.com/services/agenda/
Returns a collections of Agenda Item objects. An individual agenda item can be referenced by appending the item id to the end of the url.
Examples:
http://loco.ubuntu.com/services/agenda/1/ - The first agenda item in the LoCo Directory
http://loco.ubuntu.com/services/agenda/?team_event=2 - List of agenda items for a specific Team Event.
http://loco.ubuntu.com/services/agenda/?meeting=1 - List of agenda items for a specific meeting
http://loco.ubuntu.com/services/agenda/?owner__user=32 - List of agenda items for a specific user
http://loco.ubuntu.com/services/agenda/?owner__user=32&meeting=1 - List of agenda items for a specific user for a specific meeting.
http://loco.ubuntu.com/services/agenda/?owner__user=32&meeting__date_begin__gte=2010-06-21 - List of agenda items for a specific user for meetings starting on or after June 21st, 2010.
Users
URL: http://loco.ubuntu.com/services/users/
Returns a collections of User objects, these contain only Launchpad user name and team membership information. An individual user can be referenced by appending the user id to the end of the url.
Examples:
http://loco.ubuntu.com/services/users/32/ - Entity URL for Michael Hall.
http://loco.ubuntu.com/services/users/?groups=13 - List of Users in the Florida LoCo Team.
Groups
URL: http://loco.ubuntu.com/services/groups/
Returns a collections of Group objects, these contain only Launchpad team name. An individual group can be referenced by appending the group id to the end of the url.
Examples:
http://loco.ubuntu.com/services/groups/13/ - Entity URL for the Florida LoCo Group.
http://loco.ubuntu.com/services/groups/?user=32 - List of groups that a specific user is a member of.
Admins
URL: http://loco.ubuntu.com/services/admins/
Returns a collections of Admin objects, these contain only Launchpad username of a Team admin. An individual admin can be referenced by appending the admin id to the end of the url.
Examples:
http://loco.ubuntu.com/services/admins/3333816 - Entity URL for a specific Admin.
http://loco.ubuntu.com/services/admins/?team=13 - List of Admins for the Florida LoCo Group.
Countries
URL: http://loco.ubuntu.com/services/countries/
Returns a collections of Country objects, these relate to the country or countries a LoCo Team is from. An individual country can be referenced by appending the country id to the end of the url.
Examples:
http://loco.ubuntu.com/services/countries/231 - Entity URL for United States.
http://loco.ubuntu.com/services/countries/?team=13 - List of Countries for the Florida LoCo Group.
Continents
URL: http://loco.ubuntu.com/services/continents/
Returns a collections of Continent objects, these relate to the continent or continents a Country is on. An individual continent can be referenced by appending the continent id to the end of the url.
Examples:
http://loco.ubuntu.com/services/continents/1 - Entity URL for North America.
http://loco.ubuntu.com/services/continents/?country__team=13 - List of Continents for the Florida LoCo Group.
LoCoTeamPortal/API (last edited 2011-11-12 01:57:36 by ip72-196-101-83)