توسعه‌دهندگان

رابط برنامه‌نویسی (REST API)

Q: خطای 403 با کد 1010

کتابخانه HTTP شما یک User-Agent پیشفرض میفرستد که فایروال ما آن را مسدود میکند (Python urllib، Perl LWP). هدر User-Agent اختصاصی تنظیم کنید یا از requests یا httpx استفاده کنید.

هر کاری در پنل، یک endpoint در API دارد. یک توکن بسازید، JSON بفرستید و JSON تحویل بگیرید.

مبانی

آدرس پایه: https://api.bulutera.cloud/v1
احراز هویت: Authorization: Bearer YOUR_TOKEN؛ توکن‌ها را در پنل از مسیر Developer → API Keys بسازید
توکن‌ها: تا ۱۰ عدد برای هر حساب، قابل لغو در هر زمان
محدودیت نرخ: ۱۲۰ درخواست در دقیقه برای هر حساب
صورت‌حساب: هزینه سرورهایی که از طریق 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 باید ۸ تا ۱۲ کاراکتر باشد و یک حرف کوچک، یک حرف بزرگ، یک رقم و یکی از کاراکترهای ! # + $ * - را داشته باشد.

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

اندپوینت‌ها

حساب و کاتالوگ

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	درخواست تعویض آی‌پی (استانبول)
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)

از ۱۲۰ درخواست در دقیقه بیشتر شده است. صبر کنید و دوباره تلاش کنید.

از WHMCS می‌فروشید؟

ماژول رایگان ما این API را برای شما به کار می‌گیرد.

ماژول WHMCS