mailru.common.friends.add js api

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

Параметры

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

Результат

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

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

mailru.common.events.friends.add

  1. {
  2.   // может быть:
  3.   //   opened - событие открытия диалога,
  4.   //   closed - пользователь нажал кнопку «Отмена»
  5.   //   alreadySent - запрос на дружбу уже был отправлен,
  6.   //   alreadyFriends - пользователи уже друзья,
  7.   //   wrongUID - неправильный UID,
  8.   //   success - запрос на дружбу успешно отправлен
  9.   'status': "closed"
  10. }

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

  1. mailru.events.listen(mailru.common.events.friends.add, function(event) {
  2.   // эта функция будет вызываться при открытии и закрытии диалога
  3. });
  4. 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