Получение обновлений
GET/updates
Этот метод можно использовать для получения обновлений, если ваш бот не подписан на WebHook. Метод использует долгий опрос (long polling).
Каждое обновление имеет свой номер последовательности. Свойство marker
в ответе указывает на следующее ожидаемое обновление.
Все предыдущие обновления считаются завершенными после прохождения параметра marker
. Если параметр marker
не передан, бот получит все обновления, произошедшие после последнего подтверждения.
Авторизация
access_token
apiKey optional
Токен присваивается боту при регистрации в MAX через @MasterBot. Это уникальный идентификатор, с помощью которого бот взаимодействует с MAX Bot API: токен передаётся в качестве параметра access_token
в HTTP-запросе
Рекомендуем не разглашать токен посторонним, чтобы они не получили доступ к управлению ботом. Если вы опасаетесь, что идентификатор скомпрометирован, отзовите его и сгенерируйте новый через /revoke
в @MasterBot. Токен также может быть отозван за нарушение Правил платформы
Параметры
limit
integer [1-1000] optional
По умолчанию: 100
Максимальное количество обновлений для получения
timeout
integer [0-90] optional
По умолчанию: 30
Тайм-аут в секундах для долгого опроса
marker
integer <int64> Nullable optional
Если передан, бот получит обновления, которые еще не были получены. Если не передан, получит все новые обновления
types
string[] Nullable optional
Пример: types=message_created,message_callback
Список типов обновлений, которые бот хочет получить (например, message_created
, message_callback
)
Результат
updates
Update[]
Страница обновлений
marker
integer <int64> Nullable
Указатель на следующую страницу данных