API MAX: новый домен platform-api2.max.ru и изменения для разработчиков

В документации API MAX появились важные обновления. Если вы поддерживаете ботов или миниприложения на платформе, стоит заранее обновить код: меняется домен, способ авторизации и часть методов.

Запросы нужно направлять на домен platformapi2.max.ru вместо platformapi.max.ru. Также убедитесь, что сертификат Минцифры добавлен в список доверенных.

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

Начиная с июня 2026 метод GET /chats больше не поддерживается. Чтобы получить список всех групповых чатов и каналов, в которые добавлен бот, используйте POST /subscriptions.

С 9 сентября 2026 работа метода POST /chats/{chatId}/members будет ограничена, а с 30 сентября 2026 он будет удалён. После этой даты API MAX не предоставляет готовой возможности для добавления участников в групповой чат. Платформа продолжает работать над расширением функциональности API — следите за обновлениями документации.

Авторизация

Токен для вызова HTTPзапросов присваивается при создании бота. Его можно найти на платформе: Чатботы → ⋮ → Настройки.

Если вы верифицировали профиль и создали бота в миниприложении «MAX для бизнеса», получить токен можно там же или в боте «MAX для бизнеса» с помощью команды «Получить токен».

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

Методы API MAX

API MAX — это интерфейс, который позволяет ботам взаимодействовать с платформой и получать данные с помощью HTTPSзапросов к серверу. Запросы должны содержать HTTPметод, соответствующий операции:

GET — получить ресурсы;

POST — создать ресурсы (например, отправить новые сообщения);

PUT — редактировать ресурсы;

DELETE — удалить ресурсы;

PATCH — исправить ресурсы.

В зависимости от конкретного метода параметры передаются в pathпараметрах, queryпараметрах или теле запроса.

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

GET https://platformapi2.max.ru/messages/{messageId} — получить сообщения;

POST https://platformapi2.max.ru/messages — отправить сообщения;

PATCH https://platformapi2.max.ru/chats/{chatId} — изменить информацию о чате.

Пример запроса GET /me

```bash

curl X GET "https://platformapi2.max.ru/me" \

H "Authorization: {accesstoken}"

```

Ответ сервера приходит в формате JSON. Пример ответа на GET /me:

```json

{

"userid": 1,

"firstname": "My Bot",

"name": "My Bot",

"username": "mybot",

"isbot": true,

"lastactivitytime": 1737500130100

}

Также сервер вернёт трёхзначный HTTPкод, который сообщает об успехе или ошибке.

HTTPкоды ответов

200 — успешный запрос

400 — недействительный запрос

401 — ошибка аутентификации

404 — ресурс не найден

405 — метод не допускается

429 — превышено количество запросов

503 — сервис недоступен

Спецификация OpenAPI и официальные библиотеки

Для работы с API MAX можно скачать спецификацию OpenAPI в формате .YAML в репозитории на GitHub. Спецификация подходит для генерации клиентского кода и моделей данных на Python, C, PHP, Java, Swift или Kotlin.

Для разработчиков на TypeScript, JavaScript и Golang доступны официальные библиотеки со стандартными методами и утилитами. Подробнее — в разделах «Библиотека JavaScript» и «Библиотека Golang».

Актуальная документация: https://dev.max.ru/docsapi

Полезно: изменение помогает вовремя заметить новую возможность, правило или поведение сервиса.

Риск: если изменение влияет на API, интерфейс или правила платформы, сервисам может понадобиться проверка совместимости.