Created by Мария Федорова, last modified by Ирина Лемешева on Nov 06, 2019

Внимание! Использование данного метода недоступно.

Функция возвращает список книг, участвующих в акции «Книга дня бесплатно». Только для пользователей с привязанной социальной сетью.

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" : "Третье издание",
           ...
       }
    ]
  }
}