Метод позволяет получить список «моих книг», обновленных со времени выполнения последнего получения списка «моих книг».
Запрос на получение файла книги описан в r_my_arts_all.

ID функции

r_my_arts_incremental

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

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

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

checkpoint* – время, начиная с которого (не включительно) надо получить обновления. Используйте серверное время из ответа последнего запроса r_my_arts_incremental при следующем запросе, чтобы получать непрерывную ленту обновлений;
anno – если в этом параметре передать значение «1», то в ответе к найденным книгам будут добавлены аннотации (см. annotation).

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

arts* – идентично одноименному полю в ответе на запрос r_my_arts_allДополнительно в списке может присутствовать атрибут region_restriction – ограничение на показ/продажу книги в стране или регионе, где книга запрещена (определяется по GeoIP запросившего пользователя). Может принимать следующие значения:

  • 1 – запрещена продажа книги. Карточка книги, в том числе её обложка, рецензии, цитаты и т. д. будут показаны пользователю, но будет отсутствовать возможность купить такую книгу. Возвращается в виде строки;
  • 2 – запрещен показ книги. Книгу с таким ограничением пользователь не увидит, а так же она будут отсутствовать в выдаче при выполнении запроса поиска по книгам. Возвращается в виде строки.

Если у пользователя нет обновленных записей (или вовсе нет ни одной своей книги), то массив arts будет пустым.

Возможные ошибки

error_code

error_message

Описание

101072

Некорректный флаг аннотации

В параметре anno указано значение, отличное от «1»

101093

Некорректный чекпойнт

В параметре checkpoint передано некорректное время (неверный формат, время в будущем)

Пример запроса на сервер

{
   "app": "1",
   "time": "2014-11-07T16:21:02+03:00",
   "sha": "b79d8e9993d20da6abe78838d3c7fbf640a4c52956569bef3c685d3453316b5c",
   "sid": "7bad5f2fb752ee957a4ab74aaac7711g",
   "requests": [
           {
                 "func": "r_my_arts_incremental",
                 "id": "my_arts_incremental",
                 "param": {
                 		"checkpoint": "2015-11-07T16:21:02+03:00",
                 		"anno": "1"
                 }
           }
   ]
}

Пример ответа сервера

{
   "success": true,
   "time": "2014-11-07T16:21:02+03:00",
   "my_arts_all" : {
      "success" : true,
      "arts" : [
       {
         "catalogue" : 
           "id" : "171966",
           "last_update" : "2014-02-01T06:27:05+03:00",
           "last_release" : "2014-02-01T06:27:05+03:00",
           "lvl" : "5",
           "type" : "0",
           "drm" : "0",
           "title" : "Евгений Онегин",
           "subtitle" : "Второе издание",
           "lang" : "rus",
           "chars" : "201276",
           "sequences" : [
             {
               "id" : "185259",
               "name" : "Список школьной литературы 9 класс",
               "sequence_number" : "21",
               "reviews_n " : "1",
               "arts_n" : "31",
             },
             {
                ...
             },
           ],{
           "persons" : [
               {
                 "id" : "45142",
                 "full_name" : "Александр Сергеевич Пушкин",
                 "img" : "http://www.litres.ru/static/authors/100/45142.jpg",
                 "type" : "1",
               },
               {
                 ...
               }
           ],
           "genres" : [
             {
               "id" : "193",
               "name" : "Поэзия",
               "is_tag" : "1"
             },
             {
                ...
             },
           ],
           "cover" : "/pub/c/cover/08787189.jpg",
           "cover_h" : "798",
           "cover_w" : "570",
           "images" : "3",
           "annotation" : "<p>В книгу вошел роман в стихах А.С.Пушкина (1799–1837) «Евгений Онегин», обязательный для чтения и изучения в средней общеобразовательной школе.</p>
<p>Роман в стихах «Евгений Онегин» стал центральным событием в литературной жизни пушкинской поры. И с тех пор шедевр А.С.Пушкина не утратил своей популярности, по-прежнему любим и почитаем миллионами читателей.</p>",
           "minage" : "0"
         },
         "social" : {
           "reviews_n" : "15",
           "mark_1" : "2",
           "mark_2" : "12",
           "mark_3" : "10",
           "mark_4" : "33",
           "mark_5" : "23",
           "user_mark" : "5"
         }
       },
       {
         ...
       },
       {
         ...
       }
    ]
  }
}