API статистики и управления ботом
Данные бота, заказы, доход и настройки через Bot API key.
С Bot API key ваш сервер может получать статистику бота и менять его настройки — без захода в @mgram_robot. Удобно, если у вас много ботов или своя панель управления.
Ключ
- Bot API key находится в карточке бота: «Настройки» → «API-ключ».
- Каждый запрос отправляется с заголовком
Authorization: Bearer ВАШ_BOT_API_KEY. POST /key/regenerateвыпускает новый ключ. Полный ключ показывается только один раз, старый сразу перестаёт работать.
Что можно получить
| Метод | Что возвращает |
|---|---|
GET /bot | Информация о боте |
GET /audience | Аудитория без ID пользователей: всего, Premium, верифицированные, с аватаром, описанием и подарками, заблокировавшие, гео |
GET /orders | Заказы рассылок, в которых участвовал бот |
GET /orders/{id} и /orders/{id}/report | Детали и отчёт рассылки |
GET /reply-ads/orders | Заказы Показов в боте |
GET /stats/mailings и /stats/mailings/today | Рассылки по дням и за сегодня |
GET /stats/reply-ads | Статистика Показов |
GET /stats/income и /stats/income/today | Доход по дням и за сегодня |
GET /earnings | Заработок: сегодня, ожидается, всего |
GET /balance | Баланс владельца |
Что можно изменить
| Метод | Что делает |
|---|---|
POST /bot/settings | Слоты, скорость, каталог, свои заказы, участие в рассылках, цена в каталоге, Показы |
GET /bot/time_slots | Доступные слоты и текущий выбор |
POST /bot/stop_mailing | Отключает участие в новых рассылках; назначенные заказы продолжаются |
POST /bot/token | Заменяет токен Telegram-бота — только на токен того же бота |
Менять можно только настройки, доступные владельцу в интерфейсе MGRAM, и только допустимыми значениями.
Ошибки
Все ошибки приходят в одном формате. Основные коды:
| Код | Что значит |
|---|---|
| 400 | Некорректный запрос — проверьте параметры |
| 401 | Ключ не принят |
| 403 | Нет доступа к операции |
| 404 | Не найдено |
| 409 | Конфликт запроса |
| 429 | Слишком много запросов — повторите позже |
| 5xx | Временная ошибка сервиса — повторите позже |
Храните Bot API key только на сервере. Не вставляйте его в код Mini App, сайта или клиентского приложения.
Параметры и примеры ответов каждого метода — на api.mgram.biz.