stream.get rest api

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

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

Параметры

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

Результат

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

Формат ответа для 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
      }
    }
]

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

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

Коды ошибок

КодОписание
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

[
    {
      "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
    
      
        link
        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
  
  
    
      link
      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
    
  

См. также

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

Функции REST API