24.06.2026 00:00

GetUserPresence

[POST] .../v1/chat/getuserpresence

Возвращает presence пользователей, с которыми у текущего пользователя есть общий активный чат.

OAuth sub пользователя наружу не возвращается. Пользователи без общего активного чата с текущим пользователем не включаются в result.

Входные параметры

Название Тип данных Обязательность Описание
user_ids Array of Int64 Обязательный ID пользователей, presence которых нужно получить

Ограничения и проверки

  • Количество элементов в user_ids задается серверными настройками.
  • Текущий пользователь исключается из результата.
  • Возвращаются только пользователи, с которыми у текущего пользователя есть общий активный чат.
  • Если пользователь доступен, но у него нет OAuth sub или Notify не вернул presence для этого sub, он возвращается как online = false.

Пример запроса

{
  "user_ids": [456, 789]
}

Возможные ошибки

Код Описание
1008 Тело запроса не передано
1002 Не передан user_ids или количество элементов превышает серверные настройки
7351 Сервис Notify вернул ошибку при получении presence

Выходные параметры

Название Тип данных Описание
result Array of ChatUserPresence Список presence пользователей
result[].user_id Int64 ID пользователя
result[].online Boolean Пользователь онлайн
result[].last_online_date Int64? Unix timestamp последнего online-статуса пользователя

Пример ответа

{
  "ok": true,
  "result": [
    {
      "user_id": 456,
      "online": true,
      "last_online_date": 1782281180
    },
    {
      "user_id": 789,
      "online": false,
      "last_online_date": 1782279000
    }
  ]
}