С помощью этого запроса можно получить расширенную информацию о книгах по их ID.
ID функции
r_browse_arts
Кто может вызывать
Любой пользователь.
Авторизованное приложение.
Принимаемые параметры
id – массив ID книг;
anno – если параметр имеет значение «1», то в ответе к найденным книгам будут добавлены аннотации (см. annotation);
currency – валюта, в которой необходимо возвращать цены InApp'ов на книги. Если параметр не передан информация по InApp'ам (inapp_price, inapp_name) не возвращается. Допустимые значения:
- RUB – российские рубли (по умолчанию);
- USD – доллары США;
- EUR – евро;
- PLN – польские злотые;
atype – супертип запроса (super_art_types) для запроса книг определенных типов. Если параметр не передан, в ответе будут выданы арты всех типов. Допустимые значения:
- 1 – электронные книги;
- 2 – аудиокниги.
Возвращаемые значения
arts* – массив, содержащий информацию о запрошенных книгах. Выдача идентична получаемой в r_search_arts (за отсутствием ненужного здесь параметра match_weight). Дополнительно в списке может присутствовать атрибуты:
- region_restriction – ограничение на показ/продажу книги в стране или регионе, где книга запрещена (определяется по GeoIP запросившего пользователя). Может принимать следующие значения:
- 1 – запрещена продажа книги. Карточка книги, в том числе её обложка, рецензии, цитаты и т. д. будут показаны пользователю, но будет отсутствовать возможность купить такую книгу. Возвращается в виде строки;
- 2 – запрещен показ книги. Книгу с таким ограничением пользователь не увидит, а так же она будут отсутствовать в выдаче при выполнении запроса поиска по книгам. Возвращается в виде строки.
- buttons- массив кнопок для монетизации подписных моделей передаваемый фронту для быстрого отображения, исключающего сложную логику на последнем, ссылка на проект: Балансировка офферов на карточке книги, ит.1; Абонементные книги в Андроиде
- type - тип кнопки, используемый фронтом для фиксации действий, обязательный атрибут
- name - то, что на ней написано на кнопке, основной текст, обязательный атрибут
- price - конечная стоимость покупки/продления передается в экшны и формы, отображается на кнопках, включает в себя скидки и бонусы
- class - класс покупки/продления абонемента/подписки передается в экшны и формы
- postfix - символ валюты (₽ для рублей), используется на кнопках вместе с ценами
- price_comment - комментарий к цене на кнопке первого уровня (перечеркнутая базовая стоимость), вместе со стоимостью и постфиксом формирует информацию на блоках кнопок второго уровня, расположен за стоимостью
- buttons - массив кнопок второго уровня, расположен в кнопке с типом OTHERS, только первый уровень
- type - тип кнопки, используемый фронтом для фиксации действий, обязательный атрибут
- name - то, что на ней написано на кнопке, основной текст, обязательный атрибут
- title - заголовок блока кнопок второго уровня (Купить, По подписке, По абонементу...), обязательный атрибут
- comment - описание на блоках кнопок второго уровня, обязательный атрибут
- ref_text - текст ссылки для комментария
- price - конечная стоимость покупки/продления передается в экшны и формы, отображается на блоках в ряде случаев, включает в себя скидки и бонусы
- base_price - базовая цена покупки, отображается на блоках подписных моделей перечеркнутой, над ценой
- class - класс покупки/продления абонемента/подписки передается в экшны и формы
- postfix - символ валюты (₽ для рублей), используется на блоках вместе с ценами и комментариями к цене
- price_comment - комментарий к цене, вместе со стоимостью и постфиксом формирует информацию на блоках над кнопкой
- discount - размер скидки отображаемый на блоках кнопок второго уровня
- cashback - сколько бонусных рублей будет получено при покупке по цене без учета бонусов программы лояльности
Типы кнопок(buttons.type) :
B_GET_BY_ABONEMENT - взять по абонементу (есть токен на книгу)
B_BUY_ABONEMENT - покупка абонементаB_PROLONG_ABONEMENT - продлить абонемент
B_GET_BY_LITRES_SUBSCRIPTION - взять по подписке (действующая подписка)B_BUY_LITRES_SUBSCRIPTION - доступно в подписке (Литрес)
B_PROLONG_LITRES_SUBSCRIPTION - продлить подписку (Литрес)
B_BUY_AND_READ_DEFAULT - купить и читать (atype 1)
B_BUY_AND_LISTEN_DEFAULT - купить и слушать (atype 2)Если не было найдено ни одной книги с указанными ID, то массив arts будет пустым.
Возможные ошибки
error_code | error_message | Описание |
|---|---|---|
101095 | Некорректный список книг | Параметр id не может содержать более чем 100 элементов, либо содержит некорректные данные |
Пример запроса на сервер
{
"app": "389526725",
"time": "2018-07-20T11:00:23+00:00",
"sha": "b79d8e9993d20da6abe78838d3c7fbf640a4c52956569bef3c685d3453316b5c",
"sid": "7bad5f2fb752ee957a4ab74aaac7711g",
"requests": [{
"func": "r_browse_arts",
"id": "browse_arts",
"param": {
"id": ["175916"],
"anno": "1",
"atype": "1"
}
}]
}
Пример ответа сервера
{
"time" : "2018-07-20T14:01:03+03:00",
"success" : true,
"browse_arts" : {
"arts" : [
{
"last_update" : "2017-10-26 12:07:47",
"can_preorder" : "0",
"buttons" : [
{
"name" : "ВЗЯТЬ ПО АБОНЕМЕНТУ",
"type" : "B_GET_BY_ABONEMENT"
},
{
"name" : "ЧИТАТЬ ПО ПОДПИСКЕ",
"type" : "B_GET_BY_LITRES_SUBSCRIPTION"
},
{
"buttons" : [
{
"cashback" : 8.53,
"comment" : "Книга останется у вас навсегда",
"discount" : "30%",
"name" : "ПЕРЕЙТИ К ОПЛАТЕ",
"postfix" : "₽",
"price" : "85.30",
"price_comment" : "149.00",
"title" : "Купить",
"type" : "B_BUY_AND_READ_DEFAULT"
},
{
"comment" : "Вы можете выбрать одну книгу из каталога без дополнительной оплаты",
"name" : "ЗАБРАТЬ КНИГУ",
"price_comment" : "Бесплатно",
"title" : "По абонементу",
"type" : "B_GET_BY_ABONEMENT"
},
{
"comment" : "Вы можете читать эту книгу на сайте или в приложении по подписке Литрес",
"name" : "ЧИТАТЬ",
"title" : "По подписке",
"type" : "B_GET_BY_LITRES_SUBSCRIPTION"
}
],
"name" : "Все способы оплаты",
"type" : "OTHERS"
}
],
"mark_4" : "495",
"year_written" : "2009",
"last_release" : "2017-10-26 12:07:47",
"available_date" : "2017-01-01 18:26:29",
"year" : "2009",
"biblio_queue_size" : "0",
"persons" : [
{
"lvl" : "5",
"id" : "45097",
"type" : "0",
"img" : "http://www.litres.ru/static/authors/100/00/04/50/00045097.jpg",
"full_name" : "Вадим Панов"
}
],
"final_price" : 0,
"reviews_n" : "159",
"publisher" : "Эксмо,Панов Вадим",
"annotation" : "<p>Он существует с незапамятных времен, а может, и дольше. О нем знает вся Вселенная, но видели его единицы. Он редко включается, но с его работой всякий раз связана судьба человеческой души – «искры». Никто не знает, почему он называется Ручным Приводом. Но именно здесь, посреди ничего не подозревающей Москвы, определяется ход вечной борьбы двух Царств за «искры».</p><p>Только отсюда можно выйти на связь с тем, кто порождает человеческие души. И именно сюда Царства присылают своих комендантов, попеременно управляющих Ручным Приводом. Но, даже получив Силу и Вечность, человек не способен отречься от своего прошлого, а потому и на Земле, и во Вселенной кипят страсти, совершаются благородные и подлые деяния – и за всем этим следит Ручной Привод. А за ним присматривают коменданты, в обязанности которых входит еще и наказание тех, кто возомнил себя равным Богу…</p>",
"avail_by_subscr" : "0",
"biblio_fund" : "0",
"mark_1" : "139",
"base_price" : 0,
"type" : "0",
"id" : "175916",
"mark_3" : "235",
"title" : "Ручной Привод",
"isbn" : "978-5-425-08429-3",
"chars" : "658608",
"free" : "1",
"available" : "1",
"first_time_sale" : "2008-12-17 13:59:38",
"cover_w" : "570",
"lvl" : "5",
"freebie" : "1",
"subtitle" : "",
"drm" : "0",
"mark_5" : "1708",
"images" : "0",
"biblio_selfservice" : "instant",
"sequences" : [
{
"reviews_n" : "4",
"name" : "La Mystique De Moscou",
"sequence_number" : "3",
"id" : "30",
"arts_n" : "3"
}
],
"genres" : [
{
"id" : "56785",
"is_tag" : "1",
"name" : "городские истории"
},
{
"id" : "5225",
"name" : "городское фэнтези"
},
{
"id" : "5223",
"name" : "мистика"
},
{
"name" : "мистическая проза",
"id" : "65845",
"is_tag" : "1"
},
{
"id" : "5210",
"name" : "современная русская литература"
}
],
"lang" : "rus",
"minage" : "16",
"cover" : "http://www.litres.ru/pub/b/cover/31436214.jpg",
"cover_h" : "921",
"mark_2" : "95",
"biblio_busy" : "0"
}
],
"success" : true
}
}
Пример ответа Подкаст
Result:
{
"browse_arts" : {
"arts" : [
{
"available" : "1",
"available_date" : "2017-09-13 10:56:26",
"base_price" : "194.00",
"can_preorder" : "0",
"chars" : "42123",
"cover" : "http://www.litres.ru/static/bookimages/30/07/18/30071812.bin.dir/30071812.cover.jpg",
"cover_h" : "570",
"cover_w" : "570",
"drm" : "0",
"exp_update_freq" : "1",
"final_price" : "194.00",
"first_time_sale" : "2017-09-13 10:56:26",
"genres" : [
{
"id" : "9755",
"is_tag" : "1",
"name" : "женские детективы"
},
{
"id" : "42635",
"is_tag" : "1",
"name" : "загадочные события"
},
{
"id" : "5258",
"name" : "исторические детективы"
},
{
"id" : "5095",
"name" : "исторические приключения"
},
{
"id" : "196230",
"is_tag" : "1",
"name" : "опасные приключения"
},
{
"id" : "5086",
"name" : "остросюжетные любовные романы"
},
{
"id" : "22385",
"is_tag" : "1",
"name" : "расследование преступлений"
},
{
"id" : "32805",
"is_tag" : "1",
"name" : "ретродетективы"
},
{
"id" : "9545",
"is_tag" : "1",
"name" : "Русско-турецкая война"
}
],
"id" : "25718062",
"isbn" : "978-5-04-078679-4",
"lang" : "rus",
"last_release" : "2017-09-12 20:16:20",
"last_update" : "2017-09-13 10:56:26",
"lvl" : "4",
"mark_1" : "0",
"mark_2" : "0",
"mark_3" : "0",
"mark_4" : "0",
"mark_5" : "1",
"minage" : "16",
"persons" : [
{
"full_name" : "Марта Таро",
"id" : "10432871",
"lvl" : "2",
"person_in_rodit" : "Марты Таро",
"type" : "0"
},
{
"full_name" : "Обоянка Вероника",
"id" : "10038653",
"lvl" : "1",
"person_in_rodit" : "Обоянки Вероники",
"type" : "6"
}
],
"publisher" : "Автор",
"reviews_n" : "0",
"sequences" : [
{
"arts_n" : "11",
"id" : "457642",
"name" : "Галантный детектив",
"reviews_n" : "0"
}
],
"subscr_podcast" : "1",
"subtitle" : "",
"title" : "Охота на Менелая",
"type" : "22",
"year" : "2016",
"year_written" : "2016"
}
],
"success" : true
},
"success" : true,
"time" : "2020-11-03T12:49:19+03:00"
}
Пример ответа Выпуск
Result:
{
"browse_arts" : {
"arts" : [
{
"available" : "1",
"available_date" : "2017-09-08 23:45:00",
"base_price" : "126.00",
"can_preorder" : "0",
"chars" : "43232",
"cover" : "http://www.litres.ru/static/bookimages/29/77/73/29777334.bin.dir/29777334.cover.jpg",
"cover_h" : "897",
"cover_w" : "570",
"drm" : "0",
"exp_update_freq" : "1",
"final_price" : "113.40",
"first_time_sale" : "2017-09-08 23:46:03",
"genres" : [
{
"id" : "9755",
"is_tag" : "1",
"name" : "женские детективы"
},
{
"id" : "5262",
"name" : "иронические детективы"
},
{
"id" : "13215",
"is_tag" : "1",
"name" : "убийства"
},
{
"id" : "101759",
"is_tag" : "1",
"name" : "частное расследование"
}
],
"id" : "25445470",
"isbn" : "978-5-04-078380-9",
"lang" : "rus",
"last_release" : "2017-08-31 16:05:08",
"last_update" : "2017-09-08 23:51:00",
"ll_avg_marks" : "3.6405",
"ll_marks_n" : "0",
"lvl" : "3",
"mark_1" : "0",
"mark_2" : "0",
"mark_3" : "0",
"mark_4" : "0",
"mark_5" : "0",
"minage" : "16",
"parent_podcast_id" : "25718062",
"parent_podcast_name" : "Охота на Менелая",
"persons" : [
{
"full_name" : "Дарья Донцова",
"id" : "44336",
"img" : "http://www.litres.ru/static/authors/100/00/04/43/00044336.jpg",
"lvl" : "4",
"person_in_rodit" : "Дарьи Донцовой",
"type" : "0"
},
{
"full_name" : "Маргарита Иванова",
"id" : "63984",
"lvl" : "1",
"person_in_rodit" : "Маргариты Ивановой",
"type" : "6"
}
],
"publisher" : "Эксмо,Логосвос",
"reviews_n" : "0",
"sequences" : [
{
"arts_n" : "59",
"id" : "804",
"name" : "Евлампия Романова. Следствие ведет дилетант",
"reviews_n" : "0",
"sequence_number" : "2"
}
],
"subscr_podcast" : "1",
"subtitle" : "",
"title" : "Покер с акулой",
"type" : "23",
"year" : "2020",
"year_written" : "2000"
}
],
"success" : true
},
"success" : true,
"time" : "2020-11-03T12:51:23+03:00"
}