Метод предназначен для отображения адекватного порядка в списках книг, единого на всех платформах.
ID функции
r_folder_arts
Кто может вызывать
Авторизованный пользователь.
Авторизованное приложение.
Принимаемые параметры
folder_id* – ID пользовательской полки (целое число 64 бита);
limit, anno, currency – идентично одноименным параметрам из запроса r_search_arts.
Возвращаемые значения
arts* – идентично одноименному массиву в ответе на запрос r_search_arts (за исключением отсутствующего здесь значения match_weight).
Дополнительно в массиве arts возвращаются следующие значения:
- in_folders* – информация о всех полках, на которые была помещена книга (см. w_put_book_to_folder), в том числе той, ID которой передали в запросе. Содержит следующие элементы:
- folderds – идентификатор полки, на которую была помещена книга;
- is_public – признак публичности полки. Если вернулось значение 1, значит полка является публичной, иначе – 0.
- region_restriction – ограничение на показ/продажу книги в стране или регионе, где книга запрещена (определяется по GeoIP запросившего пользователя). Может отсутствовать в ответе. Если есть, то может принимать следующие значения:
- 1 – запрещена продажа книги. Карточка книги, в том числе её обложка, рецензии, цитаты и т. д. будут показаны пользователю, но будет отсутствовать возможность купить такую книгу. Возвращается в виде строки;
- 2 – запрещен показ книги. Книгу с таким ограничением пользователь не увидит, а так же она будут отсутствовать в выдаче при выполнении запроса поиска по книгам. Возвращается в виде строки.
Сортировка книг в массиве arts дефолтная (LIFO). Для полки «Прочитанные книги» (folder_id=1) сначала будут показаны последние добавленные на эту полку книги.
Если у пользователя нет книг в указанном списке, то массив arts будет пустым.
Возможные ошибки
error_code | error_message | Описание |
|---|---|---|
101118 | Wrong folder number | Нечисловое значение в ID полки |
101119 | The folder %N% can not be found, or belongs to another user | Полка не существует или не принадлежит текущему пользователю |
Пример запроса на сервер
{
"sid" : "5ifoea1f825sae47f86ka920e371e31j",
"app" : 1,
"time" : "2020-04-07T13:45:37+03:00",
"sha" : "6da44646fb53f96b2f61c8ba0a13fb42825299fd591925a1d2f0564d4f98f405",
"requests" : [
{
"func" : "r_folder_arts",
"param" : {
"folder_id" : "525531",
"anno" : 1,
"limit" : [
0,
1
],
"currency" : "RUB"
},
"id" : "folder_arts"
}
]
}
Пример ответа сервера
{
"folder_arts": {
"arts": [
{
"annotation": "<p><i>«Испытаний на протяжении этого учебного года будет три, и они позволят проверить способности чемпионов с разных сторон… колдовское мастерство – доблесть – способность к дедукции – и, разумеется, умение достойно встретить опасность».</i></p><p>В «Хогварце» проводится Тремудрый Турнир. К участию допускаются только волшебники, достигшие семнадцатилетия, но это не мешает Гарри мечтать о победе. А потом, во время Хэллоуина, когда Кубок Огня делает выбор, Гарри с огромным удивлением узнает, что ему тоже предстоит стать участником состязания. Он столкнется со смертельно опасными заданиями, драконами и темными волшебниками, но с помощью лучших друзей, Рона и Гермионы, возможно, ему удастся преодолеть все препятствия – и остаться в живых!</p>",
"available": 0,
"available_date": "2017-05-25 15:03:00",
"base_price": "299.00",
"biblio_queue_size": 0,
"can_preorder": 0,
"chars": 1037543,
"cover": "http://www.litres.ru/static/bookimages/28/15/12/28151229.bin.dir/28151229.cover.jpg",
"cover_h": 858,
"cover_w": 570,
"drm": 0,
"exp_update_freq": 1,
"final_price": "299.00",
"first_time_sale": "2017-05-25 15:04:44",
"genres": [
{
"id": 92825,
"is_tag": 1,
"name": "волшебные существа"
},
{
"id": 5218,
"name": "зарубежное фэнтези"
},
{
"id": 102726,
"is_tag": 1,
"name": "игры на выживание"
},
{
"id": 17555,
"is_tag": 1,
"name": "квест"
},
{
"id": 5226,
"name": "книги про волшебников"
},
{
"id": 11605,
"is_tag": 1,
"name": "магическая школа"
},
{
"id": 42275,
"is_tag": 1,
"name": "магические артефакты"
},
{
"id": 57845,
"is_tag": 1,
"name": "пророчества и предсказания"
},
{
"id": 12585,
"is_tag": 1,
"name": "смертельная ловушка"
},
{
"id": 13005,
"is_tag": 1,
"name": "смертельная опасность"
},
{
"id": 17195,
"is_tag": 1,
"name": "тайны прошлого"
},
{
"id": 65465,
"is_tag": 1,
"name": "темная магия"
},
{
"id": 8125,
"is_tag": 1,
"name": "экранизации"
}
],
"id": "126251",
"images": 3,
"in_folders": [
{
"folderds": 525531,
"is_public": 1
},
{
"folderds": 525584,
"is_public": 0
}
],
"isbn": "978-1-78110-271-8",
"lang": "rus",
"last_release": "2017-05-26 14:00:23",
"last_update": "2017-07-09 02:45:37",
"ll_avg_marks": 4.6841,
"ll_marks_n": 0,
"lvl": 4,
"mark_1": 4,
"mark_2": 1,
"mark_3": 3,
"mark_4": 6,
"mark_5": 21,
"minage": 6,
"persons": [
{
"full_name": "Дж. К. Роулинг",
"id": 54058,
"img": "http://www.litres.ru/static/authors/100/00/05/40/00054058.jpg",
"lvl": 4,
"type": 0
},
{
"full_name": "Мария Спивак",
"id": 46012,
"lvl": 1,
"type": 1
}
],
"publisher": "Pottermore limited",
"region_restriction": "2",
"reviews_n": 0,
"sequences": [
{
"arts_n": 8,
"id": 526,
"name": "Гарри Поттер",
"reviews_n": 0,
"sequence_number": 4
}
],
"subtitle": "",
"title": "Гарри Поттер и Кубок огня",
"type": 0,
"year": 2000,
"year_written": "2000"
}
],
"success": true
},
"success": true,
"time": "2020-04-10T15:11:34+03:00"
}