v1 · Beta pubblica

Costruisci con il MurmurHost API.

Una REST API su HTTPS, JSON in / JSON out, autenticazione con bearer token. Provisioning di VPS, gestione servizi, elenco piani, ingestione webhook. Progettata per essere ergonomica da una riga di comando Bash o qualsiasi client HTTP moderno.

Avvio rapido Ottieni una chiave API

URL di base

https://api.murmurhost.com/v1

60 secondi

Avvio rapido

Esegui il provisioning del tuo primo VPS tramite API in 4 righe di curl.

Genera una chiave API nel tuo pannello clienti

Apri /client/settings → Chiavi API → Genera. Le chiavi vengono mostrate una volta; conservale in modo sicuro.

Elenca i piani disponibili

curl https://api.murmurhost.com/v1/plans \
  -H "Authorization: Bearer sh_live_••••••••"

Provision di un VPS-2 in Islanda

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"
  }'

Paga la fattura e ricevi le credenziali via webhook

{
  "id": "srv_3a8f2d6e",
  "status": "pending_payment",
  "invoice": "inv_91f7cb01",
  "pay_url": "https://oxapay.com/pay/12345",
  "webhook_event": "service.provisioned"
}

Auth

Autenticazione

Token Bearer con ambito per chiave. Niente OAuth, niente trucchi JWT, niente danza di firma.

Formato chiave API

Le chiavi sono stringhe casuali di 48 caratteri con prefisso sh_live_ per la produzione e sh_test_ per sandbox. Passa tramite Autorizzazione: Bearer ... intestazione.

Scopes

Ogni chiave porta uno o più ambiti: servizi:lettura, services:write, billing:read, fatturazione:scrittura, ticket:scrittura. Genera chiavi con privilegi minimi per CI / Terraform / script.

Limiti di velocità

Cosa succede su larga scala

Limite predefinito: 60 richieste/minuto per chiave API sugli endpoint di lettura, 20/minuto sugli endpoint di scrittura. La capacità di burst è 2× lo stato stazionario.

Header su ogni risposta: X-RateLimit-Limit, X-RateLimit-Rimanente, X-RateLimit-Reset. Quando raggiungi il limite, l'API restituisce 429 Troppe Richieste con un Retry-After header che indica i secondi di attesa.

Limiti più elevati disponibili per casi d'uso di produzione verificati — dashboard rivenditore, flotte CI, strumenti di monitoraggio. Email [email protected] con il tuo RPS previsto e la motivazione.

Errori

Envelope di errore

Ogni risposta non-2xx ha la stessa forma, così le librerie client possono ramificarsi in modo pulito.

{ "error": { "code": "service_not_found", "message": "Il servizio srv_3a8f2d6e non esiste o non è di proprietà di questo account.", "param": "id", "request_id": "req_8c9c11ef" } }

Codici comuni: invalid_request, authentication_failed, forbidden, not_found, rate_limit_exceeded, insufficient_funds, plan_unavailable, location_unavailable, internal_error. Includi sempre request_id quando contatti il supporto — è il modo più veloce per [email protected] per trovare la voce di log corrispondente.

Endpoint

API dei servizi

Provisioning, elenco, aggiornamento, cancellazione, reboot, snapshot, migrazione.

services

GET

/v1/services

Elenca tutti i servizi posseduti dall'account autenticato.

POST

/v1/services

Provisioning di un nuovo VPS / RDP / server dedicato.

GET

/v1/services/{id}

Recupera un singolo servizio tramite id.

PATCH

/v1/services/{id}

Aggiorna un servizio (rinomina, cambia rinnovo automatico, allega componenti aggiuntivi).

DELETE

/v1/services/{id}

Annulla e smantella un servizio. Il rimborso si applica se entro il periodo di 7 giorni.

POST

/v1/services/{id}/reboot

Riavvio hard o soft di un servizio in esecuzione.

POST

/v1/services/{id}/snapshot

Crea uno snapshot manuale. Restituisce l'id dello snapshot.

POST

/v1/services/{id}/migrate

Migra un servizio in una giurisdizione diversa. Migrazione live dove supportata.

Endpoint

API delle posizioni

