Получение сообщений с упоминаниями

Метод и конечная точка

GET /chat.getMentionedMessages

Описание

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

Параметры

Перечень параметров представлен в таблице.

Название	Обязательный	Тип данных	Описание
roomId	да	string	Идентификатор комнаты
offset	нет	number	Смещение для пагинации
count	нет	number	Количество результатов на страницу
sort	нет	string	Поле для сортировки

Запрос

curl -X 'GET' \
  'https://im-<ENV>.<DEFAULT_DOMAIN>/api/v1/chat.getMentionedMessages?roomId=<ROOM_ID>&offset=0&count=20' \
  -H 'accept: application/json' \
  -H 'X-User-Id: <USER_ID>' \
  -H 'x-auth-token: <AUTH_TOKEN>'

Где:

• <ENV> — окружение, на котором выполняется запрос;
• <DEFAULT_DOMAIN> — домен сервера Squadus;
• <USER_ID> — идентификатор пользователя, от имени которого выполняется запрос;
• <AUTH_TOKEN> — токен аутентификации пользователя;
• <ROOM_ID> — идентификатор комнаты.

Ответ

200 — Successfully get mentioned messages — Сообщения с упоминаниями. Пример вывода:

{
  "success": true,
  "count": 2,
  "offset": 0,
  "total": 2,
  "messages": [
    {
      "_id": "msg_123456",
      "rid": "GENERAL",
      "msg": "Hello @john.doe!",
      "mentions": [
        {
          "_id": "7w9BMr9r78W4RNe8x",
          "username": "john.doe"
        }
      ],
      "ts": "2026-06-24T10:00:00.000Z"
    }
  ]
}