Метод используется для получения списка закладок/заметок для книги.
См. также:
[w_replace_my_epub_notes] Перезапись выделений/цитат в формате epub;
[w_set_epub_bookmark_lock] Запросить блокировку выделения/цитаты в формате epub.
ID функции
r_my_epub_notes_incremental
Кто может вызывать
Авторизованный пользователь.
Авторизованное приложение.
Принимаемые параметры
Идентично r_my_epub_notes, но добавляется параметр:
checkpoint – время, начиная с которого надо получить обновления (не включительно). Используйте серверное время из ответа последнего запроса при следующем запросе, чтобы получать непрерывную ленту обновлений. Если не передано – возвращаются все закладки, независимо от времени последнего обновления.
Возвращаемые значения
Идентично r_my_epub_notes, но добавляется массив:
dropped_notes – массив, содержащий список ID удаленных заметок/закладок данной книги с момента преданного в параметре checkpoint . Присутствует, только если checkpoint был передан. Также следует иметь в виду, что информация об удалении заметок/закладок гарантированно хранится на сервере только сутки. Если ваш checkpoint отстал от текущего времени на 23 часа и более, следует получить ПОЛНЫЙ список заметок/закладок, используя запрос r_my_epub_notes. Инкрементальное обновление не гарантирует консистентность.
Если закладки/заметки для книги отсутствуют, то массив my_notes будет пустым.
Возможные ошибки
error_code | error_message | Описание |
---|---|---|
101061 | Несуществующая книга | Книга, к которой произошла попытка сохранить заметки, не существует в каталоге ЛитРес |
Пример запроса на сервер
{ "app": "1", "time": "2014-11-07T16:21:02+03:00", "sha": "b79d8e9993d20da6abe78838d3c7fbf640a4c52956569bef3c685d3453316b5c", "sid": "7bad5f2fb752ee957a4ab74aaac7711g", "requests": [ { "func": "r_my_epub_notes_incremental", "id": "my_notes", "param": { "checkpoint": "2014-11-07T16:11:15+03:00", "art": "568640" } ] }
Пример ответа сервера
{ "success": true, "time": "2014-11-07T16:21:02+03:00", "my_notes" : { "success" : true, "my_notes": [ { "id": "65830123-26b8-4b07-8098-c18229e5026e", "group": "0", "last_update": "2014-11-07T16:21:02+03:00", "part": "content2", "xpath_start": "DIV[1]/P[28]/text()[1]", "offset_start": "0" }, { "id": "65830123-26b8-4b07-8098-c18229e5026f", "group": "1", "last_update": "2014-11-07T16:21:15+03:00", "part": "content2", "xpath_start": "DIV[1]/P[44]/text()[1]", "offset_start": "7", "xpath_end": "DIV[1]/P[44]/text()[1]", "offset_end": "362", "title": "Вот моё выделение", "note": "<p>обожал ее раньше, когда она притворялась сплошным галдящим базаром – ему казалось, что на этом базаре он сможет купить себе любое будущее. Он приезжал тогда в Москву из своей Лобни электричкой – в университет, в клубы, на концерты – и каждый раз воображал себе себя москвичом. Надо было только доучиться, найти работу в центре и снять с друзьями квартиру.</p>" } ], "dropped_notes": ["35830123-26b8-4b07-8098-c18229e8026e", "85830123-26b8-4b07-8098-c18229e8028e"] } }