v1 · Publieke bèta

Bouw met de MurmurHost API.

Een REST API over HTTPS, JSON in / JSON uit, bearer-token-authenticatie. Provision VPS, beheer services, lijst plannen, verwerk webhooks. Ontworpen om ergonomisch te zijn vanuit een Bash-one-liner of elke moderne HTTP-client.

Quickstart API-sleutel verkrijgen

Basis-URL

https://api.murmurhost.com/v1

60 seconden binnen

Quickstart

Deploy je eerste VPS via API in 4 regels curl.

Genereer een API-sleutel in je klantenpaneel

Open /client/settings → API-sleutels → Genereren. Sleutels worden één keer getoond; bewaar ze veilig.

Toon beschikbare plannen

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

Provision een VPS-2 in IJsland

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

Betaal de factuur en ontvang inloggegevens via webhook

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

Auth

Authenticatie

Bearer tokens gescoped per sleutel. Geen OAuth, geen JWT-gedoe, geen ondertekeningsdans.

API-sleutelformaat

Sleutels zijn 48-tekens willekeurige strings met voorvoegsel sh_live_ voor productie en sh_test_ voor sandbox. Geef door via Authorization: Bearer ... header.

Scopes

Elke sleutel heeft een of meer scopes: services:read, services:write, billing:read, billing:write, tickets:write. Genereer least-privilege sleutels voor CI / Terraform / scripts.

Rate limits

Wat gebeurt er op schaal

Standaardlimiet: 60 verzoeken/minuut per API-sleutel op lees-endpoints, 20/minuut op schrijf-endpoints. Burstcapaciteit is 2× steady-state.

Headers op elk antwoord: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. Wanneer je de limiet bereikt, retourneert de API 429 Too Many Requests met een Retry-After header die seconden om te wachten aangeeft.

Hogere limieten zijn beschikbaar voor geverifieerde productie-use cases — reseller-dashboards, CI-fleets, monitoring-tooling. E-mail [email protected] met je verwachte RPS en de onderbouwing.

Fouten

Foutomhulling

Elke niet-2xx-respons heeft dezelfde vorm, zodat clientbibliotheken netjes kunnen vertakken.

{ "error": { "code": "service_not_found", "message": "Service srv_3a8f2d6e bestaat niet of is niet eigendom van dit account.", "param": "id", "request_id": "req_8c9c11ef" } }

Veelvoorkomende codes: invalid_request, authentication_failed, forbidden, not_found, rate_limit_exceeded, insufficient_funds, plan_unavailable, location_unavailable, internal_error. Altijd vermelden request_id bij contact met support — het is de snelste manier voor [email protected] om het overeenkomende logboekitem te vinden.

Endpoints

Services API

Provisionen, lijsten, updaten, annuleren, rebooten, snapshotten, migreren.

services

GET

/v1/services

Lijst alle services die eigendom zijn van het geverifieerde account.

POST

/v1/services

Provision een nieuwe VPS / RDP / dedicated server.

GET

/v1/services/{id}

Haal een enkele service op via id.

PATCH

/v1/services/{id}

Een service bijwerken (hernoemen, autorenewal wijzigen, add-ons toevoegen).

DELETE

/v1/services/{id}

Annuleer en verwijder een service. Restitutie geldt als het binnen de 7 dagen valt.

POST

/v1/services/{id}/reboot

Hard of soft reboot van een draaiende service.

POST

/v1/services/{id}/snapshot

Maak een handmatige snapshot. Retourneert de snapshot-id.

POST

/v1/services/{id}/migrate

Migreer een dienst naar een andere jurisdictie. Live-migratie waar ondersteund.

Endpoints

Locaties-API

Alleen-lezen — vermeld de 8 jurisdicties, krijg capaciteit per locatie.

GET

/v1/locations

Vermeld de 8 datacenterjurisdicties en hun huidige capaciteit.

GET

/v1/locations/{slug}

Detail voor één jurisdictie: juridische houding, carriers, certificeringen, real-time ping vanaf je IP.

