ID функции

r_my_fb3_notes_incremental

Кто может вызывать

Авторизованный пользователь
Авторизованное приложение

Принимаемые параметры

Идентично r_my_fb3_notes, но добавляется параметр:
checkpoint – время, начиная с которого (не включительно) надо получить обновления; Используйте серверное время из ответа последнего запроса r_read_bookmarks при следующем запросе чтобы получать непрерывную ленту обновлений. Если не передано – возвращаются все закладки, независимо от времени последнего обновления.

Возвращаемые значения

Идентично r_my_fb3_notes, но добавляется массив:
dropped_notes – массив, содержащий список ID удаленных с момента checkpoint заметок/закладок данной книги. Присутствует, только если checkpoint был передан. Также следует иметь в виду, что информация об удалении заметок/закладок гарантированно хранится на сервере только сутки. Если ваш checkpoint отстал от текущего времени на 23 часа и более, следует получить ПОЛНЫЙ список заметок/закладок, инкрементальное обновление не гарантирует консистентность.
Если закладки/заметки для книги отсутствуют, то массив 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_fb3_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",
        "xpath_start": "/1/2/16.5"
      },
      {
        "id": "65830123-26b8-4b07-8098-c18229e5026f",
        "group": "1",
        "last_update": "2014-11-07T16:21:15+03:00",
        "xpath_start": "/1/2/15.5",
        "xpath_end": "/1/2/16.35",
        "title": "Вот я тут выделил че-то",
        	"note": "<p>Книга выдающегося советского ученого Л.&nbsp;С.&nbsp;Выготского «Психология искусства» вышла первым изданием в 1965&#160;г., вторым – в 1968&#160;г. и&nbsp;завоевала всеобщее признание. В ней автор резюмирует свои работы 1915–1922 годов и вместе с тем готовит те <strong>новые</strong> психологические идеи, которые составили главный вклад Выготского в науку. «Психология искусства» является одной из фундаментальных работ, характеризующих развитие советской теории и искусства.</p><p>Книга рассчитана на специалистов – эстетиков, психологов, искусствоведов, а также на широкий круг читателей.</p>"
      }
    ],
    "dropped_notes": ["35830123-26b8-4b07-8098-c18229e8026e",
                     "85830123-26b8-4b07-8098-c18229e8028e"]
  }
}