Data-API

 

Methods

Version 2.1

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.

albums.addMedia

Add media to album.

albums.create

Create an album for logged in user.

albums.get

Retrieve a list of albums by albumid.

albums.getBuiltin

Retrieve one or more default (always existing) album(s) for logged in user.

albums.removeMedia

Remove media from album.

hubs.updateMedia

Update the media associated with a hub.

media.addSpotted

Add a spotted user to the media.

media.addTag

Add a list of coma separated tags to a media.

media.createRespect

Create respect for an mediaid.

media.get

Retrieve a list of media by mediaid.

media.getByAlbum

Retrieve all media from an album.

media.getByTag

Retrieve public media by tag.

media.getComments

Retrieve the comments for a mediaid.

media.getMediaEditToken

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.

media.getPublic

Retrieve public media. Sorttype defines the sort.

media.getRespects

Retrieve the respects for a mediaid.

media.getSpotted

Retrieve the spotted users on a media.

media.getUploadToken

Retrieve an upload token and ip-address to initiate the upload of media.

media.update

Update a media.

media.updateGeolocation

Update or create geolocation of a media.

albums.getByHub

Retrieve all visible albums of a hub.

albums.getByUser

Retrieve all visible albums of a user.

media.getByLoggedin

Retrieve all media by logged in user.