API › Личные сообщения

Личные сообщения im

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

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

Список диалогов пользователя.

Параметры

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

История сообщений в диалоге.

Параметры

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

Количество непрочитанных диалогов.

rate-limit: 120 / 1 мин на user
im_send POST /api.php?act=im_send auth write csrf

Отправить текстовое сообщение в диалог.

Параметры

имятипreqописание
convo_id int да
text string да

Ответ result

pm_id
int
rate-limit: 60 / 1 мин на user
im_send_voice POST /api.php?act=im_send_voice auth write csrf

Прикрепить голосовое сообщение. voice_id — id из upload-эндпоинта.

Параметры

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

Прикрепить видео-кружок.

Параметры

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

Пометить диалог прочитанным.

Параметры

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

Удалить одно сообщение.

Параметры

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

Редактировать своё сообщение.

Параметры

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

Удалить весь диалог (только у себя).

Параметры

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