REST API AppsMax v1: опубликовали документацию и OpenAPI

У REST API AppsMax v1 теперь есть единая публичная документация и машиночитаемый OpenAPI JSON.

Что вошло в публичную reference

• 21 метод и 12 scopes для ботов, подключений, мини-приложений, сценариев, меню, заявок, кампаний и подписчиков.
• Авторизация через Authorization: Bearer и запасной заголовок X-Api-Token.
• Фильтры, пагинация, структура ошибок, заголовки версии и базовый rate limit.
• Примеры cURL и отдельный OpenAPI 3.0.3 JSON для инструментов разработчика.

Канонический production base URL: https://telegram.appsmax.ru/api/v1. Название рабочего домена историческое и не означает, что API ограничен Telegram: доступные объекты определяются организацией, её проектами и правилами подключённого канала.

Что можно делать через API

Интеграция может читать проекты и рабочие объекты AppsMax, создавать заявки с обязательным bot_id, синхронизировать теги, работать с подписчиками и создавать кампании. Создание кампании и её запуск намеренно разделены на два действия: сначала система получает запись и параметры, затем интеграция отдельно вызывает запуск после собственных проверок.

curl --request GET
  --url https://telegram.appsmax.ru/api/v1/me
  --header 'Authorization: Bearer YOUR_API_TOKEN'

Метод GET /me помогает проверить организацию токена, scopes и фактический индивидуальный лимит до начала обмена данными.

Границы

• Это API платформы AppsMax, а не официальный API MAX или Telegram.
• REST API предназначен для server-to-server интеграций. Секретный токен нельзя помещать в браузерный JavaScript, мобильное приложение, публичный репозиторий или URL.
• На 25 июля 2026 года REST API входит в тариф «Профи» либо включается по индивидуальному праву.
• Официальные Python, PHP или JavaScript SDK AppsMax сейчас не заявлены: достаточно обычного HTTPS-клиента и OpenAPI.
• Настройки исходящих webhook есть в кабинете, но полный payload/retry/security-контракт webhook пока не включён в публичную reference.
• Наличие API-метода не отменяет согласие адресата, требования закона и правила конкретного мессенджера.

Где открыть документацию

Полная reference доступна на странице REST API AppsMax v1 для разработчиков. Рядом можно посмотреть обзор готовых интеграций и API и актуальные тарифы.

Если API уже включён для организации, токен создаётся в кабинете: Данные → Интеграции → API. Передавать рабочий токен в обычном письме или чате поддержки не нужно.

Документация и OpenAPI сверены с production-контрактом 25 июля 2026 года. Материал описывает доступный технический интерфейс и не обещает совместимость с любой внешней системой или коммерческий результат.