Метод позволяет получить список просмотренных книг пользователя в сортировке от самых новых к самым старым просмотрам.
ID функции
r_viewed_arts
Кто может вызывать
Авторизованный пользователь.
Авторизованное приложение.
Принимаемые параметры
limit, anno, currency – идентично одноименным параметрам из запроса r_search_arts;
atype – супертип запроса (super_art_types) для запроса книг определенных типов. Если параметр не передан, в ответе будут выданы арты всех типов. Допустимые значения:
- 1 – электронные книги;
- 2 – аудиокниги.
Возвращаемые значения
arts* – идентично одноименному массиву в ответе на запрос r_search_arts (за исключением отсутствующего здесь значения match_weight). Дополнительно в списке может присутствовать атрибут region_restriction – ограничение на показ/продажу книги в стране или регионе, где книга запрещена (определяется по GeoIP запросившего пользователя). Может принимать следующие значения:
- 1 – запрещена продажа книги. Карточка книги, в том числе её обложка, рецензии, цитаты и т. д. будут показаны пользователю, но будет отсутствовать возможность купить такую книгу. Возвращается в виде строки;
- 2 – запрещен показ книги. Книгу с таким ограничением пользователь не увидит, а так же она будут отсутствовать в выдаче при выполнении запроса поиска по книгам. Возвращается в виде строки.
Книги в массиве arts будут отсортированы по времени просмотра книг, первыми идут самые свежие.
Если у пользователя нет просмотренных книг, то массив arts будет пустым.
Возможные ошибки
error_code | error_message | Описание |
|---|---|---|
101071 | Недопустимое значение в лимите возвращаемых элементов | В параметре limit должен передаваться массив из двух целых не отрицательных чисел либо одно число |
101072 | Некорректный флаг аннотации | В параметре anno указано значение, отличное от «1» |
101073 | Указана некорректная валюта | В параметре currency допустимы только следующие валюты:
|
Пример запроса на сервер
{
"app": "1",
"time": "2014-11-07T16:21:02+03:00",
"sha": "b79d8e9993d20da6abe78838d3c7fbf640a4c52956569bef3c685d3453316b5c",
"sid": "7bad5f2fb752ee957a4ab74aaac7711g",
"requests": [
{
"func": "r_viewed_arts",
"id": "r_viewed_arts",
"param": {
"limit": ["0","5"],
"anno": "0",
"currency": "RUB"
}
}
]
}
Пример ответа сервера
{
"success": true,
"time": "2014-11-07T16:21:02+03:00",
"r_viewed_arts" : {
"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"
},
"purchase" : {
"base_price" : "0",
"final_price" : "0",
"inapp_price " : "29.95",
"inapp_name" : "ru.litres.app.refill_99.XXL",
"free" : "1",
"in_gifts" : "1",
"in_basket" : "466557",
"my" : "1",
"biblio_selfservice" : "received",
"valid_till" : "2015-12-01T12:00:00+03:00"
},
"social" : {
"reviews_n" : "15",
"mark_1" : "2",
"mark_2" : "12",
"mark_3" : "10",
"mark_4" : "33",
"mark_5" : "23",
"user_mark" : "5"
}
},
{
...
},
{
...
}
]
}
}