Public : [r_my_epub_notes_incremental] Получение пользователем своих свежих заметок/закладок на книгу в формате epub

Метод используется для получения списка закладок/заметок для книги.

См. также:

[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"]
  }
}