С помощью этого запроса можно получить информацию об одной или нескольких коллекциях книг.
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" }, { ... } ], }, { ... } ] } }