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

Получение обновлений с помощью [Long Polling](/docs-api/methods/GET/updates) ограничено по скорости и сроку хранения событий — этот способ не подходит для production-окружения. Рекомендуем на всех этапах работы использовать [Webhook](/docs-api/methods/POST/subscriptions)

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

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

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

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

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

## Авторизация

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

Токен для вызова HTTP-запросов присваивается при создании бота — его можно найти на [платформе](https://business.max.ru/self) в разделе **Чат-боты**. Выберите необходимого бота и нажмите **⋮** → **Настройки** → значок копирования справа от поля с токеном

Если вы верифицировали профиль и создали бота в [мини-приложении «MAX для бизнеса»](https://max.ru/business_bot?startapp), получить токен можно там же или в [боте «MAX для бизнеса»](https://max.ru/business_bot) с помощью команды **Получить токен**

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

## Параметры

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

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

Тайм-аут в секундах для долгого опроса
Чтобы получить последнее обновление событий, передайте `null` или оставьте поле пустым. Чтобы получить все обновления по событиям с момента предыдущего запроса, передайте значение `marker`, которое получили в ответ на предыдущий запрос
Список типов событий, которые вы хотите получать. Полный список возможных событий смотрите в описании [объекта `Update`](/docs-api/objects/Update)

## Результат

Список обновлений о событиях в чатах и каналах, в которые добавлен бот. Обратите внимание, чтобы получать события из групповых чатов и каналов, бот должен быть администратором. Подробнее о возможных событиях — [в описании объекта Update](/docs-api/objects/Update)

Unix timestamp в миллисекундах, когда произошло событие
ID чата или канала, куда был добавлен бот. Как получить ID — в [разделе «Получение chat_id»](/docs-api#Получение%20chat_id)
Пользователь, добавивший бота в чат

Идентификатор пользователя или бота
Отображаемое имя пользователя или бота
Отображаемая фамилия пользователя. Для ботов это поле не возвращается
Никнейм бота или уникальное публичное имя пользователя. В случае с пользователем может быть `null`, если тот недоступен или имя не задано
`true`, если это бот
Время последней активности пользователя или бота в MAX (Unix timestamp в миллисекундах). Если пользователь отключил в настройках профиля мессенджера MAX возможность видеть, что он в сети онлайн, поле может не возвращаться
_Устаревшее поле, скоро будет удалено_

Указывает, что бот добавлен в канал, а не в чат

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

## Коды ответов

| Код | Описание |
| --- | --- |
| `200` | Список обновлений событий с указателем на следующую страницу данных |
| `401` | Ошибка авторизации. Токен `access_token` указан некорректно или недействителен |
| `405` | Метод не разрешен |
| `500` | Внутренняя ошибка сервера |