Функция предназначена для получения списка опорных и похожих им книг. Предав в запросе параметры pure или tail, вы получите списки либо только опорных, либо только похожих книг соответственно.
В похожих книгах выдаются книги только на том же языке, что и опорная книга.
ID функции
r_homepage_arts
Кто может вызывать
Любой пользователь.
Авторизованное приложение.
Принимаемые параметры
limit – число блоков с опорными книгами, которые следует вернуть. По умолчанию принимает значение [0, 4] – четыре блока;
currency – идентично одноименному параметру из запроса r_search_arts;
anno – идентично одноименному параметру из запроса r_search_arts;
atype – параметр, определяющий тип книг, которые нужно вернуть. Если параметр не передан, в ответе будут выданы книги всех типов. Допустимые значения:
- 1 – электронные книги;
- 2 – аудиокниги;
viewed_arts – просмотры книг для незарегистрированного пользователя. Для зарегистрированного пользователя необходимо регистрировать просмотры через w_art_view_register. Перечень книг, которые просматривал пользователь, передаётся в виде массива с ID книг. Этот параметр используется при подборе рекомендаций анонимному пользователю. Массив не должен включать более 20 книг;
pure – необязательный параметр для запроса ТОЛЬКО опорных книг. Может принимать значения true/false. Если отсутствует, то по умолчанию передается значение false;
tail – необязательный параметр. Если передан этот параметр, то в ответе будут возвращены значения ТОЛЬКО наиболее похожих книг (по одной из массива x3best для каждой опорной). Может принимать значения true/false. Если отсутствует, то по умолчанию передается значение false.
Возвращаемые значения
basic_arts* – массив опорных книг. К каждой книге прилагается, помимо стандартного содержимого массива arts из r_search_arts (за исключением отсутствующего здесь значения match_weight) вложенные блоки книг, содержащие подобранные по определенному признаку похожие книги. Если не переданы параметры pure=true или tail=true, то массив будет содержать так же следующие элементы:
- x3best – три наиболее релевантных похожих книги. Возвращается в виде массива и содержит следующие атрибуты:
- reason – тип связи. Может принимать значения 'tag', 'seq', 'genre', 'person';
- reason_id – ID связанной сущности, число. Для reason: 'tag' 6555 будет означать «тег с ID 6555»;
- s_reason_name – заголовок признака «схожести». Например, тег 6555 это «историческое расследование»;
- art* – идентично одноименному массиву в ответе на запрос r_search_arts (за исключением отсутствующего здесь значения match_weight);
- x2good – две чуть менее похожие книги, содержимое аналогично x3best;
- x2avg – две средне похожие книги, содержимое аналогично x3best;
- x5pure – пять слабо похожих книг, содержимое аналогично x3best;
- x3pure – три слабо похожих книги, содержимое аналогично x3best.
tail_arts – массив похожих книг, по одной из наиболее релевантных из массива x3best для каждой из опорных книг. К каждой книге прилагается стандартное содержимое массива arts из r_search_arts (за исключением отсутствующего здесь значения match_weight). Массив будет отсутствовать, если в запросе передано tail=false.
Возможные ошибки
error_code | error_message | Описание |
|---|---|---|
| 101019 | Don't allow pure=true and tail=true simultaneously | Не допускается одновременная передача параметров pure = true и tail = true |
101071 | Недопустимое значение в лимите возвращаемых элементов | В параметре limit должен передаваться массив из двух целых не отрицательных чисел либо одно число |
101073 | Указана некорректная валюта | В параметре currency допустимы только следующие валюты:
|
| 101083 | Некорректное значение параметра type | В параметре type допустимы только целые положительные числа |
101113 | Некорректное значение параметра viewed_arts | В параметре viewed_arts передано более 20 записей, либо значение не является массивом и/или содержит не числовые значения |
Пример запроса на сервер
{
"sha" : "",
"app" : 1,
"requests" : [
{
"id" : "homepage_arts",
"func" : "r_homepage_arts",
"param" : {
"anno" : 1,
"currency" : "USD",
"atype" : 2,
"limit" : [
1,
1
]
}
}
],
"sid" : "",
"time" : "2019-11-27T13:27:27+03:00"
}
Пример ответа сервера
{
"homepage_arts" : {
"basic_arts" : {
"art" : [
{
"annotation" : "<p>Только Дэн Кеннеди мог осмелиться написать такое руководство по безжалостному менеджменту – без всякого рассусоливания и высокоученых теорий, только железные рецепты, проверенные на деле. Теперь, когда у вас есть эта аудиокнига, уму непостижимо, как вы могли до сих пор без нее обходиться. Она облекает вас правом вернуть себе власть над своим бизнесом, задавать правила, ставить во главу угла прибыль и добиваться настоящих результатов от тех, кто на вас работает.</p><p>Каждый, кто вооружится установками знаменитого бизнес-гуру и последовательно применит в бизнесе – и в жизни! – озвученные методы и техники, очень скоро увидит перемены к лучшему.</p>
"atype" : 2,
"available" : 1,
"available_date" : "2013-06-19 04:29:05",
"base_price" : "5.43",
"can_preorder" : 0,
"chars" : 30199,
"cover" : "http://www.litres.ru/static/bookimages/07/99/50/07995006.bin.dir/07995006.cover.jpg",
"cover_h" : 746,
"cover_w" : 570,
"drm" : 0,
"exp_update_freq" : 1,
"final_price" : "5.43",
"first_time_sale" : "2013-06-18 12:31:47",
"genres" : [
{
"id" : 5061,
"name" : "зарубежная деловая литература"
},
{
"id" : 6462,
"name" : "менеджмент и кадры"
},
{
"id" : 92285,
"is_tag" : 1,
"name" : "организация рабочего процесса"
},
{
"id" : 7515,
"is_tag" : 1,
"name" : "руководителям организаций и предприятий"
},
{
"id" : 32485,
"is_tag" : 1,
"name" : "советы профессионалов"
},
{
"id" : 92855,
"is_tag" : 1,
"name" : "увеличение прибыли"
},
{
"id" : 5382,
"name" : "управление бизнесом"
},
{
"id" : 6583,
"name" : "управление персоналом"
},
{
"id" : 58595,
"is_tag" : 1,
"name" : "эффективное руководство"
}
],
"id" : "5825028",
"inapp_name" : "ru.litres.app.refill_999.XXL",
"inapp_price" : "9.99",
"isbn" : "978-5-457-58508-9",
"lang" : "rus",
"last_update" : "2017-08-03 17:52:11",
"ll_avg_marks" : 4.1862,
"ll_marks_n" : 0,
"lvl" : 3,
"mark_1" : 8,
"mark_2" : 7,
"mark_3" : 10,
"mark_4" : 11,
"mark_5" : 82,
"minage" : 16,
"persons" : [
{
"full_name" : "Дэн Кеннеди",
"id" : 3188675,
"img" : "http://www.litres.ru/static/authors/100/03/18/86/03188675.jpg",
"lvl" : 3,
"type" : 0
},
{
"full_name" : "Дмитрий Кувшинчиков",
"id" : 3380084,
"lvl" : 1,
"type" : 6
}
],
"price" : "349.00",
"publisher" : "Альпина Диджитал",
"reviews_n" : 0,
"subtitle" : "",
"title" : "Жесткий менеджмент. Заставьте работать людей на результат",
"type" : 1,
"x2avg" : {
"art" : [
{...
}
],
"reason" : "genre",
"reason_id" : 5382,
"s_reason_name" : "Управление, подбор персонала"
},
"x2good" : {
"art" : [
{...
}
],
"reason" : "tag",
"reason_id" : "32485",
"s_reason_name" : "советы профессионалов"
},
"x3best" : {
"art" : [
{...
}
],
"reason" : "tag",
"reason_id" : "7515",
"s_reason_name" : "руководителям организаций и предприятий"
},
"x3pure" : {
"art" : [
{...
}
],
"reason" : "genre",
"reason_id" : 5382,
"s_reason_name" : "Управление, подбор персонала"
},
"x5pure" : {
"art" : [
{...
}
],
"reason" : "genre",
"reason_id" : 5061,
"s_reason_name" : "Зарубежная деловая литература"
},
"year" : 2013,
"year_written" : "2008"
],
},
"success" : true
},
"success" : true,
"time" : "2019-11-27T13:27:27+03:00"
}
Пример ответа сервера с ошибкой
{
"homepage_arts" : {
"error_code" : 101085,
"error_message" : "invalid limit param (try [0,4])",
"success" : false
},
"success" : true,
"time" : "2019-11-19T13:15:55+03:00"
}