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