API › Друзья

Друзья friend

9 actions · URL: /api.php?act=<name> или /api/v1/friend/<action>

friend_list GET /api.php?act=friend_list auth read

Список друзей (своих или другого пользователя).

Параметры

имятипreqописание
user_id int нет по умолч. — свои
start int нет
limit int нет
rate-limit: 120 / 1 мин на user
friend_requests GET /api.php?act=friend_requests auth read

Входящие заявки в друзья.

Параметры

имятипreqописание
start int нет
limit int нет
rate-limit: 120 / 1 мин на user
friend_requests_outgoing GET /api.php?act=friend_requests_outgoing auth read

Исходящие (отправленные) заявки.

Параметры

имятипreqописание
start int нет
limit int нет
rate-limit: 120 / 1 мин на user
friend_check GET /api.php?act=friend_check auth read

Статус отношений с пользователем.

Параметры

имятипreqописание
user_id int да

Ответ result

is_friend
bool
request_outgoing
bool
request_incoming
bool
rate-limit: 120 / 1 мин на user
friend_add POST /api.php?act=friend_add auth write csrf

Отправить заявку в друзья (или мгновенно подружиться — зависит от настроек сети). Если встречная заявка уже есть — она будет принята.

Параметры

имятипreqописание
user_id int да

Ответ result

status
"pending" | "friends"

Ошибки

verification_requiredАккаунт не верифицирован (email/телефон).
already_friendsУже друзья.
request_already_sentЗаявка уже отправлена.
blockedПользователь добавил вас в чёрный список.
rate-limit: 20 / 1 ч на user
friend_accept POST /api.php?act=friend_accept auth write csrf

Принять входящую заявку.

Параметры

имятипreqописание
user_id int да кто отправил заявку

Ответ result

status
"friends"
rate-limit: 30 / 1 мин на user
friend_reject POST /api.php?act=friend_reject auth write csrf

Отклонить входящую заявку.

Параметры

имятипreqописание
user_id int да
rate-limit: 30 / 1 мин на user
friend_cancel POST /api.php?act=friend_cancel auth write csrf

Отменить свою исходящую заявку.

Параметры

имятипreqописание
user_id int да
rate-limit: 30 / 1 мин на user
friend_remove POST /api.php?act=friend_remove auth write csrf

Удалить из друзей.

Параметры

имятипreqописание
user_id int да
rate-limit: 30 / 1 мин на user