С помощью данного запроса можно получить все активные истории (stories) по каналам, на которые подписан пользователь.
ID функции
r_my_stories
Кто может вызывать
Любой пользователь.
Авторизованное приложение.
Принимаемые параметры
Отсутствуют.
Возвращаемые значения
channels – массив объектов, содержащий каналы, на которые подписан пользователь. Если в момент запроса канал не содержит ни одной активной истории, то такой канал не будет передан. Каждый канал содержит вложенный массив объектов, с информацией по активным историям данного канала:
- id – ID канала;
- title – название канала;
- preview_url – ссылка на изображение канала в формате 240x240;
- stories – массив объектов с информацией по активным историям данного канала. Содержит следующие элементы:
- id – ID истории;
- name – имя истории;
- title – заголовок истории;
- text – текст в истории;
type – тип превью. Может принимать значения:
img – истории с изображением;
- video – истории с видео;
- image_url – ссылка на изображение. Размер изображения должен быть не менее 1920x1080 px;
- video_url – ссылка на видео;
item_type – тип истории. Возможные значения:
- art – о конкретном произведении (книге, аудиокниге);
- a – об авторе;
- c – о коллекции (подборке) произведений;
- s – о серии книг;
- ad – истории со ссылкой на сайт (возможно сторонний);
- item_id – ID сущности (по item_type), например, ID книги/автора/коллекции/серии/ссылки;
- is_reviewed – статус просмотра пользователем данной истории. Если вернулось значение 1, история была просмотрена, если 0 – не просмотрена. Для анонимных пользователей всегда возвращается is_reviewed=0.
Возможные ошибки
Отсутствуют.
Пример запроса на сервер
{ "mobile_app": "1", "time": "2014-11-07T16:21:02+03:00", "sha": "b79d8e9993d20da6abe78838d3c7fbf640a4c52956569bef3c685d3453316b5c", "sid": "7bad5f2fb752ee957a4ab74aaac7711g", "requests": [ { "func": "r_my_stories", "id": "my_stories" } }
Пример ответа сервера
{ "success": true, "time": "2014-11-07T16:21:02+03:00", "my_stories": { "success": true, "channels": [ { "id": "1", "title": "Название канала", "preview_url": "ссылка на картинку", "stories": [ { "id": "1", "title": "Название сториз", "text": "Текст в сториз", "type": "img", "image_url": "ссылка на сториз картинку", "item_type": "art", "item_id": "5349789", "is_reviewed": "0" }, { "id": "2", "title": "Название сториз", "text": "Текст в сториз", "type": "img", "image_url": "ссылка на сториз картинку", "item_type": "art", "item_id": "8651234", "is_reviewed": "0" } ] }, { "id": "2", "title": "Название канала", "preview_url": "ссылка на картинку", "stories": [ { "id": "1", "title": "Название сториз", "text": "Текст в сториз", "type": "img", "image_url": "ссылка на сториз картинку", "item_type": "c", "item_id": "896786", "is_reviewed": "0" }, { "id": "2", "title": "Название сториз", "text": "Текст в сториз", "type": "video", "video_url": "ссылка на сториз видео", "item_type": "art", "item_id": "352345", "is_reviewed": "1" } ] } ] } }