С помощью этого запроса можно получить информацию об одной или нескольких коллекциях книг.
ID функции
r_browse_collections
Кто может вызывать
Любой пользователь
Авторизованное приложение
Принимаемые параметры
id* – массив идентификаторов коллекций, информацию о которых необходимо получить.
top_n_arts – если в ответе для каждой коллекции необходимо вывести информацию о самых рейтинговых книгах из нее, то в этом параметре указывается необходимое количество книг (не более 10). Например, если значение «3», то в ответе у каждой коллеции в узле top_arts будет от 0 до 3-х книг.
descr – если параметр присутствует в запросе и имеет значение «1», то в ответе к найденным коллекциям будут добавлены описания (см. description_html).
Возвращаемые значения
collections* – массив, содержащий информацию о запрошенных коллекциях. Содержимое идентично описанному в r_search_collections (за отсутствием ненужного здесь параметра match_weight).
Если не было найдено ни одной коллекции с запрошенными ID, то массив collections будет пустым.
Возможные ошибки
error_code | error_message | Описание |
|---|---|---|
101075 | Недопустимое значение в топе по книгам | В параметре top_n_arts допустимы только целые положительные числа от 1 до 10. |
101081 | Некорректный флаг описания | В параметре descr указано значение, отличное от «1». |
101083 | Некорректный список коллекций | Параметр id не может содержать более чем 100 элементов. |
| 101077 | Отсутствует перечень коллекций | Параметр id в запросе не передан. |
Пример запроса на сервер
{
"app": "1",
"time": "2014-11-07T16:21:02+03:00",
"sha": "b79d8e9993d20da6abe78838d3c7fbf640a4c52956569bef3c685d3453316b5c",
"sid": "7bad5f2fb752ee957a4ab74aaac7711g",
"requests": [
{
"func": "r_browse_collections",
"id": "browse_collections",
"param": {
"id": ["81715"],
"top_n_arts": "3",
"descr": "1"
}
}
]
}
Пример ответа сервера
{
"success": true,
"time": "2014-11-07T16:21:02+03:00",
"browse_series" : {
"success" : true,
"collections" : [
{
"id": "81715",
"name": "Сколково. Хронотуризм",
"description_html": "<p>Ученые наукограда Сколково совершили революционное открытие. Прорыв, равного которому не было от сотворения мира! Отныне история – открытая книга. Людям стало подвластно само время. Открытие не стали прятать за заборами секретных лабораторий. Гостеприимно распахнула двери государственная компания «Сколково. Хронотуризм». Покупайте путевку в прошлое и в путь!</p>",
"arts_n": "32",
"reviews_n": "1",
"top_arts": [
{
"id": "8604574",
"name": "Сказки Пушкина",
"cover": "http://www.litres.ru/pub/c/cover/11399521.jpg",
"marks": "9.9"
},
{
...
}
],
},
{
...
}
]
}
}