turknode.cloud/docs/api

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

Q: خطای ۴۰۳ با کد ۱۰۱۰

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

Q: خطای ۴۲۹ (Too Many Requests)

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

هر کاری که در پنل انجام می‌شود، یک endpoint دارد. توکن بسازید، JSON بفرستید و JSON دریافت کنید.

مبانی

آدرس پایه: https://api.turknode.cloud/v1
احراز هویت: هدر Authorization: Bearer YOUR_TOKEN — توکن‌ها را در پنل از بخش Developer → API Keys بسازید
توکن‌ها: حداکثر ۱۰ توکن برای هر حساب، قابل ابطال در هر زمان
محدودیت نرخ: ۱۲۰ درخواست در دقیقه برای هر حساب
صورتحساب: هزینه سرورهای سفارش‌داده‌شده از طریق API از کیف پول شما کسر می‌شود
هدرها: هدر Accept: application/json و یک User-Agent اختصاصی بفرستید

فهرست پلن‌ها

هنگام سفارش از id پلن استفاده کنید.

curl https://api.turknode.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.turknode.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"}'

فهرست endpointها

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

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	بستن تیکت

خطاها

خطای ۴۰۱ (Unauthenticated)

توکن اشتباه است یا باطل شده است. از بخش Developer → API Keys یک توکن جدید بسازید.

خطای ۴۰۳ با کد ۱۰۱۰

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

خطای ۴۲۲ (Unprocessable)

یکی از فیلدها نامعتبر است؛ بدنه JSON پاسخ، هر فیلد و دلیل خطای آن را فهرست می‌کند.

خطای ۴۲۹ (Too Many Requests)

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

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

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

ماژول WHMCS