stream.get rest api

Возвращает аггрегированную ленту «Что нового» для текущего пользователя.

Возвращает события ленты «Что нового» для текущего пользователя, то есть события его друзей, групп и т. п. Для получения событий, сгенерированных пользователем, используйте функцию stream.getByAuthorrest.

Параметры

Имя Тип Описание
skiptextid события в ленте «Что нового», после которого получать выборку
limitintлимит событий в выборке; по-умолчанию 10
filter_appintвернуть события созданные только приложением с указанным идентификатором приложения

Результат

Возвращает список событий в обратном хронологическом порядке (самые новые сначала).

Формат ответа для json-выдачи (результат для xml аналогичен):

  1. [
  2.     {
  3.       "id": "081b0000ab375802",
  4.       "generator": { // информация о сгенерировавшем событие приложении
  5.         "app_id": 520706,
  6.         "icon": 'http://appsmail.ru/icons/520706.gif', // иконка 16x16
  7.         "url": "http://my.mail.ru/cgi-bin/my/app-canvas?appid=520706",
  8.         "title": "Дай краба другу в гостевую :)",
  9.         "type": "application"
  10.       },
  11.       "authors": [
  12.         // список авторов события
  13.         // авторов несколько если событие аггрегированное
  14.         // например, если одно действие сделано несколькими людьми
  15.         {
  16.           // объект, аналогичный выдаче users.getInforest
  17.         }
  18.       ],
  19.        
  20.       "subtype": "event", // тип; может быть event (обычное событие),
  21.                           // comment (комментарий к событию) или
  22.                           // like (событие понравилось кому-то)
  23.       "type": "5-26", // тип обычного события, см. ниже
  24.       "time": "1282244418", // время сообщения в формате unixtime
  25.       "title": "Special Non-existent Test Url",
  26.       // идентификатор ветки комментариев, используемый для
  27.       // stream.likerest, stream.unlikerest и stream.commentrest
  28.       // если не задан, то событие нельзя лайкать и комментировать
  29.       "thread_id": "733f55041b7dc5fdaf8ba40102000000",
  30.       "description": "",
  31.       "user_text": "", // текст, введенный пользователем
  32.       "attachments":[ // объекты, прикрепленные к записи
  33.         {
  34.             "object": "link", // тип объекта, бывает link, image, video, audio, user
  35.             // link:
  36.             //   text – название ссылки
  37.             //   url – URL сссылки
  38.             // image: (все кроме src может отсутствовать)
  39.             //   width – ширина отмасштабированной картинки
  40.             //   height – высота отмасштабированной картинки
  41.             //   click_url – URL, если картинка является ссылкой
  42.             //   src – URL исходной картинки
  43.             //   resized_src – URL картинки,
  44.             //                 отмасштабированной по параметрам width и height
  45.             // video:
  46.             //   width – ширина картинки (превью видео)
  47.             //   height – высота картинки (превью видео)
  48.             //   click_url – ссылка на страницу видео
  49.             //   src – URL картинки (превью видео)
  50.             //   resized_src – URL картинки (превью видео),
  51.             //                 отмасштабированной по width и height
  52.             //   player – прямая ссылка на плеер с видео
  53.             //   player_height – исходная высота плеера
  54.             //   player_width – исходная ширина плеера
  55.             // user:
  56.             //   поля повторяют результат выдачи users.getInforest
  57.             // audio:
  58.             //   поля повторяют результат выдачи audios.getrest
  59.  
  60.             "text": "ThisIsSpecialTestUrl.com",
  61.             "url": "http://ThisIsSpecialTestUrl.com"
  62.         }
  63.       ],
  64.       "likes": [
  65.         // массив с пользователями, которым понравилось данное событие
  66.         // элементы массива аналогичны выдаче users.getInforest
  67.       ],
  68.       "comments": [
  69.         {
  70.           "id": "80060000f8044002",
  71.           "text": "lev bamper zerkala", // текст комментария
  72.           "time": 1283786961,
  73.           "author": {
  74.             // аналогично выдаче users.getInforest
  75.           }
  76.         }
  77.       ],
  78.       "action_links": [
  79.         // массив ссылок, связанных с событием
  80.         // предполагается, что переход по данным ссылкам поможет пользователю
  81.         // совершить такое же действие или узнать о нем больше
  82.         {
  83.           "url": "http://example.com/test",
  84.           "text": "test"
  85.         }
  86.       ]
  87.     },
  88.     {
  89.       "id": "0d1b0000ab375802",
  90.       "subtype": "like", // показывает, что это событие типа "событие понравилось"
  91.                          // для событий комментариев структура аналогична
  92.                          // для событий комментариев добавляется поле
  93.       "text": "", // текст комментария для событий с "subtype": "comment"
  94.       "subevent": {
  95.         // объект события, которое понравилось или было прокомментировано
  96.         // описание объекта события см. выше
  97.         // возвращается только для событий типа like или comment
  98.       },
  99.       "author": {
  100.         // аналогично выдаче users.getInforest
  101.       }
  102.     }
  103. ]

