Возвращает аггрегированную ленту «Что нового» для текущего пользователя.
Возвращает события ленты «Что нового» для текущего пользователя, то есть события его друзей, групп и т. п. Для получения событий, сгенерированных пользователем, используйте функцию stream.getByAuthorrest.
| Имя | Тип | Описание |
|---|---|---|
| skip | text | id события в ленте «Что нового», после которого получать выборку |
| limit | int | лимит событий в выборке; по-умолчанию 10 |
| filter_app | int | вернуть события созданные только приложением с указанным идентификатором приложения |
Возвращает список событий в обратном хронологическом порядке (самые новые сначала).
Формат ответа для json-выдачи (результат для xml аналогичен):
[
{
"id": "081b0000ab375802",
"generator": { // информация о сгенерировавшем событие приложении
"app_id": 520706,
"icon": 'http://appsmail.ru/icons/520706.gif', // иконка 16x16
"url": "http://my.mail.ru/cgi-bin/my/app-canvas?appid=520706",
"title": "Дай краба другу в гостевую :)",
"type": "application"
},
"authors": [
// список авторов события
// авторов несколько если событие аггрегированное
// например, если одно действие сделано несколькими людьми
{
// объект, аналогичный выдаче users.getInforest
}
],
"subtype": "event", // тип; может быть event (обычное событие),
// comment (комментарий к событию) или
// like (событие понравилось кому-то)
"type": "5-26", // тип обычного события, см. ниже
"time": "1282244418", // время сообщения в формате unixtime
"title": "Special Non-existent Test Url",
// идентификатор ветки комментариев, используемый для
// stream.likerest, stream.unlikerest и stream.commentrest
// если не задан, то событие нельзя лайкать и комментировать
"thread_id": "733f55041b7dc5fdaf8ba40102000000",
"description": "",
"user_text": "", // текст, введенный пользователем
"attachments":[ // объекты, прикрепленные к записи
{
"object": "link", // тип объекта, бывает link, image, video, audio, user
// link:
// text – название ссылки
// url – URL сссылки
// image: (все кроме src может отсутствовать)
// width – ширина отмасштабированной картинки
// height – высота отмасштабированной картинки
// click_url – URL, если картинка является ссылкой
// src – URL исходной картинки
// resized_src – URL картинки,
// отмасштабированной по параметрам width и height
// video:
// width – ширина картинки (превью видео)
// height – высота картинки (превью видео)
// click_url – ссылка на страницу видео
// src – URL картинки (превью видео)
// resized_src – URL картинки (превью видео),
// отмасштабированной по width и height
// player – прямая ссылка на плеер с видео
// player_height – исходная высота плеера
// player_width – исходная ширина плеера
// user:
// поля повторяют результат выдачи users.getInforest
// audio:
// поля повторяют результат выдачи audios.getrest
"text": "ThisIsSpecialTestUrl.com",
"url": "http://ThisIsSpecialTestUrl.com"
}
],
"likes": [
// массив с пользователями, которым понравилось данное событие
// элементы массива аналогичны выдаче users.getInforest
],
"comments": [
{
"id": "80060000f8044002",
"text": "lev bamper zerkala", // текст комментария
"time": 1283786961,
"author": {
// аналогично выдаче users.getInforest
}
}
],
"action_links": [
// массив ссылок, связанных с событием
// предполагается, что переход по данным ссылкам поможет пользователю
// совершить такое же действие или узнать о нем больше
{
"url": "http://example.com/test",
"text": "test"
}
]
},
{
"id": "0d1b0000ab375802",
"subtype": "like", // показывает, что это событие типа "событие понравилось"
// для событий комментариев структура аналогична
// для событий комментариев добавляется поле
"text": "", // текст комментария для событий с "subtype": "comment"
"subevent": {
// объект события, которое понравилось или было прокомментировано
// описание объекта события см. выше
// возвращается только для событий типа like или comment
},
"author": {
// аналогично выдаче users.getInforest
}
}
]
Указанные поля могут отсутствовать, если в событии они пустые.
Типы событий:
| Код | Описание |
|---|---|
| 1 | Unknown error: Please resubmit the request. |
| 2 | Unknown method called. |
| 3 | Service Unavailable. Please try again later. |
| 4 | Method is deprecated. |
| 100 | One of the parameters specified is missing or invalid. |
| 102 | User authorization failed: the session key or uid is incorrect. |
| 103 | Application lookup failed: the application id is not correct. |
| 104 | Incorrect signature. |
| 105 | Application is not installed for this user. |
| 200 | Permission 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
[
{
"subevent": {
"authors": [
{
"link": "http://my.rapira9.mail.ru/mail/sigizmund00001/",
"uid": "11700940109513191366",
"location": "",
"sex": 0,
"pic": "http://avt.appsmail.ru/mail/sigizmund00001/_avatar",
"pic_big": "http://avt.appsmail.ru/mail/sigizmund00001/_avatarbig",
"pic_small": "http://avt.appsmail.ru/mail/sigizmund00001/_avatarsmall",
"is_online": 0,
"has_pic": 1,
"birthday": "14.03.1975",
"first_name":"Сигизмунд",
"last_name": "1",
"nick": "Сигизмунд 1"
}
],
"attachments": [
{
"object": "link",
"text": "killerfeature.com",
"url": "killerfeature.com"
}
],
"time": 1282140800,
"description": "",
"user_text": "",
"type": "5-26",
"title": "",
"id": "36180000cc62480a"
},
"subtype": "like",
"author": {
"link": "http://my.rapira9.mail.ru/mail/gotlib00001/",
"uid": "13286884017948812920",
"location": "",
"nick": "Готлиб 1",
"sex": 0,
"last_name": "1",
"pic": "http://avt.appsmail.ru/mail/gotlib00001/_avatar",
"pic_big": "http://avt.appsmail.ru/mail/gotlib00001/_avatarbig",
"pic_small": "http://avt.appsmail.ru/mail/gotlib00001/_avatarsmall",
"is_online": 0,
"has_pic": 1,
"birthday": "12.06.1990",
"first_name": "Готлиб"
},
"thread_id": "733f55041b7dc5fdaf8ba40102000000",
"id": "0d1b0000ab375802"
},
{
"authors":[
{
"link": "http://my.rapira9.mail.ru/mail/gotlib00001/",
"uid": "13286884017948812920",
"location": "",
"nick": "Готлиб 1",
"sex": 0,
"last_name": "1",
"pic": "http://avt.appsmail.ru/mail/gotlib00001/_avatar",
"pic_big": "http://avt.appsmail.ru/mail/gotlib00001/_avatarbig",
"pic_small": "http://avt.appsmail.ru/mail/gotlib00001/_avatarsmall",
"is_online": 0,
"has_pic": 1,
"birthday": "12.06.1990",
"first_name": "Готлиб"
}
],
"attachments":[
{
"object": "link",
"text": "ThisIsSpecialTestUrl.com",
"url": "http://ThisIsSpecialTestUrl.com"
}
],
"time": 1282244418,
"description": "",
"subtype": "event",
"user_text": "",
"type": "5-26",
"title": "Special Non-existent Test Url",
"likes": [],
"thread_id": "733f55041b7dc5fdaf8ba40102000001",
"id": "081b0000ab375802"
}
]
Пример ответа в формате XML
12.06.1990
Готлиб
1
0
1
http://my.rapira9.mail.ru/mail/gotlib00001/
Готлиб 1
http://avt.appsmail.ru/mail/gotlib00001/_avatar
http://avt.appsmail.ru/mail/gotlib00001/_avatarbig
http://avt.appsmail.ru/mail/gotlib00001/_avatarsmall
0
13286884017948812920
733f55041b7dc5fdaf8ba40102000000
0d1b0000ab375802
killerfeature.com
http://killerfeature.com
14.03.1975
Сигизмунд
1
0
1
http://my.rapira9.mail.ru/mail/sigizmund00001/
Сигизмунд 1
http://avt.appsmail.ru/mail/sigizmund00001/_avatar
http://avt.appsmail.ru/mail/sigizmund00001/_avatarbig
http://avt.appsmail.ru/mail/sigizmund00001/_avatarsmall
0
11700940109513191366
36180000cc62480a
5-26
like
ThisIsSpecialTestUrl.com
http://ThisIsSpecialTestUrl.com
12.06.1990
Готлиб
1
0
1
http://my.rapira9.mail.ru/mail/gotlib00001/
Готлиб 1
http://avt.appsmail.ru/mail/gotlib00001/_avatar
http://avt.appsmail.ru/mail/gotlib00001/_avatarbig
http://avt.appsmail.ru/mail/gotlib00001/_avatarsmall
0
13286884017948812920
733f55041b7dc5fdaf8ba40102000001
081b0000ab375802
event
Special Non-existent Test Url
5-26