ابنِ باستخدام MurmurHost API.
واجهة برمجة تطبيقات REST عبر HTTPS، JSON داخل / JSON خارج، مصادقة رمز حامل. توفير VPS، إدارة الخدمات، سرد الخطط، استيعاب webhooks. مصممة لتكون سهلة الاستخدام من سطر Bash أو أي عميل HTTP حديث.
عنوان URL الأساسي
https://api.murmurhost.com/v1بدء سريع
انشر أول VPS لك عبر API في 4 أسطر من curl.
قم بإنشاء مفتاح 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"
}'ادفع الفاتورة واستلم بيانات الاعتماد عبر webhook
{
"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 / scripts.
ماذا يحدث على نطاق واسع
الحد الافتراضي: 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] للعثور على إدخال السجل المطابق.
واجهة برمجة تطبيقات الخدمات
تجهيز، قائمة، تحديث، إلغاء، إعادة تشغيل، لقطة، ترحيل.
services
/v1/servicesقائمة بجميع الخدمات المملوكة للحساب المصادق عليه.
/v1/servicesقم بتجهيز خادم VPS / RDP / خادم مخصص جديد.
/v1/services/{id}استرجاع خدمة واحدة بالمعرف.
/v1/services/{id}تحديث خدمة (إعادة تسمية، تغيير التجديد التلقائي، إرفاق إضافات).
/v1/services/{id}ألغِ الخدمة وأوقف تشغيلها. يُطبَّق الاسترداد إذا كان ضمن فترة 7 أيام.
/v1/services/{id}/rebootإعادة تشغيل صلبة أو ناعمة لخدمة قيد التشغيل.
/v1/services/{id}/snapshotأنشئ لقطة يدوية. يُرجع معرف اللقطة.
/v1/services/{id}/migrateقم بترحيل خدمة إلى اختصاص قضائي مختلف. ترحيل مباشر حيثما كان مدعومًا.
واجهة برمجة تطبيقات المواقع
للقراءة فقط — قائمة الاختصاصات القضائية الثمانية، احصل على السعة لكل موقع.
/v1/locationsقائمة الاختصاصات القضائية الثمانية لمراكز البيانات وسعتها الحالية.
/v1/locations/{slug}تفاصيل لاختصاص قضائي واحد: الموقف القانوني، الناقلون، الشهادات، اختبار الاتصال في الوقت الفعلي من عنوان IP الخاص بك.
واجهة برمجة الخطط
كتالوج كامل من 35 خطة. الأسعار والمواصفات وتوافق الإضافات.
/v1/plansقائمة بجميع الخطط الـ 35 عبر فئات المنتجات الـ 11.
/v1/plans/{slug}تفاصيل لخطة واحدة: المواصفات الكاملة، التسعير لكل دورة، التوفر حسب الموقع، الإضافات الموصى بها.
/v1/categoriesقائمة بفئات المنتجات الـ 11 مع بيانات وصفية موجزة.
واجهة برمجة تطبيقات الفوترة والفواتير
اعرض الفواتير، واسترجع ملفات PDF، وادفع الفواتير المفتوحة عبر Card2Crypto أو OxaPay.
/v1/invoicesقائمة بجميع الفواتير للحساب الموثق.
/v1/invoices/{id}استرجاع فاتورة واحدة مع بنودها.
/v1/invoices/{id}/payابدأ الدفع لفاتورة مفتوحة. يُرجع رابط دفع (Card2Crypto أو OxaPay).
/v1/invoices/{id}/pdfقم بتنزيل ملف PDF للفاتورة لأغراض المحاسبة.
اشترك في أحداث دورة الحياة
قم بتكوين عنوان webhook مرة واحدة؛ استقبل POSTs موقعة بـ HMAC-SHA256 لكل حدث ذي صلة.
التحقق من التوقيعات
كل webhook يحمل X-MurmurHost-التوقيع header — HMAC-SHA256 لجسم الطلب الخام باستخدام سر webhook الخاص بك. تحقق قبل المعالجة.
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يُطلق عند نشر حادث في صفحة الحالة يؤثر على خدماتك.
SDKs وCLI
واجهة برمجة التطبيقات هي HTTP بسيط — أي عميل يعمل. ننشر أيضًا Node SDK وGo SDK وواجهة سطر أوامر hostctl.
@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
الرسمية murmurhost/murmurhost مزود Terraform على خارطة الطريق. سجل للوصول المبكر.
نسخة تجريبية عامة
واجهة برمجة التطبيقات في النسخة التجريبية العامة اعتبارًا من الربع الثاني من 2026
نقاط النهاية الموثقة أعلاه مستقرة ولن تنكسر ضمن مساحة v1. يتم إصدار التغييرات الجذرية كـ v2 مع حد أدنى لفترة إهمال مدتها 6 أشهر. وجدت خطأ؟ افتح تذكرة من /client/tickets/new مع request_id من الاستجابة الفاشلة.
انشر أول خادم خارجي لك في 60 ثانية.
تسجيل مجهول. نقبل البيتكوين ومونيرو. يتم التجهيز عبر 8 اختصاصات قضائية.
لا حاجة لبطاقة ائتمان · ضمان استرداد المال لمدة 7 أيام