С помощью данного запроса можно получить все активные истории (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"
          }
        ]
      }
    ]
  }
}

Attachments: