# MAX Bot API: GET /updates — Получение событий (long polling)

Для событий из групповых чатов и каналов бот должен быть администратором.

В ответе: `updates[]` и `marker` — указатель на следующую страницу; всё до него считается прочитанным.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `limit` | query | integer | нет | 1–1000, по умолчанию 100 |
| `timeout` | query | integer | нет | Ожидание в секундах, 0–90, по умолчанию 30 |
| `marker` | query | integer | нет | marker из предыдущего ответа; без него вернётся только последнее обновление |
| `types` | query | array | нет | Типы событий, например message_created,message_callback |

## Базовые URL

- Боевой: `https://platform-api2.max.ru`
- Документация просит отправлять запросы на  вместо старого .: `platform-api2.max.ru`

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

Тип: API-ключ

Токен бота передаётся в заголовке `Authorization: <access_token>` (без префикса). Передача токена в query-параметре `access_token` больше не поддерживается.

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

## Нюансы

- Загрузка файла: `POST /uploads?type=...` → загрузить файл на `url` (multipart целиком или resumable частями) → передать токен в `attachments[].payload.token` в `POST /messages` или `PUT /messages`.
- Сразу после загрузки файл может быть не обработан — ошибка `attachment.not.ready`; повторяйте отправку с растущим интервалом.
- Вебхук: только HTTPS на порту 443, сертификат доверенного центра или Минцифры, полная цепочка сертификатов; самоподписанные сертификаты не поддерживаются. Проверяйте заголовок `X-Max-Bot-Api-Secret`.
- `GET /chats` не поддерживается с июня 2026; `POST /chats/{chatId}/members` удалён с 30 сентября 2026.
- Методы `PUT`/`POST /subscriptions`/`POST /answers` возвращают HTTP 200 и при неуспехе — проверяйте поле `success`.

## Сценарии с этим методом

- [Бот без сервера: long polling для разработки](https://mcp-everything.ru/integrations/max-bot-api/scenarios/bot-bez-servera-long-polling-dlya.md)
- [Кнопки под сообщением и ответ на нажатие](https://mcp-everything.ru/integrations/max-bot-api/scenarios/knopki-pod-soobscheniem-i-otvet.md)

---

Если этого недостаточно — официальная документация: https://dev.max.ru/docs-api
Вся интеграция одним документом: https://mcp-everything.ru/integrations/max-bot-api.md