Внимание! Использование данного метода недоступно.
Функция возвращает список книг, участвующих в акции «Книга дня бесплатно». Только для пользователей с привязанной социальной сетью.
ID функции
r_daily_books
Кто может вызывать
Авторизованный пользователь с привязанной соцсетью
Авторизованное приложение
Принимаемые параметры
limit – ограничение на количество возвращаемых книг. Работает аналогично инструкции limit в MySQL и в запросе представлен одним числом либо массивом из двух чисел N,M. Если limit указан – возвращается M “вчерашних” книг, начиная с книги N (у первой книги номер 0). Если limit не задан – значение по умолчанию «0,20»;
atype – необязательный параметр; супертип для запроса книг определенных типов:
- 1 – электронные книги (ebook и pdf);
- 2 – аудио-книги;
anno – если параметр имеет значение «1», то в ответе к найденным книгам будут добавлены аннотации (см. annotation);
currency – валюта, в которой необходимо возвращать цены InApp'ов на книги. Если параметр не передан информация по InApp'ам (inapp_price, inapp_name) не возвращается. Допустимые значения:
- RUB – российские рубли (по умолчанию);
- USD – доллары США;
- EUR – евро;
- PLN – польские злотые;
Возвращаемые значения
arts* – идентично одноименному полю в ответе на запрос r_search_arts (за исключением отсутствующего здесь значения match_weight). Для каждого арта добавляются дополнительные соответствующие признаки:
- daily_book_date – дата участия книги в акции в формате с таймзоной для сегодняшней и “вчерашних” книг; для “вчерашних” книг единственный параметр;
- daily_book – параметр, указывающий на принадлежность книги к участию в акции сегодня или завтра. Возможные значения:
- today – сегодняшняя книга дня, передается только с daily_book_date;
- tomorrow – данная книга может стать завтрашней книгой дня; при этом значении параметра daily_book_date не выдается.
Если не было найдено ни одной книги в этом жанре, то массив arts будет пустым.
daily_subscr* – признак того, что юзер подписан на уведомления о рассылке по акции "Книга дня":
- 1 – пользователь подписан;
- 0 – пользователь не подписан.
Возможные ошибки
error_code | error_message | Описание |
|---|---|---|
101005 | Функция недоступна данному пользователю | В запросе вызвана функция, недоступная для текущей учетной записи пользователя (к профилю не привязана ни одна социальная сеть) |
Пример запроса на сервер
{
"app": "1",
"time": "2014-11-07T16:21:02+03:00",
"sha": "b79d8e9993d20da6abe78838d3c7fbf640a4c52956569bef3c685d3453316b5c",
"sid": "7bad5f2fb752ee957a4ab74aaac7711g",
"requests": [
{
"func": "r_daily_books",
"id": "daily_books",
"param": {
}
}
]
}
Пример ответа сервера
{
"success": true,
"time": "2014-11-07T16:21:02+03:00",
"daily_books" : {
"success" : true,
"arts_n" : "33",
"daily_subscr" : "1",
"arts" : [
{
"daily_book_date" : "2014-11-07T16:21:02+03:00",
"daily_book" : "today",
// "daily_book" : "tomorrow",
"id" : "171966",
"last_update" : "2014-11-07T16:21:02+03:00",
"last_release" : "2014-11-07T16:21:02+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"
}
},
{
"daily_book_date" : "2014-11-07T16:21:02+03:00",
"id" : "171967",
"last_update" : "2014-11-07T16:21:02+03:00",
"last_release" : "2014-11-07T16:21:02+03:00",
"lvl" : "5",
"type" : "0",
"drm" : "0",
"title" : "Евгений Онегин",
"subtitle" : "Второе издание",
...
},
{
"daily_book" : "tomorrow",
"id" : "171968",
"last_update" : "2014-11-07T16:21:02+03:00",
"last_release" : "2014-11-07T16:21:02+03:00",
"lvl" : "5",
"type" : "0",
"drm" : "0",
"title" : "Евгений Онегин",
"subtitle" : "Третье издание",
...
}
]
}
}