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