Указанные поля могут отсутствовать, если в событии они пустые.

Типы событий:

Коды ошибок

КодОписание
1Unknown error: Please resubmit the request.
2Unknown method called.
3Service Unavailable. Please try again later.
4Method is deprecated.
100One of the parameters specified is missing or invalid.
102User authorization failed: the session key or uid is incorrect.
103Application lookup failed: the application id is not correct.
104Incorrect signature.
105Application is not installed for this user.
200Permission error: the application does not have permission to perform this action.

Пример вызова

http://www.appsmail.ru/platform/api?method=stream.get&app_id=123456&
session_key=551fd0e4779e35859dfccd03397dc8a0&
sig=95a393ed7639184a52f7a17b6771a92&limit=10&skip=081b0000ab375802

Пример ответа в формате JSON

  1. [
  2.     {
  3.       "subevent": {
  4.         "authors": [
  5.           {
  6.             "link": "http://my.rapira9.mail.ru/mail/sigizmund00001/",
  7.             "uid": "11700940109513191366",
  8.             "location": "",
  9.             "sex": 0,
  10.             "pic": "http://avt.appsmail.ru/mail/sigizmund00001/_avatar",
  11.             "pic_big": "http://avt.appsmail.ru/mail/sigizmund00001/_avatarbig",
  12.             "pic_small": "http://avt.appsmail.ru/mail/sigizmund00001/_avatarsmall",
  13.             "is_online": 0,
  14.             "has_pic": 1,
  15.             "birthday": "14.03.1975",
  16.             "first_name":"Сигизмунд",
  17.             "last_name": "1",
  18.             "nick": "Сигизмунд 1"
  19.           }
  20.         ],
  21.         "attachments": [
  22.           {
  23.             "object": "link",
  24.             "text": "killerfeature.com",
  25.             "url": "killerfeature.com"
  26.           }
  27.         ],
  28.         "time": 1282140800,
  29.         "description": "",
  30.         "user_text": "",
  31.         "type": "5-26",
  32.         "title": "",
  33.         "id": "36180000cc62480a"
  34.       },
  35.       "subtype": "like",
  36.       "author": {
  37.         "link": "http://my.rapira9.mail.ru/mail/gotlib00001/",
  38.         "uid": "13286884017948812920",
  39.         "location": "",
  40.         "nick": "Готлиб 1",
  41.         "sex": 0,
  42.         "last_name": "1",
  43.         "pic": "http://avt.appsmail.ru/mail/gotlib00001/_avatar",
  44.         "pic_big": "http://avt.appsmail.ru/mail/gotlib00001/_avatarbig",
  45.         "pic_small": "http://avt.appsmail.ru/mail/gotlib00001/_avatarsmall",
  46.         "is_online": 0,
  47.         "has_pic": 1,
  48.         "birthday": "12.06.1990",
  49.         "first_name": "Готлиб"
  50.       },
  51.       "thread_id": "733f55041b7dc5fdaf8ba40102000000",
  52.       "id": "0d1b0000ab375802"
  53.     },
  54.     {
  55.       "authors":[
  56.         {
  57.           "link": "http://my.rapira9.mail.ru/mail/gotlib00001/",
  58.           "uid": "13286884017948812920",
  59.           "location": "",
  60.           "nick": "Готлиб 1",
  61.           "sex": 0,
  62.           "last_name": "1",
  63.           "pic": "http://avt.appsmail.ru/mail/gotlib00001/_avatar",
  64.           "pic_big": "http://avt.appsmail.ru/mail/gotlib00001/_avatarbig",
  65.           "pic_small": "http://avt.appsmail.ru/mail/gotlib00001/_avatarsmall",
  66.           "is_online": 0,
  67.           "has_pic": 1,
  68.           "birthday": "12.06.1990",
  69.           "first_name": "Готлиб"
  70.         }
  71.       ],
  72.       "attachments":[
  73.         {
  74.             "object": "link",
  75.             "text": "ThisIsSpecialTestUrl.com",
  76.             "url": "http://ThisIsSpecialTestUrl.com"
  77.         }
  78.       ],
  79.       "time": 1282244418,
  80.       "description": "",
  81.       "subtype": "event",
  82.       "user_text": "",
  83.       "type": "5-26",
  84.       "title": "Special Non-existent Test Url",
  85.       "likes": [],
  86.       "thread_id": "733f55041b7dc5fdaf8ba40102000001",
  87.       "id": "081b0000ab375802"
  88.     }
  89. ]