Sola lettura — elenca le 8 giurisdizioni, ottieni la capacità per località.

GET

/v1/locations

Elenca le 8 giurisdizioni dei data center e la loro capacità attuale.

GET

/v1/locations/{slug}

Dettaglio per una giurisdizione: posizione legale, carrier, certificazioni, ping in tempo reale dal tuo IP.

Endpoint

API piani

Il catalogo completo di 35 piani. Prezzi, specifiche e compatibilità con i componenti aggiuntivi.

GET

/v1/plans

Elenca tutti i 35 piani nelle 11 categorie di prodotti.

GET

/v1/plans/{slug}

Dettaglio per un piano: specifiche complete, prezzi per ciclo, disponibilità per località, componenti aggiuntivi consigliati.

GET

/v1/categories

Elenca le 11 categorie di prodotti con metadati di riepilogo.

Endpoint

API di fatturazione e fatture

Elenca le fatture, recupera i PDF, paga le fatture aperte tramite Card2Crypto o OxaPay.

GET

/v1/invoices

Elenca tutte le fatture per l'account autenticato.

GET

/v1/invoices/{id}

Recupera una singola fattura con le voci.

POST

/v1/invoices/{id}/pay

Avvia il pagamento per una fattura aperta. Restituisce un URL di pagamento (Card2Crypto o OxaPay).

GET

/v1/invoices/{id}/pdf

Scarica il PDF della fattura per la contabilità.

Webhook

Iscriviti agli eventi del ciclo di vita

Configura un URL webhook una volta; ricevi POST firmati HMAC-SHA256 per ogni evento rilevante.

Verifica delle firme

Ogni webhook trasporta un X-MurmurHost-Firma header — HMAC-SHA256 del corpo della richiesta grezza usando il tuo segreto webhook. Verifica prima di elaborare.

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"), ); }

Eventi

service.provisioned
Si attiva quando un servizio completa il provisioning e vengono inviate le credenziali.
service.suspended
Si attiva in caso di sospensione (mancato pagamento, violazione dell'informativa sull'uso accettabile, richiesta del cliente).
service.cancelled
Si attiva in caso di cancellazione definitiva. Il servizio viene smantellato entro 60 secondi.
invoice.created
Si attiva quando viene generata una nuova fattura (tipicamente al rinnovo).
invoice.paid
Si attiva al pagamento riuscito. Include payment_method (card / crypto) e txid.
invoice.failed
Si attiva quando un tentativo di pagamento fallisce o scade.
ticket.replied
Si attiva quando un membro del team di supporto risponde a uno dei tuoi ticket.
incident.published
Si attiva quando viene pubblicato un incidente sulla pagina di stato che interessa i tuoi servizi.

Strumenti

SDK e CLI

L'API è HTTP semplice — qualsiasi client funziona. Pubblichiamo anche un SDK Node, un SDK Go e una CLI hostctl.

@silenthosts/sdk (Node.js)

npm install @silenthosts/sdk · TypeScript-first, risposte completamente tipizzate, payload validati con Zod.

v1.4.2

murmurhost-go (Go)

go get github.com/murmurhost/go · Context-aware, tipizzato con generics, nessuna dipendenza extra.

v1.2.0

hostctl (CLI)

brew install murmurhost/tap/hostctl · Deploy, ispeziona, riavvia, migra dal tuo terminale.

v0.9.1

Provider Terraform — in arrivo nel terzo trimestre 2026

L'ufficiale murmurhost/murmurhost Il provider Terraform è nella roadmap. Registrati per l'accesso anticipato.

Richiedi accesso anticipato

Beta pubblica

L'API è in beta pubblica a partire dal Q2 2026

Gli endpoint documentati sopra sono stabili e non si romperanno nel namespace v1. Le modifiche breaking vengono rilasciate come v2 con una finestra di deprecazione minima di 6 mesi. Trovato un bug? Apri un ticket da /client/tickets/new con il request_id dalla risposta fallita.

Deploy del tuo primo server offshore in 60 secondi.

Registrazione anonima. Bitcoin e Monero accettati. Provisioning in 8 giurisdizioni.

Per iniziare Parla con le vendite

Nessuna carta di credito richiesta · Garanzia di rimborso di 7 giorni