Получение обновлений о событиях через Long Polling

GET/updates

Получение обновлений с помощью Long Polling ограничено по скорости и сроку хранения событий — этот способ не подходит для production-окружения. Рекомендуем на всех этапах работы использовать Webhook

Метод GET /updates можно использовать для получения обновлений при разработке и тестировании, если ваш бот не подписан на Webhook. Для production-окружения используйте только Webhook

Каждое обновление со списком событий имеет свой порядковый номер. Свойство marker в ответе указывает на следующее ожидаемое обновление. После того, как вы передали marker с указателем на конкретное обновление, все предыдущие считаются прочитанными

Если параметр marker не передан или передано значение null, вы получите только последнее обновление

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

BASH

Скопировать

curl -X GET "https://platform-api.max.ru/updates" \
  -H "Authorization: {access_token}"

Авторизация

access_token
apiKey

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

Токен для вызова HTTP-запросов присваивается при создании бота — его можно найти на платформе в разделе Чат-боты → Интеграция → Получить токен.

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

Параметры

limit
integer [1-1000] optional

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

Максимальное количество обновлений о событиях, которое может вернуться в ответе на запрос

timeout
integer [0-90] optional

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

Тайм-аут в секундах для долгого опроса

marker
integer <int64> Nullable optional

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

types
string[] Nullable optional

Пример: types=message_created,message_callback

Список типов событий, которые вы хотите получать, например: message_created, message_callback. Полный список возможных событий смотрите в описании объекта Update

Результат

updates
Update[]

Список обновлений о событиях в чатах и каналах, в которые добавлен бот. Обратите внимание, чтобы получать события из групповых чатов и каналов, бот должен быть администратором. Подробнее о возможных событиях — в описании объекта Update

marker
integer <int64> Nullable

Указатель на следующую страницу данных