Evernote SDK for Java
Evernote API version 1.25
This SDK contains wrapper code used to call the Evernote Cloud API from Java applications.
For Android-specific code and samples, see the Evernote SDK for Android.
The SDK also contains two samples. The code in
sample/oauth demonstrates the basic use of the SDK. The code in
sample/client also demonstrates the basic use of API, but uses developer tokens instead of OAuth for authentication.
JavaDocs for the SDK are available at http://dev.evernote.com/documentation/reference/javadoc/.
Changes in version 1.25
- Added RelatedQuery.referenceUri
- New system exceptions thrown by getPublicNotebook and authenticateToSharedNote when the target content has been taken down.
- Added SharedNotebook.recipientSettings, NoteStore.setSharedNotebookRecipientSettings
- Added optional authenticationToken parameter to NoteStore.authenticateToSharedNote, only needed for YXBJ
- Added creatorId and lastEditorId fields to NoteAttributes
- Added two factor authentication functionality to UserStore.authenticate and authenticateLongSession, added UserStore.completeTwoFactorAuthentication.
Changes in version 1.24
- Added Error code for Rate Limiting via EdamErrorCode.RATE_LIMIT_REACHED and EdamSystemException.rateLimitDuraton
- Deprecated NoteStore.getSyncChunk in favor of NoteStore.getFilteredSyncChunk
- Deprecated NoteStore.findNotes in favor of NoteStore.findNotesMetaData
- Added BusinessUserInfo to User
- Added reminderOrder, reminderDoneTime, and reminderTime to NoteAttributes
- Added SavedSearchScope to SavedSearch
In order to use the Cloud API, you need to obtain an API key from http://dev.evernote.com/documentation/cloud. You'll also find full API documentation on that page.
In order to run the sample code, you need a user account on the sandbox service where you will do your development. Sign up for an account at https://sandbox.evernote.com/Registration.action
In order to run the client client sample code, you need a developer token. Developer tokens make it easy to learn your way around the API without needing to worry about OAuth. Get one at https://sandbox.evernote.com/api/DeveloperToken.action
Including the SDK in your project
The easiest way to incorporate the SDK into your Java project is to use Maven. If you're using Maven already, simply add a new dependency to your
<dependency> <groupId>com.evernote</groupId> <artifactId>evernote-api</artifactId> <version>1.25.1</version> </dependency>
If you'd prefer to build the SDK yourself, it's as simple as running
$ mvn package
evernote-sdk-1.25.1.jar in the target directory after the build completes. This single JAR contains everything needed to use the API.
Sample Code - Client
The code in
sample/client/EDAMDemo.java demonstrates the basics of using the Evernote API, using developer tokens instead of OAuth to simplify the authentication process while you're learning. Real applications that support multiple users need to use OAuth.
Build the SDK library
$ mvn package
Scroll down to the top of the
EDAMDemoclass and fill in your Evernote developer token.
On the command line, run the following command to compile the class:
$ javac -classpath ../../target/evernote-api-1.25.1.jar EDAMDemo.java
On the command line, run the following command to execute the sample app:
$ java -classpath .:../../target/evernote-api-1.25.1.jar EDAMDemo
Sample Code - OAuth
Real applications use OAuth to authenticate to the Evernote service. At the end of the OAuth flow you'll have an authentication token that you can use to access the Cloud API in the same way that the developer token is used in the client sample code. The code in
sample/oauth demonstrate the OAuth authentication process.
Open the file
Fill in your Evernote API consumer key and secret
Build the sample project:
$ cd sample/oauth $ mvn package
sample/oauth/target/EDAMWebTest.warto your servlet container (e.g. Tomcat)
Load the web application in your browser (e.g.
Sample Code - Scala / Play
- Open the file
- Fill in your Evernote API consumer key and secret
- Run project with
- Load the web application in your browser (e.g.
Sample Code - Clojure
A user-community Clojure wrapper to the Evernote Java SDK is available at https://github.com/mikebroberts/clojurenote . The library provides OAuth authentication, read/write capabilities (using an OAuth access token, or developer token) and ENML to HTML translation. A sample compojure / ring app is also provided to show how OAuth workflow can be implemented.