ID функции

r_genre_arts_pop

Кто может вызывать

Любой пользователь.
Авторизованное приложение.

Принимаемые параметры

genre* – ID жанра. Может быть как ID корневого жанра/контейнера, так и оконечного. Подробней о том, как получить перечень жанров см. запрос r_genres_list;
limit, anno, currency – идентично одноименным параметрам из запроса r_search_arts;
atype – супертип запроса (super_art_types) для запроса книг определенных типов. Если параметр не передан, в ответе будут выданы арты всех типов. Допустимые значения:

1 – электронные книги;
2 – аудиокниги.

Возвращаемые значения

arts* – идентично одноименному полю в ответе на запрос r_search_arts (за исключением отсутствующего здесь значения match_weight). Дополнительно в списке может присутствовать атрибут region_restriction – ограничение на показ/продажу книги в стране или регионе, где книга запрещена (определяется по GeoIP запросившего пользователя). Может принимать следующие значения:

1 – запрещена продажа книги. Карточка книги, в том числе её обложка, рецензии, цитаты и т. д. будут показаны пользователю, но будет отсутствовать возможность купить такую книгу. Возвращается в виде строки;
2 – запрещен показ книги. Книгу с таким ограничением пользователь не увидит, а так же она будут отсутствовать в выдаче при выполнении запроса поиска по книгам. Возвращается в виде строки.

Книги в массиве будут отсотртированы по популярности (первых 240 книг), далее по ID.
Если не было найдено ни одной книги в этом жанре, то массив arts будет пустым.

Возможные ошибки

error_code	error_message	Описание
101160	Несуществующий жанр	Переданный в genre ID жанра отсутствует в каталоге ЛитРес
101071	Недопустимое значение в лимите возвращаемых элементов	В параметре limit должен передаваться массив из двух целых не отрицательных чисел либо одно число
101072	Некорректный флаг аннотации	В параметре anno указано значение, отличное от «1»
101073	Указана некорректная валюта	В параметре currency допустимы только следующие валюты: RUB – российские рубли; USD – доллары США; EUR – евро; PLN – польские злотые.

Пример запроса на сервер

{
   "app": "1",
   "time": "2014-11-07T16:21:02+03:00",
   "sha": "b79d8e9993d20da6abe78838d3c7fbf640a4c52956569bef3c685d3453316b5c",
   "sid": "7bad5f2fb752ee957a4ab74aaac7711g",
   "requests": [
           {
                 "func": "r_genre_arts_pop",
                 "id": "genre_arts",
                 "param": {
                   "limit": ["0","5"],
                   "anno": "1",         
                   "currency": "RUB",
                   "genre": "45142"
                 }
           }
   ]
}

Пример ответа сервера

{
   "success": true,
   "time": "2014-11-07T16:21:02+03:00",
   "genre_arts" : {
      "success" : true,
      "arts_n" : "7",
      "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"
         }
       },
       {
         ...
       },
       {
         ...
       }
    ]
  }
}