Получение информации о сообщениях или постах

Для корректной работы ваших чат-ботов и мини-приложений направляйте запросы на домен platform-api2.max.ru вместо platform-api.max.ru. Также убедитесь, что добавили сертификат Минцифры в список доверенных

GET/messages

Возвращает информацию о сообщении или массив сообщений из чата или посты из каналов. Для выполнения запроса нужно указать один из параметров — chat_id или message_ids:

chat_id — метод возвращает массив сообщений или постов из указанного чата или канала, только если чат-бот в них является администратором. Сообщения возвращаются в обратном порядке: последние сообщения будут первыми в массиве. Как получить ID — в разделе «Получение chat_id»
message_ids — метод возвращает информацию о запрошенных сообщениях или постах. Можно указать один идентификатор или несколько

Пример запроса с использованием `chat_id`:

BASH

Скопировать

curl -X GET "https://platform-api2.max.ru/messages?chat_id={chat_id}" \
  -H "Authorization: {access_token}"

Пример запроса с использованием `message_ids`:

BASH

Скопировать

curl -X GET "https://platform-api2.max.ru/messages?message_ids={message_id1},{message_id2}" \
  -H "Authorization: {access_token}"

Авторизация

access_token
apiKey

Передача токена через query-параметры больше не поддерживается — используйте заголовок Authorization: <token>

Токен для вызова HTTP-запросов присваивается при создании бота — его можно найти на платформе в разделе Чат-боты → Перейти → Расширенные настройки → Настроить
Eсли вы верифицировали профиль и создали бота в мини-приложении «MAX для бизнеса», получить токен можно там же или в боте «MAX для бизнеса» с помощью команды Получить токен

Рекомендуем не разглашать токен посторонним, чтобы они не получили доступ к управлению ботом. Токен может быть отозван за нарушение Правил платформы

Параметры

chat_id
integer bigint <int64> optional

ID чата или канала, чтобы получить из него сообщения или посты. Обязательный параметр, если не указан message_ids. Как получить ID — в разделе «Получение chat_id»

message_ids
array <string> optional

Список ID сообщений или постов, которые нужно получить (через запятую). Обязательный параметр, если не указан chat_id

from
integer bigint <int64> optional

Время, до которого будут запрошены все сообщения или посты, начиная с первого опубликованного. Формат времени: Unix timestamp в миллисекундах

to
integer bigint <int64> optional

Время, начиная с которого будут запрошены все сообщения или посты, — вплоть до последнего опубликованного. Формат времени: Unix timestamp в миллисекундах

count
integer [1-100] optional

По умолчанию: 50

Максимальное количество сообщений или постов в ответе

Результат

messages
Message[]

Массив сообщений

Коды ответов

Код	Описание
`200`	Информация о сообщении или массиве сообщений из чата
`401`	Ошибка авторизации. Токен `access_token` указан некорректно или недействителен
`403`	Это исключение возникает, когда пользователь приостановил бота или у него нет доступа к чату
`500`	Внутренняя ошибка сервера