friends

friends.areFriends

Возвращает информацию о том, добавлен ли текущий пользователь в друзья у указанных пользователей.

Этот метод можно вызвать с ключом доступа пользователя.

Требуются права доступа: friends.

Параметры

user_ids

string

Идентификаторы пользователей, статус дружбы с которыми нужно проверить.

need_sign

string

1 – необходимо вернуть поле sign которое равно: md5("{id}_{user_id}_{friends_status}_{application_secret}"), Где, id — это идентификатор пользователя, для которого выполняется запрос. Позволяет на сервере убедиться что данные не были подделаны на клиенте. 0 — поле sign возвращать не нужно.

extended

string

1 — необходимо вернуть is_request_unread, если есть непрочитанная заявка в друзья.

Результат

После успешного выполнения возвращает массив объектов, каждый из которых содержит следующие поля:

  • user_id — идентификатор пользователя (из числа переданных в параметре user_ids);
  • friend_status — статус дружбы с пользователем:
    • 0 – пользователь не является другом;
    • 1 – отправлена заявка/подписка пользователю;
    • 2 – имеется входящая заявка/подписка от пользователя;
    • 3 – пользователь является другом.
  • is_request_unread — есть ли непрочитанная заявка в друзья от пользователя (true — есть, false или отсутсвие поля — непрочитанной заявки нет), возвращается только если передан параметр extended и friend_status = 2.

Коды ошибок

В ходе выполнения могут произойти общие ошибки.