Метод используется для получения списка закладок/заметок для книги.
См. также:
[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"]
}
}