API сервера для ботов
Клиентский API Millida Hosting: выпуск ключа, права, управление сервером и стрим консоли из своего бота или скрипта.
Обновлено 25 июля 2026 г.
Всё, что делает панель, можно делать из своего кода: поднимать сервер по расписанию, показывать статус в Discord, отправлять команды из бота.
Ключ
API доступен на тарифах «Свой проект» (Про) — там же, где файлы, SFTP и доступ команде. На бесплатном и базовых тарифах ключ не выпускается: ключ — это тот же совместный доступ, только для бота.
Раздел «Доступ» → «Ключи API» → «Выпустить ключ». Отметьте, что ключу разрешено, — права те же одиннадцать, что и у совместного доступа.
Ключ показывается один раз: у нас хранится только его отпечаток. Потеряли — выпустите новый и отзовите старый.
Ключ передаётся заголовком Authorization: Bearer mhk_live_....
Методы
Базовый адрес — https://millida.net/v2/hosting/api.
| Метод | Что делает | Нужное право |
|---|---|---|
GET /server | Карточка сервера | консоль |
GET /status | Статус и онлайн | консоль |
POST /start | Запустить | запуск |
POST /stop | Остановить | запуск |
POST /restart | Перезапустить | запуск |
POST /command | Команда в консоль | консоль |
GET /console | Живой лог (SSE) | консоль |
GET /files?path= | Список файлов | файлы |
GET /backups | Список копий | копии |
POST /backups | Создать копию | копии |
Пример: поднять сервер и дождаться онлайна
KEY="mhk_live_xxx"
API="https://millida.net/v2/hosting/api"
curl -sX POST "$API/start" -H "Authorization: Bearer $KEY"
until curl -s "$API/status" -H "Authorization: Bearer $KEY" | grep -q RUNNING; do
sleep 5
done
echo "сервер онлайн"
Живая консоль
GET /console отдаёт поток Server-Sent Events: каждая строка приходит с префиксом data:. Вебсокет не нужен — SSE проходит через любой прокси.
Что стоит знать
- Каждое действие ключа попадает в журнал сервера автором «API-ключ N». Это ровно то, что нужно, когда серверами рулят и люди, и боты.
- Ограничение частоты считается по ключу, а не по адресу: смена IP лимит не обходит, а сосед по офисной сети его не расходует. Оно щедрое для нормальной автоматизации, но опрос статуса раз в секунду в него упрётся — достаточно раз в 10–15 секунд. Стрим консоли открывается до десяти раз в минуту: держите одно соединение, а не открывайте новое на каждое сообщение.
- Ключ перестаёт работать сразу, если сервер приостановлен или тариф больше не «Свой проект». Отзывать его руками для этого не нужно.
- Ключей на сервер до пяти. Отзывайте ненужные.