mailru.app.friends.request — js api

Показывает пользователю диалог отправки запроса друзьям в приложение.

Внешний вид: диалога, уведомления о запросе.

Параметры

Имя Тип Описание
paramsobjectобъект с параметрами для запроса; обязательный параметр

Пример параметра params:

{
    //обязательный параметр. url-адрес картинки для запроса, максимум 200 символов
    image_url: "http://content.foto.mail.ru/corp/martirosov/_cover/i-1187.jpg",

    //обязательный параметр. текст запроса, максимум 100 символов
    text: "Приходи и поиграй со мной!", 

    //необязательный параметр. список друзей пользователя,
    //которые автоматически будут выбраны в диалоге отправки запроса
    friends: ["123", "345"],

    //необязательный параметр. hash-параметр для запроса, максимум 16 символов (0-9, a-f)
    hash: "0123456789abcdef"
}

Результат

Для получения результата выполнения функции подписывайтесь на события, описанные в секции «Генерируемые события».

Генерируемые события

mailru.app.events.friendsRequest

{
   // варианты: opened/closed
   'status': "closed",
   // id пользователей, которым отправили запрос
   'data': [123,234,345]
}

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

mailru.events.listen(mailru.app.events.friendsRequest, function(event) {
  // эта функция будет вызываться при закрытии диалога
});
mailru.app.friends.request({
   text: 'Помоги мне доить корову!',
   image_url: 'http://content.foto.mail.ru/corp/martirosov/_cover/i-1187.jpg',
   friends: ['123', '345'],
   hash: '0123456789abcdef'
});

См. также

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

Функции JS API