Version: Alpha-1

Released: 1 September 2014

Important note: this is an early pre-release version, and is subject to change.

The SDK provides a convenient library for accessing the Mendeley API from Android applications.

Android version: API level 14 (Android 4.0, ICS)

Java version: 1.7

A sample app is provided, which illustrates basic use of the library. The app links to the SDK library via a relative path in its project.properties file, as usual for Android libraries.

To run the sample app you must change the dummy client ID, client secret and redirect URI constants defined at the top of ExampleActivity.java to the correct ones for your own app. These values can be generated from the Mendeley developers website.

You should start by calling MendeleySdkFactory.getInstance() to get a MendeleySdk object. This contains methods for all the API calls, as well as isSignedIn(), signIn() and signOut(). The client must call signIn() before making API calls, otherwise a NotSignedInException will be thrown.

Many of the API calls take parameters, which are defined in the com.mendeley.api.params package. They return a callback defined in one of the of com.mendeley.api.callbacks.* subpackages. The data types returned are defined in the com.mendeley.api.model package. On failure, they either invoke the appropriate callback, or raise an exception from the com.mendeley.api.exceptions package.

Reference documentation: Javadoc

The main API calls provided by MendeleySdk methods are as follows (arguments omitted for brevity):

getDocuments
getDocument
getDeletedDocuments
postDocument
patchDocument
trashDocument
deleteDocument
getDocumentTypes

getFiles
getFile
cancelDownload
postFile
deleteFile

getMyProfile
getProfile

getFolders
getFolder
postFolder
patchFolder
deleteFolder
getFolderDocumentIds
postDocumentToFolder
deleteDocumentFromFolder

getImage

getGroups
getGroup
getGroupMembers

Email: api@mendeley.com