للمطورين

واجهة REST API

لكل إجراء في اللوحة نقطة API مقابلة. أنشئ رمزًا (Token)، أرسل JSON، واستلم JSON.

الأساسيات

عنوان URL الأساسي
https://api.bulutera.cloud/v1
المصادقة
Authorization: Bearer YOUR_TOKEN — أنشئ الرموز في اللوحة من Developer → API Keys (المطور ← مفاتيح API)
الرموز
حتى 10 لكل حساب، ويمكن إلغاؤها في أي وقت
حد الطلبات
120 طلبًا في الدقيقة لكل حساب
الفوترة
السيرفرات المطلوبة عبر API تُدفع من محفظتك
الترويسات
أرسل Accept: application/json و User-Agent خاصًا بك

عرض الباقات

استخدم id الباقة عند الطلب.

curl https://api.bulutera.cloud/v1/plans \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json" \
  -H "User-Agent: my-app/1.0"

إنشاء سيرفر

يجب أن تتكون كلمة مرور root من 8–12 حرفًا وتحتوي على حرف صغير وحرف كبير ورقم وأحد الرموز ! # + $ * -.

curl -X POST https://api.bulutera.cloud/v1/servers \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "User-Agent: my-app/1.0" \
  -d '{"plan_id": 17, "os_id": 5, "label": "web-1", "root_password": "Str0ng#Pass"}'

نقاط API

الحساب والكتالوج

GET/v1/accountحسابك ورصيدك وخصم الموزّع
GET/v1/plansالباقات المتاحة للبيع مع أسعارها
GET/v1/osأنظمة التشغيل المتاحة للتثبيت

السيرفرات

GET/v1/serversعرض قائمة سيرفراتك
POST/v1/serversإنشاء سيرفر
GET/v1/servers/{id}تفاصيل السيرفر
PATCH/v1/servers/{id}إعادة تسمية السيرفر
DELETE/v1/servers/{id}إلغاء السيرفر؛ يعود الوقت غير المستخدم إلى المحفظة
POST/v1/servers/{id}/startتشغيل
POST/v1/servers/{id}/stopإيقاف
POST/v1/servers/{id}/restartإعادة التشغيل
POST/v1/servers/{id}/rebuildإعادة التثبيت بنظام آخر
POST/v1/servers/{id}/reset-passwordتعيين كلمة مرور root جديدة
POST/v1/servers/{id}/request-ip-changeطلب استبدال عنوان IP (إسطنبول)
GET/v1/servers/{id}/upgrade-optionsالباقات التي يمكن ترقية هذا السيرفر إليها
POST/v1/servers/{id}/upgradeالترقية إلى باقة أكبر
POST/v1/servers/{id}/vncفتح جلسة كونسول في المتصفح

المحفظة والفواتير

GET/v1/walletرصيد المحفظة
GET/v1/wallet/transactionsمعاملات المحفظة
GET/v1/invoicesعرض قائمة الفواتير
GET/v1/invoices/{id}تفاصيل الفاتورة

تذاكر الدعم

GET/v1/ticketsعرض قائمة التذاكر
POST/v1/ticketsفتح تذكرة
GET/v1/tickets/{id}تذكرة مع رسائلها
POST/v1/tickets/{id}/replyالرد على تذكرة
POST/v1/tickets/{id}/closeإغلاق تذكرة

الأخطاء

الخطأ 401 Unauthenticated
الرمز خاطئ أو تم إلغاؤه. أنشئ رمزًا جديدًا من Developer → API Keys.
الخطأ 403 مع رمز الخطأ 1010
مكتبة HTTP لديك ترسل User-Agent افتراضيًا يحظره جدار الحماية لدينا (Python urllib، Perl LWP). اضبط ترويسة User-Agent خاصة بك، أو استخدم requests أو httpx.
الخطأ 422 Unprocessable
أحد الحقول غير صالح؛ يسرد جسم JSON كل حقل وسبب رفضه.
الخطأ 429 Too Many Requests
تجاوزت 120 طلبًا في الدقيقة. انتظر ثم أعد المحاولة.

تبيع من WHMCS؟

وحدتنا المجانية تستخدم هذه الواجهة نيابةً عنك.

وحدة WHMCS