EC3 Workshop - Evernote API with Mobile SDKs

Mustafa Furniturewala Evernote

Mobile SDKs: Getting Started with the Evernote API

Monday, September 30, 13

#EC2013

Evernote API

• Access to a user’s Evernote account/business

• Read/Create/Find notes

• FindRelated/Reminders


#EC2013

Mobile SDK’s


#EC2013

Mobile SDK’s

• Easy to use - hide complexities


#EC2013

Mobile SDK’s


• Local API’s


#EC2013

Mobile SDK’s


• Local API’s

• Support popular environments (cocoapods/maven)


#EC2013

Mobile SDK’s


• Local API’s

• Support popular environments (cocoapods/maven)

• Wrappers


#EC2013

Getting started


#EC2013

Getting started


#EC2013

Getting started

1. Create an account on sandbox.evernote.com


#EC2013

Getting started


2. Get your consumer key


#EC2013

Getting started



3. Download the SDK


#EC2013

Getting started



3. Download the SDK

4. Start using the API’s


#EC2013

Authentication


#EC2013

Authentication

1. OAuth 1.0a


#EC2013

Authentication

1. OAuth 1.0a

2. Mobile SDK’s handle everything for you


#EC2013

Authentication

1. OAuth 1.0a


3. Github


#EC2013

Yinxiang Biji


http://thenextweb.com/asia/2012/05/10/evernote-launches-yinxiang-biji-its-separate-service-in-china/


#EC2013

Yinxiang Biji

1. Evernote’s China service




#EC2013

Yinxiang Biji


2. Bootstrapping




#EC2013

Yinxiang Biji


2. Bootstrapping





#EC2013

Yinxiang Biji


2. Bootstrapping





#EC2013

Getting started


#EC2013

Getting started


#EC2013

Getting started

•[EvernoteSession sharedSession]


#EC2013

Getting started


•- (void)authenticateWithViewController:completionHandler:


#EC2013

Getting started



•[EvernoteUserStore userStore]


#EC2013

Getting started




•[EvernoteNoteStore noteStore]


#EC2013

Getting started




•[EvernoteNoteStore noteStore]


#EC2013

Note

Metadata

Body

Attachments


#EC2013

ENML

• Markup language for the body of a note

• Rich content

• Based on XHTML

• Validate against the DTD


#EC2013

ENML


#EC2013

ENML

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE en-note SYSTEM "http://xml.evernote.com/pub/enml2.dtd">

<en-note>

<div><en-todo></en-todo>Checkbox 1</div>

<div><en-todo checked="true"></en-todo>Checkbox 2</div>

<div><br clear="none"/></div>

<div><ol><li>Number 1</li><li>Number 2</li></ol></div>

</en-note>


http://xml.evernote.com/pub/enml2.dtd

http://xml.evernote.com/pub/enml2.dtd

#EC2013

ENML


#EC2013

ENML

en-note


#EC2013

ENML

en-note

en-media


#EC2013

ENML

en-note

en-media

en-crypt


#EC2013

ENML

en-note

en-media

en-crypt

en-todo


#EC2013

Write ENML


#EC2013

Write ENML

ENMLWriter - iOS only


#EC2013

Write ENML


(void) writeResource:(EDAMResource *)resource;


#EC2013

Write ENML



(void) writeEncryptedInfo:(ENEncryptedContentInfo *)encryptedInfo;


#EC2013

Write ENML



(void) writeEncryptedInfo:(ENEncryptedContentInfo *)encryptedInfo;

(void) writeTodoWithCheckedState:(BOOL)checkedState;


#EC2013

ENML Writer

EDAMData *edamData = [[EDAMData alloc] initWithBodyHash:dataHash size:myFileData.length body:myFileData];

EDAMResource* resource = [[EDAMResource alloc] init];

[resource setData:edamData];

[resource setMime:@"image/png"];

ENMLWriter* myWriter = [[ENMLWriter alloc] init]


#EC2013

ENML Writer

[myWriter startDocument];

[myWriter startElement:@"span"];

[myWriter startElement:@"br"];

[myWriter endElement];

[myWriter writeResource:resource];

[myWriter endElement];

[myWriter endDocument];


#EC2013

View ENML

ENML -> HTML

- (void) convertENMLToHTML:enmlContent completionBlock:


#EC2013

Sharing and Business


#EC2013


• Share notes/notebooks


#EC2013



• Business API


#EC2013



• Business API

• SDK’s help you out


#EC2013

Helpful SDK functions

• List notes for a shared notebook

• List all the business notebooks

• Create a business notebook

• Create a note in a business notebook


#EC2013

Example - Get all the Post-it® notes


#EC2013


EvernoteNoteStore *noteStore = [EvernoteNoteStore noteStore];


#EC2013



EDAMNoteFilter* noteFilter = [[EDAMNoteFilter alloc] init];


#EC2013




[noteFilter setWords:@"sourceApplication:postit"];


#EC2013





EDAMNotesMetadataResultSpec* metadataResultSpec = [[EDAMNotesMetadataResultSpec alloc] init];


#EC2013






[metadataResultSpec setIncludeTitle:YES];


#EC2013







[noteStore findNotesMetadataWithFilter:noteFilter offset:0 maxNotes:100 resultSpec:metadataResultSpec success:^(EDAMNotesMetadataList *metadata)} failure:^(NSError *error) {}];


#EC2013







[noteStore findNotesMetadataWithFilter:noteFilter offset:0 maxNotes:100 resultSpec:metadataResultSpec success:^(EDAMNotesMetadataList *metadata)} failure:^(NSError *error) {}];


#EC2013

Example - List notes from a shared notebook


#EC2013


EvernoteNoteStore *defaultNoteStore = [EvernoteNoteStore noteStore];


#EC2013



[defaultNoteStore listLinkedNotebooksWithSuccess:^(NSArray *linkedNotebooks) {


#EC2013






#EC2013





[defaultNoteStore listNotesForLinkedNotebook:linkedNotebooks[0] withFilter:noteFilter success:^(EDAMNoteList *list) { } failure:^(NSError *error) { }];}


#EC2013

Interact with the Evernote app


#EC2013


1. Create notes


#EC2013


1. Create notes

2. View a note


#EC2013


1. Create notes

2. View a note

3. Authentication


#EC2013


1. Create notes

2. View a note

3. Authentication

4. Intents on Android


#EC2013

Wrappers - Local API


#EC2013


- (void)viewNoteInEvernote:


#EC2013



- (void)saveNewNoteToEvernoteApp:


#EC2013



- (void)saveNewNoteToEvernoteApp:


#EC2013

Open source


#EC2013

Open source

Submit pull requests


#EC2013

Open source


Open issues


#EC2013

Open source


Open issues

Github.com/evernote


#EC2013

Popular apps

Pocket Lightly


#EC2013

Popular apps

Dolphin Browser


#EC2013

Thank you!

[email protected]

Questions?


mailto:[email protected]




Technology

EC3 Workshop - Evernote API with Mobile SDKs