Метод позволяет получить список «моих книг», обновленных со времени выполнения последнего получения списка «моих книг».
Запрос на получение файла книги описан в 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"
}
},
{
...
},
{
...
}
]
}
}