Пример ответа в формате XML

  1. <response_stream_get>
  2.   <event>
  3.     <author>
  4.       <birthday>12.06.1990</birthday>
  5.       <first_name>Готлиб</first_name>
  6.       <has_pic>1</has_pic>
  7.       <is_online>0</is_online>
  8.       <last_name>1</last_name>
  9.       <link>http://my.rapira9.mail.ru/mail/gotlib00001/</link>
  10.       <location></location>
  11.       <nick>Готлиб 1</nick>
  12.       <pic>http://avt.appsmail.ru/mail/gotlib00001/_avatar</pic>
  13.       <pic_big>http://avt.appsmail.ru/mail/gotlib00001/_avatarbig</pic_big>
  14.       <pic_small>http://avt.appsmail.ru/mail/gotlib00001/_avatarsmall</pic_small>
  15.       <sex>0</sex>
  16.       <uid>13286884017948812920</uid>
  17.     </author>
  18.     <thread_id>733f55041b7dc5fdaf8ba40102000000</thread_id>
  19.     <id>0d1b0000ab375802</id>
  20.     <subevent>
  21.       <attachments>
  22.         <object>link</object>
  23.         <text>killerfeature.com</text>
  24.         <url>http://killerfeature.com</url>
  25.       </attachments>
  26.       <authors>
  27.         <birthday>14.03.1975</birthday>
  28.         <first_name>Сигизмунд</first_name>
  29.         <has_pic>1</has_pic>
  30.         <is_online>0</is_online>
  31.         <last_name>1</last_name>
  32.         <link>http://my.rapira9.mail.ru/mail/sigizmund00001/</link>
  33.         <location></location>
  34.         <nick>Сигизмунд 1</nick>
  35.         <pic>http://avt.appsmail.ru/mail/sigizmund00001/_avatar</pic>
  36.         <pic_big>http://avt.appsmail.ru/mail/sigizmund00001/_avatarbig</pic_big>
  37.         <pic_small>http://avt.appsmail.ru/mail/sigizmund00001/_avatarsmall</pic_small>
  38.         <sex>0</sex>
  39.         <uid>11700940109513191366</uid>
  40.       </authors>
  41.       <description></description>
  42.       <id>36180000cc62480a</id>
  43.       <time>1282140800</time>
  44.       <title></title>
  45.       <type>5-26</type>
  46.       <user_text></user_text>
  47.     </subevent>
  48.     <subtype>like</subtype>
  49.   </event>
  50.   <event>
  51.     <attachments>
  52.       <object>link</object>
  53.       <text>ThisIsSpecialTestUrl.com</text>
  54.       <url>http://ThisIsSpecialTestUrl.com</url>
  55.     </attachments>
  56.     <authors>
  57.       <birthday>12.06.1990</birthday>
  58.       <first_name>Готлиб</first_name>
  59.       <has_pic>1</has_pic>
  60.       <is_online>0</is_online>
  61.       <last_name>1</last_name>
  62.       <link>http://my.rapira9.mail.ru/mail/gotlib00001/</link>
  63.       <location></location>
  64.       <nick>Готлиб 1</nick>
  65.       <pic>http://avt.appsmail.ru/mail/gotlib00001/_avatar</pic>
  66.       <pic_big>http://avt.appsmail.ru/mail/gotlib00001/_avatarbig</pic_big>
  67.       <pic_small>http://avt.appsmail.ru/mail/gotlib00001/_avatarsmall</pic_small>
  68.       <sex>0</sex>
  69.       <uid>13286884017948812920</uid>
  70.     </authors>
  71.     <description></description>
  72.     <thread_id>733f55041b7dc5fdaf8ba40102000001</thread_id>
  73.     <id>081b0000ab375802</id>
  74.     <subtype>event</subtype>
  75.     <time>1282244418</time>
  76.     <title>Special Non-existent Test Url</title>
  77.     <type>5-26</type>
  78.     <user_text></user_text>
  79.   </event>
  80. </response_stream_get>

См. также

Использование REST API

Функции REST API