Bangun dengan MurmurHost API.
API REST melalui HTTPS, JSON masuk / JSON keluar, autentikasi token pembawa. Menyediakan VPS, mengelola layanan, daftar paket, menelan webhook. Dirancang untuk menjadi ergonomis dari satu baris Bash atau klien HTTP modern apa pun.
URL Dasar
https://api.murmurhost.com/v1Mulai cepat
Sediakan VPS pertama Anda melalui API dalam 4 baris curl.
Buat kunci API di panel klien Anda
Buka /client/settings → Kunci API → Buat. Kunci ditampilkan sekali; simpan dengan aman.
Daftar paket yang tersedia
curl https://api.murmurhost.com/v1/plans \
-H "Authorization: Bearer sh_live_••••••••"Menyebarkan VPS-2 di Islandia
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"
}'Bayar faktur dan terima kredensial melalui webhook
{
"id": "srv_3a8f2d6e",
"status": "pending_payment",
"invoice": "inv_91f7cb01",
"pay_url": "https://oxapay.com/pay/12345",
"webhook_event": "service.provisioned"
}Autentikasi
Token pembawa yang dibatasi per kunci. Tanpa OAuth, tanpa masalah JWT, tanpa tarian penandatanganan.
Format kunci API
Kunci adalah string acak 48 karakter dengan awalan sh_live_ untuk produksi dan sh_test_ untuk sandbox. Lewati melalui Otorisasi: Bearer ... header.
Cakupan
Setiap kunci membawa satu atau lebih cakupan: services:read, services:write, billing:read, billing:write, tickets:write. Hasilkan kunci dengan hak istimewa paling rendah untuk CI / Terraform / skrip.
Apa yang terjadi pada skala
Batas bawaan: 60 permintaan/menit per kunci API pada endpoint baca, 20/menit pada titik akhir tulis. Kapasitas burst adalah 2× kondisi stabil.
Header pada setiap respons: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. Ketika Anda mencapai batas, API mengembalikan 429 Terlalu Banyak Permintaan dengan Retry-After header yang menunjukkan detik untuk menunggu.
Batas yang lebih tinggi tersedia untuk kasus penggunaan produksi yang terverifikasi — dasbor reseller, armada CI, alat pemantauan. Email [email protected] dengan RPS yang diharapkan dan alasannya.
Amplop kesalahan
Setiap respons non-2xx memiliki bentuk yang sama sehingga pustaka klien dapat bercabang dengan bersih.
{ "error": { "code": "service_not_found", "message": "Layanan srv_3a8f2d6e tidak ada atau tidak dimiliki oleh akun ini.", "param": "id", "request_id": "req_8c9c11ef" } }Kode umum: invalid_request, authentication_failed, forbidden, not_found, rate_limit_exceeded, insufficient_funds, plan_unavailable, location_unavailable, internal_error. Selalu sertakan request_id saat menghubungi dukungan — ini cara tercepat untuk [email protected] untuk menemukan entri log yang cocok.
API Layanan
Sediakan, daftar, perbarui, batalkan, reboot, snapshot, migrasi.
services
/v1/servicesDaftar semua layanan yang dimiliki oleh akun yang diautentikasi.
/v1/servicesSediakan VPS / RDP / server khusus baru.
/v1/services/{id}Ambil satu layanan berdasarkan id.
/v1/services/{id}Perbarui layanan (ubah nama, ubah perpanjangan otomatis, lampirkan tambahan).
/v1/services/{id}Batalkan dan hancurkan layanan. Pengembalian dana berlaku jika dalam periode 7 hari.
/v1/services/{id}/rebootReboot keras atau lunak pada layanan yang berjalan.
/v1/services/{id}/snapshotBuat snapshot manual. Mengembalikan id snapshot.
/v1/services/{id}/migrateMigrasikan layanan ke yurisdiksi yang berbeda. Migrasi langsung jika didukung.
API Lokasi
Hanya baca — daftar 8 yurisdiksi, dapatkan kapasitas per lokasi.
/v1/locationsDaftar 8 yurisdiksi pusat data dan kapasitas saat ini.
/v1/locations/{slug}Detail untuk satu yurisdiksi: postur hukum, operator, sertifikasi, ping waktu nyata dari IP Anda.
API Paket
Katalog lengkap 35 paket. Harga, spesifikasi, dan kompatibilitas tambahan.
/v1/plansDaftar semua 35 paket di 11 kategori produk.
/v1/plans/{slug}Detail untuk satu paket: spesifikasi lengkap, harga per siklus, ketersediaan per lokasi, tambahan yang direkomendasikan.
/v1/categoriesDaftarkan 11 kategori produk dengan metadata ringkasan.
API penagihan & faktur
Daftar faktur, ambil PDF, bayar faktur terbuka melalui Card2Crypto atau OxaPay.
/v1/invoicesDaftar semua faktur untuk akun yang diautentikasi.
/v1/invoices/{id}Ambil satu faktur dengan item baris.
/v1/invoices/{id}/payMulai pembayaran untuk faktur terbuka. Mengembalikan URL pembayaran (Card2Crypto atau OxaPay).
/v1/invoices/{id}/pdfUnduh PDF faktur untuk akuntansi.
Berlangganan ke peristiwa siklus hidup
Konfigurasikan URL webhook sekali; terima POST yang ditandatangani HMAC-SHA256 untuk setiap peristiwa yang relevan.
Memverifikasi tanda tangan
Setiap webhook membawa X-MurmurHost-Tanda tangan header — HMAC-SHA256 dari badan permintaan mentah menggunakan rahasia webhook Anda. Verifikasi sebelum memproses.
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"), ); }Acara
service.provisionedMemicu ketika layanan selesai penyediaan dan kredensial dikirim.
service.suspendedMemicu pada penangguhan (tidak membayar, pelanggaran AUP, permintaan pelanggan).
service.cancelledMemicu pada pembatalan permanen. Layanan dihancurkan dalam 60 detik.
invoice.createdTerpicu saat faktur baru dibuat (biasanya saat perpanjangan).
invoice.paidMenyala setelah pembayaran berhasil. Termasuk payment_method (kartu / kripto) dan txid.
invoice.failedTerpicu ketika upaya pembayaran gagal atau kedaluwarsa.
ticket.repliedTerpicu ketika anggota tim dukungan membalas salah satu tiket Anda.
incident.publishedTerpicu ketika insiden halaman status yang memengaruhi layanan Anda dipublikasikan.
SDK dan CLI
API adalah HTTP biasa — klien apa pun berfungsi. Kami juga menerbitkan SDK Node, SDK Go, dan CLI hostctl.
@silenthosts/sdk (Node.js)
npm install @silenthosts/sdk · Berbasis TypeScript, respons yang sepenuhnya diketik, payload tervalidasi Zod.
murmurhost-go (Go)
go get github.com/murmurhost/go · Sadar konteks, bertipe generik, tanpa dependensi tambahan.
hostctl (CLI)
brew install murmurhost/tap/hostctl · Sebarkan, periksa, reboot, migrasikan dari terminal Anda.
Penyedia Terraform — hadir Q3 2026
Resmi murmurhost/murmurhost Penyedia Terraform ada di peta jalan. Daftar untuk akses awal.
Beta publik
API dalam beta publik mulai Q2 2026
Endpoint yang didokumentasikan di atas stabil dan tidak akan rusak dalam namespace v1. Perubahan yang merusak dikirim sebagai v2 dengan jendela penghentian minimal 6 bulan. Menemukan bug? Buka tiket dari /client/tickets/new dengan request_id dari respons yang gagal.
Sebarkan server lepas pantai pertama Anda dalam 60 detik.
Pendaftaran anonim. Bitcoin & Monero diterima. Disediakan di 8 yurisdiksi.
Tidak perlu kartu kredit · Jaminan uang kembali 7 hari