Лекция "Разрабатываем приложения с API Evernote"

1. Разрабатываем с
Evernote API
Тарас Семененко

2. Что такое Eve rnote ?

3. Всё началось с блокнота...

4. ...стало Вашей дополнительной памятью
Хранилище файлов
Протоколирование совещаний
Сканирование договоров
Сохранение рецептов

5. 2,3 млн .
пользователей в России и СНГ

6. Продукты Eve rnote
Evernote
Penultimate
Clearly
Skitch
Food
Hello
Web Clipper
Peek

9. Приложения , проверенные и работающие с Evernote

10. Пользователи Evernote хотят еще
больше приложений
Продвигай своё приложение среди сообщества более
75 млн. пользователей

11. Создай своё
приложение с Evernote
приложение с Evernote

12. Eve rnote
Два главных фактора перехода на Премиум:
Премиум
• Когда пользователь использует Evernote на
более чем одном устройстве
• Когда пользователь использует стороннее
приложение для синхронизации с Evernote
• Когда пользователь использует стороннее
приложение для синхронизации с Evernote
• Когда пользователь использует стороннее

13. Наша цель
Найти крутые приложения для наших
пользователей, чтобы помочь максимально
эффективно использовать Evernote

14. Мы хотим
•Разработчики были успешны
•Продвигать крутые приложения

15. Каналы провижения
• Галерея
• Промо-баннеры на сайте evernote.com
• промо-баннеры в приложениях для Mac OS и Windows Desktop
• русскоязычный блог, блог на Хабре
• почтовая рассылка, твиттер

17. Eve rnote API

18. Ключевые моменты Evernote API
• Ядро нашего продукта : Evernote API используется более 30,000 внешними разработчиками и
нашими собственными приложениями одинаково. (12 млрд. вызовов API делается каждый месяц!)
• Apac he Thrift, не Re s t API: Мы сами заботимся о соединении, просто вызывайте методы нашего
SDK из вашего приложения
• Одинаковая функции: Доступна вся функциональность Evernote (OCR, Files, Audio, etc)
• Все платформы : SDK для всех доступных платформ находится на github.

19. Note Store
Note Store
Note Store
Note Store
Note Store
Note Store
Note Store
Thrift
User Store

20. Eve rnote API: основные функции
• Доступ к пользовательскому или бизнес аккаунту Evernote
• Чтение/Создание/Поиск заметок
• Поиск связанных заметок (FindRelated)
• Напоминания (Reminders)
• Sharing и Business

21. Eve rnote API: авторизация
• OAuth
• По специальному токену
(для разработчиков)

22. Eve rnote API: ENML
• <en-note>
• <en-media>
• <en-crypt>
• <en-todo>

23. Eve rnote API: особые заметки
• Привязаны к конретному приложению
• Доступны только для чтения (из основного клиентского
приложения)
• Атрибуты: applicationData (4 Кб), contentClass

24. Eve rnote API: эскизы
• На нашем сервере для каждой заметки создается
эскиз (изображение размером 300x300)
• Эти эскизы можно использовать в вашем приложении
• Для получения POST-запрос на URL:
https://[sandbox|www].evernote.com/shard/shardID/thm/note/GUID[?size=75]

25. • Создать аккаунт на
sandbox.evernote.com
• Получить ключ
• Загрузить SDK
• Начать использовать API

26. Evernote API обработка скриншотов
Личный опыт

29. QuickTime™ and a
Photo - JPEG decompressor
are needed to see this picture.

