Data-API
Methods
Media
- albums.addMedia
- albums.create
- albums.get
- albums.getBuiltin
- albums.getByHub
- albums.getByUser
- albums.removeMedia
- hubs.updateMedia
- media.addSpotted
- media.addTag
- media.createRespect
- media.get
- media.getByAlbum
- media.getByLoggedin
- media.getByTag
- media.getComments
- media.getMediaEditToken
- media.getPublic
- media.getRespects
- media.getSpotted
- media.getUploadToken
- media.update
- media.updateGeolocation
Users
- albums.getByUser
- blogs.getByUser
- events.getByLoggedin
- gadgets.getByUser
- media.getByLoggedin
- privatespots.getByLoggedin
- users.createRespect
- users.get
- users.getByFriendLastlogin
- users.getByHubLastlogin
- users.getByUsername
- users.getFriendsByLoggedinSorted
- users.getLoggedin
- users.getRespects
- users.getScraps
- users.getTestimonials
- wwws.getByUser
Version 2.0
We are, as always, extremely interested in your feedback. If you find something unclear or something that could be improved, either in the API itself, the documentation, or in something else surrounding the API, please contact us.
note: Because we want to be able to extend the returned fields, the order in which the fields occur in the XML (or JSON) cannot be relied upon, and use of methods like "firstchild" to traverse the XML might result in unexpected results when we change the order! Parsers like XPath will not have any problem here.
media
Add media to album.
Create an album for logged in user.
Retrieve a list of albums by albumid.
Retrieve one or more default (always existing) album(s) for logged in user.
Remove media from album.
Update the media associated with a hub.
Add a spotted user to the media.
Add a list of coma separated tags to a media.
Create respect for an mediaid.
Retrieve a list of media by mediaid.
Retrieve all media from an album.
Retrieve public media by tag.
Retrieve the comments for a mediaid.
Retrieve a token that can be used to edit a media. Using this token, a new media upload action can be started, with other parameters. For convenience, the method returns the original url and current rotation degrees. The token is valid only for generating one new media.
Retrieve public media. Sorttype defines the sort.
Retrieve the respects for a mediaid.
Retrieve the spotted users on a media.
Retrieve an upload token and ip-address to initiate the upload of media.
Update a media.
Update or create geolocation of a media.
hubs, media
Retrieve all visible albums of a hub.
media, users
Retrieve all visible albums of a user.
Retrieve all media by logged in user.
auth
Retrieve an access token. The oauth_token parameter should contain an authorized request token. The access token will be valid for the methods the request token was requested for.
Retrieve a request token. The oauth_token parameter should be absent.
Revoke all accesstokens for user.
Revoke all accesstokens for Consumer.
Revoke current accesstoken.
other
Execute multiple (up to 10) API requests in 1 API-call.
Create a listener for the !ApiConsumer. See listeners for more information.
Delete a listener for the ApiConsumer. See listeners for more information.
Retrieve listeners.
Retrieve all listeners.
Retrieve listeners by type.
blogs
Create a blog.
Create respect for a blogid.
Retrieve a list of blogs by blogid.
Retrieve public blogs by tag.
Retrieve the comments for a blogid.
Retrieve the most recent blogs for the friends of the loggedin user.
Retrieve public blogs. Sorttype defines the sort.
Retrieve the respects for a blogid.
Update a blog.
blogs, hubs
Retrieve the most recent blogs of a hub.
blogs, users
Retrieve the most recent blogs of a user.
buzz
Retrieve buzz for famous hyvers.
chat
Get an server-ipadress and logintoken for the chat-system.
location
Retrieve cities.
Retrieve countries.
Create a privatespot.
Retrieve a list of privatespots by privatespotid.
Retrieve regions.
events
Add user presence to event.
Retrieve a list of events by eventid.
Retrieve all public events where the given user is present.
Retrieve all userid's that are present for given event.
events, hubs
Retrieve events of a hub.
events, users
Retrieve all events created by logged in user.
events, friends
Retrieve all userid's for the friends that are present for given event.
layout
Converts a string to HTML format the same way that that is being done on the site, including things like smilies. See ha_fancylayout for more information.
Retrieve the existing smiley categories.
Retrieve the smileys for the user the supplied access token is for.
friends
Retrieve the friends of user the supplied access token is for.
Retrieve the connections between the user the access token is for and another user.
Retrieve the distance between the user the access token is for, and other users.
Retrieve all incoming invitations for the logged in user.
Retrieve all outgoing invitations for the logged in user.
gadgets
Create a gadget.
Create a gadget by XML url (OpenSocial gadgets).
Create respect for an gadgetid.
Retrieve a list of gadgets by gadgetid.
Retrieve the comments for a gadgetid.
Retrieve the respects for a gadgetid.
gadgets, hubs
Retrieve all gadgets of a hub.
gadgets, users
Retrieve all visible gadgets of a user.
hubs
Retrieve a list of hubcategories by hubcategoryid.
Retrieve all hubcategories by hubtype.
Retrieve a list of children hubcategories of a parent hubcategoryid.
Retrieve a list of hubs by hubid.
Retrieve all hubs within given hubcategoryid.
Retrieve a list of hubs by shortname.
Retrieve all hubs of a user.
Retrieve all the hubtypes.
Retrieve the scraps for a hub.
hubs, search
Search for hubs based on basic queries (keywords like city, name).
pings
Retrieve a list of pings by pingid.
Retrieve the pings of the target user.
Retrieve the pings of a user.
location, users
Retrieve all privatespots of logged in user.
search
Search items in partical categories by searchterms.
Search for users based on basic queries (keywords like city, name). It uses a flat index with firstname, lastname, nickname and cityname, and uses boolean and. This means that looking for "Veenendaal" will return all users with "Veenendaal" in their firstname, lastname, nickname or cityname. Searching for "Reinoud Haarlem", will return all users with both those words in the concatnated string of firstname, lastname, nickname, and cityname.
forums
Retrieve a list of threads by threadid.
Retrieve the comments for a threadid.
forums, hubs
Retrieve all threads of a hub.
tips
Create a tip.
Create respect for an tipid.
Retrieve a list of tips by tipid.
Retrieve the most recent tips of a user.
Retrieve all tip categories.
Retrieve the comments for a tipid.
Retrieve the respects for a tipid.
hubs, tips
Retrieve the most recent tips of a hub.
friends, tips
Retrieve the most recent tips for the friends of the loggedin user.
users
Create respect for a userid.
Retrieve basic information for one or more users.
Retrieve users for any hub, limited to 150 users sorted by last login.
Retrieve basic information for one or more users.
Retrieve the basic information for user the supplied access token is for.
Retrieve the respects for a userid.
Retrieve the scraps for a user.
Retrieve the testimonials for a userid.
friends, users
Retrieve friends for any visible user, limited to 150 users sorted by last login.
Retrieve friends by loggedin user with different sort-options.
friends, search
Search for friends based on basic queries (keywords like city, name).
wwws
Create a www.
Create respect for an wwwid.
Retrieve a list of wwws by wwwid.
Retrieve the comments for a wwwid.
Retrieve the respects for a wwwid.
Search for public www's.
hubs, wwws
Retrieve the most recent public www(Who What Where)s of a hub.
users, wwws
Retrieve the most recent www(Who What Where)s of a user.
friends, wwws
Retrieve the most recent www(Who What Where)s for the friends (1 www max per friend) of the loggedin user.