Разработчикам

REST API

У каждого действия в панели есть эндпоинт. Создайте токен, отправляйте JSON и получайте JSON в ответ.

Основное

Базовый URL: https://api.bulutera.cloud/v1
Авторизация: Authorization: Bearer YOUR_TOKEN — токены создаются в панели в разделе Developer → API Keys («Разработчикам → API-ключи»)
Токены: До 10 на аккаунт, отозвать можно в любой момент
Лимит запросов: 120 запросов в минуту на аккаунт
Оплата: Серверы, заказанные через API, оплачиваются с вашего кошелька
Заголовки: Отправляйте Accept: application/json и собственный User-Agent

Список тарифов

При заказе используйте id тарифа.

curl https://api.bulutera.cloud/v1/plans \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json" \
  -H "User-Agent: my-app/1.0"

Создание сервера

Пароль root должен содержать 8–12 символов, включая строчную букву, заглавную букву, цифру и один из символов ! # + $ * -.

curl -X POST https://api.bulutera.cloud/v1/servers \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "User-Agent: my-app/1.0" \
  -d '{"plan_id": 17, "os_id": 5, "label": "web-1", "root_password": "Str0ng#Pass"}'

Эндпоинты

Аккаунт и каталог

GET	/v1/account	Ваш аккаунт, баланс и скидка реселлера
GET	/v1/plans	Тарифы в продаже, с ценами
GET	/v1/os	Операционные системы, доступные для установки

Серверы

GET	/v1/servers	Список ваших серверов
POST	/v1/servers	Создать сервер
GET	/v1/servers/{id}	Данные сервера
PATCH	/v1/servers/{id}	Переименовать сервер
DELETE	/v1/servers/{id}	Отменить сервер; неиспользованное время возвращается на кошелёк
POST	/v1/servers/{id}/start	Запустить
POST	/v1/servers/{id}/stop	Остановить
POST	/v1/servers/{id}/restart	Перезагрузить
POST	/v1/servers/{id}/rebuild	Переустановить с другой системой
POST	/v1/servers/{id}/reset-password	Задать новый пароль root
POST	/v1/servers/{id}/request-ip-change	Запросить замену IP (Стамбул)
GET	/v1/servers/{id}/upgrade-options	Тарифы, на которые можно перейти с этого сервера
POST	/v1/servers/{id}/upgrade	Перейти на тариф побольше
POST	/v1/servers/{id}/vnc	Открыть сеанс консоли в браузере

Кошелёк и счета

GET	/v1/wallet	Баланс кошелька
GET	/v1/wallet/transactions	Операции по кошельку
GET	/v1/invoices	Список счетов
GET	/v1/invoices/{id}	Данные счёта

Тикеты поддержки

GET	/v1/tickets	Список тикетов
POST	/v1/tickets	Открыть тикет
GET	/v1/tickets/{id}	Тикет со всеми сообщениями
POST	/v1/tickets/{id}/reply	Ответить в тикете
POST	/v1/tickets/{id}/close	Закрыть тикет

Ошибки

401 Unauthenticated

Токен неверный или был отозван. Создайте новый в разделе Developer → API Keys.

403 с ошибкой 1010

Ваша HTTP-библиотека отправляет стандартный User-Agent, который блокирует наш файрвол (Python urllib, Perl LWP). Укажите собственный заголовок User-Agent или используйте requests или httpx.

422 Unprocessable

Одно из полей некорректно; в JSON-ответе перечислено каждое поле и причина.

429 Too Many Requests

Вы превысили 120 запросов в минуту. Подождите и повторите запрос.

Продаёте через WHMCS?

Наш бесплатный модуль работает с этим API за вас.

Модуль WHMCS