mailru.common.friends.add — js api

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

Параметры

Имя Тип Описание
uidstringuid пользователя, которого добавляем в друзья; обязательный параметр

Результат

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

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

mailru.common.events.friends.add

{
  // может быть:
  //   opened - событие открытия диалога, 
  //   closed - пользователь нажал кнопку «Отмена» 
  //   alreadySent - запрос на дружбу уже был отправлен, 
  //   alreadyFriends - пользователи уже друзья, 
  //   wrongUID - неправильный UID, 
  //   success - запрос на дружбу успешно отправлен
  'status': "closed" 
}

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

mailru.events.listen(mailru.common.events.friends.add, function(event) {
  // эта функция будет вызываться при открытии и закрытии диалога
});
mailru.common.friends.add('15410773191172635989');

Мобильная версия

В мобильной версии JS API не работает, но вы можете показать пользователю диалог предложения дружбы, открыв страницу с нужными параметрами.

Параметры

Имя Тип Описание
app_idintидентификатор приложения; обязательный параметр
uidstringuid пользователя, которого добавляем в друзья; обязательный параметр
session_keystringсессионный ключ пользователя; обязательный параметр
redirect_uristringURL для возврата пользователя после совершения действия; обязательный параметр

Пример адреса страницы

http://m.my.mail.ru/api/add_friend?uid=15984764615407557866&appid=537392&
session_key=52441d1b75ebfa731be60dedb307093e&redirect_uri=http%3A%2F%2Fbitman.me

После отправки приглашения (или если пользователь откажется его отправлять) браузер пользователя будет перенаправлен на указанный вами redirect_uri с GET-параметром status. Значения параметра аналогичны статусам в событии mailru.common.events.friends.add.

См. также

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

Функции JS API