MAX обновил API: новый домен, авторизация через заголовок и изменения методов в 2026

Коротко: что произошло

MAX обновил документацию по API для разработчиков ботов и миниприложений. Ключевые изменения:

запросы нужно направлять на домен platformapi2.max.ru вместо platformapi.max.ru;

передача токена через queryпараметры больше не поддерживается — используется заголовок Authorization;

с июня 2026 метод GET /chats перестанет поддерживаться, вместо него — POST /subscriptions;

с 9 сентября 2026 ограничена работа метода POST /chats/{chatId}/members.

Куда отправлять запросы

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

Авторизация: заголовок вместо queryпараметров

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

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

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

Ограничения методов с 2026 года

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

С 9 сентября 2026 ограничена работа метода POST /chats/{chatId}/members.

Как устроены методы API MAX

API MAX — интерфейс, который позволяет ботам взаимодействовать с платформой и получать данные с помощью HTTPSзапросов к серверу. 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

{

"userid": 1,

"firstname": "My Bot",

"name": "My Bot",

"username": "mybot",

"isbot": true,

"lastactivitytime": 1737500130100

}

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

Помимо JSONобъекта с данными или сообщением об ошибке, сервер возвращает трёхзначный HTTPкод:

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

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

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

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

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

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

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

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

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

Учтите: спецификация содержит краткое описание параметров и эндпоинтов — подробности читайте в документации и описании конкретных методов.

Если вы пишете ботов на TypeScript, JavaScript или Golang, MAX рекомендует официальную библиотеку — она содержит стандартные методы и утилиты. Подробнее — в разделах «Библиотека JavaScript» и «Библиотека Golang» или на GitHub.

Что делать разработчикам

1. Переведите запросы на домен platformapi2.max.ru.

2. Убедитесь, что сертификат Минцифры добавлен в список доверенных.

3. Перенесите токен из queryпараметров в заголовок Authorization.

4. Если используете GET /chats, запланируйте переход на POST /subscriptions до июня 2026.

5. Проверьте, не затронет ли вас ограничение POST /chats/{chatId}/members, действующее с 9 сентября 2026.

Ещё одно нововведение: если вы используете AIагента для создания бота, установите ему специальный навык MAX Messenger Agent Skill — он разработает бота по заданным условиям.

Источники

Обзор API MAX

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

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