Открытый API → Боты

GET /api/v1/bots

Список всех ботов, принадлежащих владельцу ключа.

Разрешение: read

curl "https://app.maxbotstat.ru/api/v1/bots" \
     -H "X-API-Key: $MBS_KEY"

Ответ

{
  "data": [
    {
      "id": "5d4e3a2b-7c6f-4b8e-9d1a-2c3b4e5f6a7b",
      "name": "MyShop bot",
      "provider": "telegram",
      "active": true,
      "created_at": "2025-09-15T10:00:00Z",
      "last_proxy_at": "2026-04-30T15:23:01Z",
      "bot_display_name": "MyShop bot",
      "contacts_count": 412,
      "messages_24h": 87
    }
  ]
}

Поля

Поле	Тип	Описание
id	строка (UUID)	публичный идентификатор бота
name	строка	имя, заданное в кабинете
provider	telegram или max	платформа бота
active	булево	активен ли бот (если выключен — зеркало возвращает ошибку)
created_at	ISO 8601	когда привязан
last_proxy_at	ISO 8601 или null	время последнего запроса через зеркало
bot_display_name	строка	отображаемое имя бота из Telegram/Max
contacts_count	целое	общее число контактов
messages_24h	целое	сообщений за последние 24 часа

GET /api/v1/bots/{id}

Расширенная карточка бота. id — публичный идентификатор.

curl "https://app.maxbotstat.ru/api/v1/bots/5d4e3a2b-7c6f-4b8e-9d1a-2c3b4e5f6a7b" \
     -H "X-API-Key: $MBS_KEY"

Ответ

{
  "id": "5d4e3a2b-7c6f-4b8e-9d1a-2c3b4e5f6a7b",
  "name": "MyShop bot",
  "provider": "telegram",
  "active": true,
  "created_at": "2025-09-15T10:00:00Z",
  "last_proxy_at": "2026-04-30T15:23:01Z",
  "bot_display_name": "MyShop bot",
  "bot_avatar_url": "https://api.telegram.org/file/bot.../photo.jpg",
  "poll_offset": 0,
  "poll_last_at": null,
  "poll_last_error": null,
  "contacts_count": 412
}

Без токена бота

Поле bot_token через открытый API никогда не возвращается — даже владельцу. Если нужно увидеть токен, посмотрите его в кабинете один раз при привязке.

Ошибки

Код	Когда
404	бот с таким идентификатором не существует или принадлежит другому пользователю
401	см. Авторизацию

Что нельзя через открытый API

• Привязать бота — только через кабинет (требует подтверждения почты и проверки токена).
• Удалить бота — только через кабинет.

Эти операции требуют дополнительного взаимодействия и проверок, поэтому в открытом API их нет. Если нужна автоматизация — пишите в поддержку.