30. Eve rnote API: получение заметок
my $user_store_url = 'https://' . $evernote_host . '/edam/user';
my $user_store_client = Thrift::HttpClient->new($user_store_url);
my $user_store_prot = Thrift::BinaryProtocol->new( $user_store_client );
my $user_store = EDAMUserStore::UserStoreClient->new( $user_store_prot, $user_store_prot );
my $note_store_url = $user_store->getNoteStoreUrl( $auth_token );
my $note_store_client = Thrift::HttpClient->new( $note_store_url );
my $note_store_prot = Thrift::BinaryProtocol->new( $note_store_client );
my $note_store = EDAMNoteStore::NoteStoreClient->new( $note_store_prot, $note_store_prot );
my $notebook = $note_store->getNotebook( $auth_token, $nb_guid );
my $filter = new EDAMNoteStore::NoteFilter({notebookGuid => $nb_guid});
my $spec = new EDAMNoteStore::NotesMetadataResultSpec({includeTitle => 1, includeAttributes => 1});
my $note_metadata_list = $note_store->findNotesMetadata( $auth_token, $filter, $read_notes, 1000, $spec);

31. Eve rnote API: создание заметки
my $note = EDAMTypes::Note->new();
$note->title($hash_hex);
$note->notebookGuid($nb_guid);
my $data = EDAMTypes::Data->new();
$data->size(length $image_binary);
$data->bodyHash($gd_md5);
$data->body($gd_data);
my $resource = EDAMTypes::Resource->new();
$resource->mime("image/$image_ext");
$resource->data($data);
$resource->attributes(EDAMTypes::ResourceAttributes->new());
$resource->attributes->fileName($filepath);

32. Eve rnote API: создание заметки
$note->content( '<?xml version="1.0" encoding="UTF-8"?>' .
'<!DOCTYPE en-note SYSTEM "http://xml.evernote.com/pub/enml2.dtd">' .
'<en-note><br/><en-media type="image/'.$image_ext.'" hash="' . $gd_hash_hex . '"/></en-note>' );
my $created_note = $note_store->createNote($auth_token, $note);
$note_store->deleteNote($auth_token, $note_guid);

33. Для разработки
Новые ресурсы и средства для сообщества разработчиков Evernote

34. de v.e ve rnote .c om
• Переформирован и часто обновляется нашими
командами редакторов и технических специалистов
• Документация, примеры и пошаговые руководства для
лучшего понимания Evernote API
• Первый шаг в поиске ответов на вопросы и поддержке от
сообщества разработчиков Evernote
• Представляет самые новые особенности и функции,
доступные для разработчиков

35. S DKs & S ample s
github.c om/ ve rnote
e
github.c om/ ve rnote
e
• Репозиторий, поддерживаемый нашим сообществом
разработчиков
• Документация, примеры и пошаговые руководства для
лучшего понимания Evernote API
• Первый шаг в поиске ответов на вопросы и поддержке от
сообщества разработчиков Evernote
• Представляет самые новые особенности и функции,
доступные для разработчиков

36. EVERNOTE
Форумы разработчиков
Форумы разработчиков
• Место, где вы можете получить отзыв и оценку
относительно использования Evernote API
• Наши команды поддержки активно отвечают и
отслеживают изменения в текущих обсуждениях
• Разработчики Evernote и ключевые инженеры также
просматривают и отвечают на вопросы.
• В нашем сообществе на форумах более 150 бета
тестеров, которым можно предложить протестировать
новые интеграции Evernote

37. Обновления с прошлого года...
• Новые SDK: Ruby, Python, JS (Node/Phonegap/Windows Metro), Android rebuilt, iOS rebuilt
• Обновление документации : dev.evernote.com полностью перестроен и курируется нашим
техническим редактором
• Безопасность / Аутентификация : Улучшена реализация механизма oAuth, добавлена
обработка прав доступа
• Eve rnote Bus ine s s API: Предоставлена более полная информация о нашем новом Business API
• Рост нашей команды : Наша команда опять увеличилась в 3 раза, новые инженеры, дизайнеры и
эксперты!
• Руководства для быстрого старта : Полные пошаговые инструкции для iOS, Ruby, Javascript и
Python

38. Мастер-классы API доступны в Интернете
Вы можете скачать слайды, посмотреть видео и послушать обсуждения на http://bit.ly/144MDjN

39. Спасибо !
Тарас Семененко
dev.evernote.com