빠른 시작
curl 4줄로 API를 통해 첫 VPS를 배포하세요.
클라이언트 패널에서 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"
}인증
키별로 범위가 지정된 베어러 토큰. OAuth, JWT 꼼수, 서명 절차가 없습니다.
API 키 형식
키는 접두사가 붙은 48자리 랜덤 문자열입니다 sh_live_ 프로덕션 및 sh_test_ 샌드박스용. 다음을 통해 전달 인증: Bearer ... 헤더.
범위
각 키는 하나 이상의 범위를 포함합니다: services:read, services:write, billing:read, billing:write, tickets:write. CI / Terraform / 스크립트용 최소 권한 키를 생성합니다.
규모에서 발생하는 일
기본 한도: 60 요청/분 읽기 엔드포인트에서 API 키당, 20/분 쓰기 엔드포인트에서. 버스트 용량은 정상 상태의 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수동 스냅샷을 생성합니다. 스냅샷 ID를 반환합니다.
/v1/services/{id}/migrate서비스를 다른 관할권으로 마이그레이션. 지원되는 경우 라이브 마이그레이션.
위치 API
읽기 전용 — 8개 관할권을 나열하고 위치별 용량을 확인합니다.
/v1/locations8개 데이터 센터 관할권과 현재 용량을 나열합니다.
/v1/locations/{slug}한 관할권에 대한 세부 정보: 법적 태세, 캐리어, 인증, 사용자 IP에서의 실시간 핑.
Plans API
전체 35개 요금제 카탈로그. 가격, 사양, 애드온 호환성.
/v1/plans11개 제품 카테고리의 35개 요금제를 모두 나열하세요.
/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을 한 번 구성하면 관련 이벤트마다 HMAC-SHA256 서명된 POST를 수신합니다.
서명 확인 중
모든 웹훅은 다음을 포함합니다 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정지 시 발생(미결제, 이용 약관 위반, 고객 요청).
service.cancelled하드 취소 시 발생. 서비스는 60초 이내에 해체됩니다.
invoice.created새 인보이스가 생성될 때 (일반적으로 갱신 시) 발생합니다.
invoice.paid성공적인 결제 시 실행됩니다. payment_method(카드/암호화폐) 및 txid를 포함합니다.
invoice.failed결제 시도가 실패하거나 만료될 때 발생합니다.
ticket.replied지원 팀원이 티켓 중 하나에 답변할 때 발생합니다.
incident.published서비스에 영향을 미치는 상태 페이지 인시던트가 게시될 때 트리거됩니다.
SDK 및 CLI
API는 일반 HTTP입니다 — 모든 클라이언트가 작동합니다. 또한 Node SDK, Go SDK 및 hostctl CLI를 게시합니다.
@silenthosts/sdk (Node.js)
npm install @silenthosts/sdk · TypeScript 우선, 완전히 타입화된 응답, Zod 검증 페이로드.
murmurhost-go (Go)
go get github.com/murmurhost/go · 컨텍스트 인식, 제네릭 타입, 추가 종속성 없음.
hostctl (CLI)
brew install murmurhost/tap/hostctl · 터미널에서 배포, 검사, 재부팅, 마이그레이션.
Terraform 프로바이더 — 2026년 3분기 출시 예정
공식 murmurhost/murmurhost Terraform 프로바이더는 로드맵에 있습니다. 얼리 액세스에 등록하세요.
공개 베타
API는 2026년 2분기부터 공개 베타 버전입니다
위에 문서화된 엔드포인트는 안정적이며 v1 네임스페이스 내에서 깨지지 않습니다. 주요 변경 사항은 최소 6개월의 폐기 기간을 두고 v2로 제공됩니다. 버그를 찾으셨나요? 티켓을 열어주세요. /client/tickets/new 실패한 응답의 request_id와 함께.