Створюйте з 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-ключ для read-ендпоінтів, 20/хв на write-ендпоінтах. Пікова ємність — 2× стабільного стану.
Заголовки у кожній відповіді: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. Коли ви досягаєте ліміту, API повертає 429 Забагато запитів з 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 для кожної відповідної події.
Перевірка підписів
Кожен вебхук несе 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 (картка / крипто) та 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, повністю типізовані відповіді, перевірені за допомогою Zod.
murmurhost-go (Go)
go get github.com/murmurhost/go · Контекстно-залежний, з типізацією generics, без додаткових залежностей.
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 днів