Endpoints

Plannen API

De volledige catalogus van 35 plannen. Prijzen, specificaties en add-on-compatibiliteit.

GET

/v1/plans

Lijst alle 35 plannen in de 11 productcategorieën.

GET

/v1/plans/{slug}

Detail voor één plan: volledige specificaties, prijzen per cyclus, beschikbaarheid per locatie, aanbevolen add-ons.

GET

/v1/categories

Lijst de 11 productcategorieën met samenvattende metadata.

Endpoints

Facturatie- en factuur-API

Facturen weergeven, PDF's ophalen, openstaande facturen betalen via Card2Crypto of OxaPay.

GET

/v1/invoices

Lijst alle facturen voor het geverifieerde account.

GET

/v1/invoices/{id}

Haal een enkele factuur op met regelitems.

POST

/v1/invoices/{id}/pay

Start een betaling voor een openstaande factuur. Retourneert een betaal-URL (Card2Crypto of OxaPay).

GET

/v1/invoices/{id}/pdf

Download de factuur-PDF voor de boekhouding.

Webhooks

Abonneren op lifecycle events

Configureer een webhook-URL eenmalig; ontvang HMAC-SHA256-ondertekende POSTs voor elk relevant evenement.

Handtekeningen verifiëren

Elke webhook draagt een X-MurmurHost-Handtekening header — HMAC-SHA256 van de onbewerkte aanvraagbody met je webhook-geheim. Verifieer vóór verwerking.

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

Evenementen

service.provisioned
Wordt geactiveerd wanneer een service klaar is met provisioning en inloggegevens worden verzonden.
service.suspended
Wordt geactiveerd bij opschorting (niet-betaling, AUP-overtreding, klantverzoek).
service.cancelled
Wordt geactiveerd bij harde annulering. Service wordt binnen 60 seconden afgebroken.
invoice.created
Wordt geactiveerd wanneer een nieuwe factuur wordt gegenereerd (doorgaans bij verlenging).
invoice.paid
Start bij succesvolle betaling. Inclusief payment_method (card / crypto) en txid.
invoice.failed
Wordt geactiveerd wanneer een betalingspoging faalt of verloopt.
ticket.replied
Wordt geactiveerd wanneer een supportteamlid antwoordt op een van uw tickets.
incident.published
Wordt geactiveerd wanneer een statuspagina-incident dat uw services beïnvloedt, wordt gepubliceerd.

Tooling

SDK's en CLI

De API is gewoon HTTP — elke client werkt. We publiceren ook een Node SDK, een Go SDK en een hostctl CLI.

@silenthosts/sdk (Node.js)

npm install @silenthosts/sdk · TypeScript-first, volledig getypeerde antwoorden, Zod-gevalideerde payloads.

v1.4.2

murmurhost-go (Go)

go get github.com/murmurhost/go · Contextbewust, generics-getypeerd, geen extra afhankelijkheden.

v1.2.0

hostctl (CLI)

brew install murmurhost/tap/hostctl · Deploy, inspecteer, herstart, migreer vanaf uw terminal.

v0.9.1

Terraform-provider — komt in Q3 2026

De officiële murmurhost/murmurhost Terraform-provider staat op de roadmap. Meld u aan voor vroege toegang.

Vraag vroege toegang aan

Publieke bèta

De API is in openbare bèta vanaf Q2 2026

De hierboven gedocumenteerde endpoints zijn stabiel en breken niet binnen de v1-namespace. Breaking changes worden uitgebracht als v2 met een minimale deprecatieperiode van 6 maanden. Een bug gevonden? Open een ticket vanaf /client/tickets/new met de request_id van het falende antwoord.

Deploy uw eerste offshore server in 60 seconden.

Anonieme aanmelding. Bitcoin & Monero geaccepteerd. Provisioning in 8 jurisdicties.

Aan de slag Praat met sales

Geen creditcard vereist · 7-dagen money-back garantie