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