Создавайте с помощью MurmurHost API.
REST API через HTTPS, JSON на входе / JSON на выходе, аутентификация по bearer-токену. Развертывание VPS, управление сервисами, список тарифов, прием вебхуков. Разработан для удобства использования из однострочного Bash или любого современного HTTP-клиента.
Базовый URL
https://api.murmurhost.com/v1Быстрый старт
Разверните свой первый VPS через API в 4 строках curl.
Сгенерируйте API-ключ в клиентской панели
Открыть /client/settings → Ключи API → Создать. Ключи показываются один раз; храните их надежно.
Список доступных тарифов
curl https://api.murmurhost.com/v1/plans \
-H "Authorization: Bearer sh_live_••••••••"Развернуть VPS-2 в Исландии
curl -X POST https://api.murmurhost.com/v1/services \
-H "Authorization: Bearer sh_live_••••••••" \
-H "Content-Type: application/json" \
-d '{
"plan": "vps-2",
"location": "iceland",
"billing_cycle": "monthly",
"addons": ["ddos-premium", "backup"],
"payment_method": "crypto"
}'Оплатите счет и получите учетные данные через вебхук
{
"id": "srv_3a8f2d6e",
"status": "pending_payment",
"invoice": "inv_91f7cb01",
"pay_url": "https://oxapay.com/pay/12345",
"webhook_event": "service.provisioned"
}Аутентификация
Bearer-токены с областью действия для каждого ключа. Никакого OAuth, никаких манипуляций с JWT, никаких танцев с подписями.
Формат API-ключа
Ключи — это случайные строки из 48 символов с префиксом sh_live_ для продакшена и sh_test_ для песочницы. Передайте через Авторизация: Bearer ... заголовок.
Области
Каждый ключ несет одну или несколько областей: services:read, services:write, billing:read, billing:write, tickets:write. Генерация ключей с минимальными привилегиями для CI / Terraform / скриптов.
Что происходит в масштабе
Лимит по умолчанию: 60 запросов/минуту на ключ API для конечных точек чтения, 20/мин на конечных точках записи. Пиковая мощность в 2 раза превышает стабильную.
Заголовки в каждом ответе: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. Когда вы достигнете лимита, API возвращает 429 Too Many Requests с Retry-After заголовок, указывающий секунды ожидания.
Более высокие лимиты доступны для проверенных производственных сценариев использования — панели реселлеров, CI-фермы, инструменты мониторинга. Электронная почта [email protected] с ожидаемым RPS и обоснованием.
Конверт ошибок
Каждый ответ, отличный от 2xx, имеет одинаковую структуру, чтобы клиентские библиотеки могли корректно обрабатывать ветвления.
{ "error": { "code": "service_not_found", "message": "Service srv_3a8f2d6e does not exist or is not owned by this account.", "param": "id", "request_id": "req_8c9c11ef" } }Общие коды: invalid_request, authentication_failed, forbidden, not_found, rate_limit_exceeded, insufficient_funds, plan_unavailable, location_unavailable, internal_error. Всегда указывайте request_id при обращении в поддержку — это самый быстрый способ [email protected] чтобы найти соответствующую запись в журнале.
API услуг
Предоставление, список, обновление, отмена, перезагрузка, снимок, миграция.
services
/v1/servicesПеречислить все сервисы, принадлежащие аутентифицированному аккаунту.
/v1/servicesПредоставьте новый VPS / RDP / выделенный сервер.
/v1/services/{id}Получить отдельную услугу по id.
/v1/services/{id}Обновить услугу (переименовать, изменить автопродление, прикрепить дополнения).
/v1/services/{id}Отмените и удалите сервис. Возврат применяется, если вы в пределах 7-дневного окна.
/v1/services/{id}/rebootЖесткая или мягкая перезагрузка работающего сервиса.
/v1/services/{id}/snapshotСоздать ручной снимок. Возвращает идентификатор снимка.
/v1/services/{id}/migrateПеренесите сервис в другую юрисдикцию. Живая миграция там, где это поддерживается.
API локаций
Только чтение — перечислите 8 юрисдикций, получите емкость по каждому местоположению.
/v1/locationsПеречислите 8 юрисдикций дата-центров и их текущую емкость.
/v1/locations/{slug}Детали по одной юрисдикции: правовой статус, операторы связи, сертификаты, пинг в реальном времени с вашего IP.
API тарифов
Полный каталог из 35 тарифов. Цены, характеристики и совместимость с дополнениями.
/v1/plansПеречислите все 35 тарифов в 11 категориях продуктов.
/v1/plans/{slug}Детали по одному тарифу: полные характеристики, цены за расчетный период, доступность по местоположениям, рекомендуемые дополнения.
/v1/categoriesПеречислите 11 категорий продуктов с сводными метаданными.
API для биллинга и счетов
Список счетов, получение PDF, оплата открытых счетов через Card2Crypto или OxaPay.
/v1/invoicesПеречислите все счета для аутентифицированного аккаунта.
/v1/invoices/{id}Получить один счет с позициями.
/v1/invoices/{id}/payИнициируйте оплату открытого счета. Возвращает URL для оплаты (Card2Crypto или OxaPay).
/v1/invoices/{id}/pdfСкачайте счет в формате PDF для бухгалтерии.
Подписаться на события жизненного цикла
Настройте URL вебхука один раз; получайте POST-запросы с HMAC-SHA256-подписью для каждого соответствующего события.
Проверка подписей
Каждый webhook несет X-MurmurHost-Подпись header — HMAC-SHA256 от исходного тела запроса с использованием вашего секрета вебхука. Проверяйте перед обработкой.
import crypto from "node:crypto"; function verify(rawBody, signature, secret) { const expected = crypto .createHmac("sha256", secret) .update(rawBody) .digest("hex"); return crypto.timingSafeEqual( Buffer.from(expected, "hex"), Buffer.from(signature, "hex"), ); }События
service.provisionedСрабатывает, когда услуга завершает предоставление и отправляются учетные данные.
service.suspendedСрабатывает при приостановке (неоплата, нарушение AUP, запрос клиента).
service.cancelledСрабатывает при полном аннулировании. Услуга удаляется в течение 60 секунд.
invoice.createdСрабатывает при создании нового счета (обычно при продлении).
invoice.paidСрабатывает после успешной оплаты. Включает payment_method (card / crypto) и txid.
invoice.failedСрабатывает, когда попытка платежа не удалась или истекла.
ticket.repliedСрабатывает, когда сотрудник поддержки отвечает на один из ваших тикетов.
incident.publishedСрабатывает, когда публикуется инцидент на странице статуса, затрагивающий ваши услуги.
SDK и CLI
API — это обычный HTTP — подойдет любой клиент. Мы также публикуем Node SDK, Go SDK и CLI hostctl.
@silenthosts/sdk (Node.js)
npm install @silenthosts/sdk · TypeScript-first, полностью типизированные ответы, полезные нагрузки, проверенные Zod.
murmurhost-go (Go)
go get github.com/murmurhost/go · Контекстно-зависимый, с типизацией через дженерики, без лишних зависимостей.
hostctl (CLI)
brew install murmurhost/tap/hostctl · Развертывайте, проверяйте, перезагружайте, мигрируйте из вашего терминала.
Провайдер Terraform — ожидается в Q3 2026
Официальный murmurhost/murmurhost Провайдер Terraform в планах. Подпишитесь на ранний доступ.
Публичная бета
API находится в открытой бете с Q2 2026
Конечные точки, описанные выше, стабильны и не сломаются в пространстве имен v1. Критические изменения выпускаются как v2 с минимальным периодом устаревания 6 месяцев. Нашли ошибку? Откройте тикет из /client/tickets/new с request_id из ответа об ошибке.
Разверните свой первый оффшорный сервер за 60 секунд.
Анонимная регистрация. Принимаются Bitcoin и Monero. Предоставление в 8 юрисдикциях.
Кредитная карта не требуется · 7-дневная гарантия возврата денег