İle oluşturun MurmurHost API.
HTTPS üzerinden REST API, JSON giriş / JSON çıkış, taşıyıcı belirteç kimlik doğrulaması. VPS sağlama, hizmetleri yönetme, planları listeleme, webhook'ları alma. Bash tek satırlık veya herhangi bir modern HTTP istemcisinden ergonomik olacak şekilde tasarlanmıştır.
Temel URL
https://api.murmurhost.com/v1Hızlı başlangıç
İlk VPS'inizi API ile 4 satır curl'de dağıtın.
İstemci panelinizde bir API anahtarı oluşturun
Aç /client/settings → API anahtarları → Oluştur. Anahtarlar yalnızca bir kez gösterilir; güvenli şekilde saklayın.
Mevcut planları listele
curl https://api.murmurhost.com/v1/plans \
-H "Authorization: Bearer sh_live_••••••••"İzlanda'da bir VPS-2 sağla
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"
}'Faturayı ödeyin ve kimlik bilgilerini webhook ile alın
{
"id": "srv_3a8f2d6e",
"status": "pending_payment",
"invoice": "inv_91f7cb01",
"pay_url": "https://oxapay.com/pay/12345",
"webhook_event": "service.provisioned"
}Kimlik doğrulama
Anahtar başına kapsamlı taşıyıcı belirteçleri. OAuth yok, JWT hileleri yok, imza dansı yok.
API anahtarı biçimi
Anahtarlar, öneki olan 48 karakterlik rastgele dizelerdir sh_live_ üretim ve sh_test_ sandbox için. Şuradan geçir: Yetkilendirme: Bearer ... başlık.
Kapsamlar
Her anahtar bir veya daha fazla kapsam taşır: services:read, services:write, billing:read, billing:write, tickets:write. CI / Terraform / scriptler için en az ayrıcalıklı anahtarlar üretin.
Ölçekte ne olur
Varsayılan sınır: 60 istek/dakika okuma uç noktalarında API anahtarı başına, 20/dakika yazma uç noktalarında. Patlama kapasitesi kararlı durumun 2 katıdır.
Her yanıtta başlıklar: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. Sınıra ulaştığınızda, API döndürür 429 Çok Fazla İstek ile bir Retry-After bekleme süresini gösteren başlık.
Doğrulanmış üretim kullanım durumları için daha yüksek limitler mevcuttur — bayii panoları, CI filoları, izleme araçları. E-posta [email protected] beklenen RPS'niz ve gerekçesiyle.
Hata zarfı
2xx olmayan her yanıt aynı şekle sahiptir, böylece istemci kitaplıkları temiz bir şekilde dallanabilir.
{ "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" } }Yaygın kodlar: invalid_request, authentication_failed, forbidden, not_found, rate_limit_exceeded, insufficient_funds, plan_unavailable, location_unavailable, internal_error. Her zaman ekleyin request_id destekle iletişime geçerken — bu en hızlı yoldur [email protected] eşleşen günlük kaydını bulmak için.
Hizmetler API'si
Sağla, listele, güncelle, iptal et, yeniden başlat, anlık görüntü al, taşı.
services
/v1/servicesKimliği doğrulanmış hesabın sahip olduğu tüm hizmetleri listele.
/v1/servicesYeni bir VPS / RDP / dedicated server sağlayın.
/v1/services/{id}Bir hizmeti kimliğe göre alın.
/v1/services/{id}Bir hizmeti güncelle (yeniden adlandır, otomatik yenilemeyi değiştir, eklentiler ekle).
/v1/services/{id}Bir hizmeti iptal edin ve kaldırın. 7 günlük süre içindeyse iade uygulanır.
/v1/services/{id}/rebootÇalışan bir hizmeti sert veya yumuşak yeniden başlatın.
/v1/services/{id}/snapshotManuel anlık görüntü oluşturun. Anlık görüntü kimliğini döndürür.
/v1/services/{id}/migrateBir hizmeti farklı bir yetki alanına taşıyın. Desteklenen yerlerde canlı taşıma.
Konumlar API'si
Salt okunur — 8 yetki alanını listele, konum başına kapasite al.
/v1/locations8 veri merkezi yetki alanını ve mevcut kapasitelerini listeleyin.
/v1/locations/{slug}Bir yetki alanı için ayrıntı: yasal duruş, taşıyıcılar, sertifikalar, IP'nizden gerçek zamanlı ping.
Planlar API'si
35 planlık tam katalog. Fiyatlandırma, özellikler ve ek hizmet uyumluluğu.
/v1/plans11 ürün kategorisindeki 35 planın tamamını listeleyin.
/v1/plans/{slug}Bir plan için ayrıntı: tam özellikler, döngü başına fiyatlandırma, konum başına kullanılabilirlik, önerilen ek hizmetler.
/v1/categoriesÖzet meta verileriyle 11 ürün kategorisini listeleyin.
Faturalandırma ve fatura API'si
Faturaları listeleyin, PDF'leri alın, açık faturaları Card2Crypto veya OxaPay ile ödeyin.
/v1/invoicesKimliği doğrulanmış hesap için tüm faturaları listele.
/v1/invoices/{id}Satır öğeleriyle tek bir fatura alın.
/v1/invoices/{id}/payAçık bir fatura için ödeme başlatın. Bir ödeme URL'si döndürür (Card2Crypto veya OxaPay).
/v1/invoices/{id}/pdfMuhasebe için fatura PDF'ini indirin.
Yaşam döngüsü olaylarına abone ol
Webhook URL'sini bir kez yapılandırın; ilgili her olay için HMAC-SHA256 imzalı POST'lar alın.
İmzalar doğrulanıyor
Her webhook bir X-MurmurHost-İmza header — webhook sırrınızı kullanarak ham istek gövdesinin HMAC-SHA256'sı. İşlemeden önce doğrulayın.
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"), ); }Olaylar
service.provisionedBir hizmet sağlama işlemi tamamlandığında ve kimlik bilgileri gönderildiğinde tetiklenir.
service.suspendedAskıya alma durumunda tetiklenir (ödeme yapılmaması, AUP ihlali, müşteri talebi).
service.cancelledKalıcı iptalde tetiklenir. Hizmet 60 saniye içinde kaldırılır.
invoice.createdYeni bir fatura oluşturulduğunda tetiklenir (genellikle yenilemede).
invoice.paidBaşarılı ödemede tetiklenir. payment_method (kart / kripto) ve txid içerir.
invoice.failedBir ödeme denemesi başarısız olduğunda veya süresi dolduğunda tetiklenir.
ticket.repliedDestek ekibi üyesi taleplerinizden birine yanıt verdiğinde tetiklenir.
incident.publishedHizmetlerinizi etkileyen bir durum sayfası olayı yayınlandığında tetiklenir.
SDK'ler ve CLI
API düz HTTP'dir — herhangi bir istemci çalışır. Ayrıca bir Node SDK, bir Go SDK ve bir hostctl CLI yayınlıyoruz.
@silenthosts/sdk (Node.js)
npm install @silenthosts/sdk · TypeScript öncelikli, tamamen tipli yanıtlar, Zod doğrulamalı yükler.
murmurhost-go (Go)
go get github.com/murmurhost/go · Bağlam duyarlı, jeneriklerle tiplenmiş, ek bağımlılık yok.
hostctl (CLI)
brew install murmurhost/tap/hostctl · Terminalinizden dağıtın, inceleyin, yeniden başlatın, taşıyın.
Terraform sağlayıcısı — 2026 Q3'te geliyor
Resmi murmurhost/murmurhost Terraform sağlayıcısı yol haritasında. Erken erişim için kaydolun.
Genel beta
API, 2026'nın 2. çeyreği itibarıyla genel beta sürümünde
Yukarıda belgelenen uç noktalar stabildir ve v1 ad alanı içinde bozulmaz. Kırıcı değişiklikler, minimum 6 aylık kullanımdan kaldırma penceresiyle v2 olarak yayınlanır. Bir hata mı buldunuz? Şuradan bir talep açın: /client/tickets/new başarısız yanıttaki request_id ile.
İlk offshore sunucunuzu 60 saniyede dağıtın.
Anonim kayıt. Bitcoin ve Monero kabul edilir. 8 yetki alanında sağlanır.
Kredi kartı gerekmez · 7 gün para iade garantisi