یک VPS با یک POST راه‌اندازی کنید.

از صفر تا root، در پنج درخواست.

هر endpoint زیر https://vpscrypto.io/api/v1 قرار دارد، JSON صحبت می‌کند، و (به جز ایجاد حساب، کاتالوگ و health) یک کلید API Authorization: Bearer می‌خواهد. بدون KYC، بدون کارت.

1. ایجاد حساب — یک api_key (اعتبارنامه Bearer شما) و یک login_token برای داشبورد وب برمی‌گرداند. هر دو یک بار نمایش داده می‌شوند.

curl -X POST https://vpscrypto.io/api/v1/account

# → {"api_key":"vpsk_…","login_token":"XXXX-XXXX-XXXX-XXXX", …}
export VPSK="vpsk_your_key_here"

2. شارژ موجودی — یک فاکتور شارژ در هر ارز پشتیبانی‌شده ایجاد کنید (اینجا Monero):

curl -X POST https://vpscrypto.io/api/v1/topups \
  -H "Authorization: Bearer $VPSK" -H "Content-Type: application/json" \
  -d '{"amount":50,"coin":"XMR"}'

# → deposit_address + deposit_amount + ref. Pay it, then poll:
curl https://vpscrypto.io/api/v1/topups/<ref> -H "Authorization: Bearer $VPSK"

3. راه‌اندازی سرور — وقتی موجودی شارژ شد، از کاتالوگ سفارش دهید. root_password را حذف کنید و ما یک رمز قوی تولید می‌کنیم (یک بار برگردانده می‌شود):

curl -X POST https://vpscrypto.io/api/v1/servers \
  -H "Authorization: Bearer $VPSK" -H "Content-Type: application/json" \
  -d '{"plan":"hunter","location":"nl","os":"debian-13"}'

# → {"server":{"id":123,"ip":null,"username":"root","root_password":"…"}}

کلیدهای API Bearer.

هر درخواست را با یک کلید API در هدر Authorization احراز هویت کنید. کلیدها با vpsk_ شروع می‌شوند و فقط به صورت هش ذخیره می‌شوند — آن‌ها را مخفی نگه دارید.

Authorization: Bearer vpsk_a3e5e745b6952c772f5731ab1d87fac4…

اولین کلید خود را از POST /account دریافت کنید. در هر زمان کلیدهای بیشتری ضرب کنید، فهرست کنید یا لغو کنید:

پلان‌ها، لوکیشن‌ها و تصاویر.

یک درخواست عمومی واحد همه چیزی که برای ساخت یک سفارش نیاز دارید را برمی‌گرداند — نیازی به احراز هویت نیست.

curl https://vpscrypto.io/api/v1/catalog

شناسه‌های پلان از pup تا fenrir اجرا می‌شوند (10 ردیف). شناسه‌های لوکیشن: nl, fr, ro, bg, se, is, ch, my. تصاویر شامل Debian 12, Debian 13, Ubuntu 24.04 LTS, Ubuntu 22.04 LTS, AlmaLinux 9, Rocky Linux 9 و موارد دیگر هستند. قیمت ماهانه = base × ضریب لوکیشن؛ سالانه = ×10 (2 ماه رایگان).

شارژ موجودی با ارز دیجیتال.

شارژها پیش‌پرداخت و فقط on-chain هستند ($25–$2000). ارزهای کلاسیک یک آدرس واریز برمی‌گردانند؛ USDCBASE یک challenge x402 برای تسویه بدون گاز برمی‌گرداند.

ارزهای پشتیبانی‌شده: BTC, XMR, ETH, LTC, USDTTRC, USDT، به علاوه USDCBASE برای x402. ref را تا وقتی status برابر completed شود poll کنید — در آن زمان موجودی اعتبار می‌گیرد.

سفارش و مدیریت.

سفارش‌دهی قیمت را در یک مرحله اتمی از موجودی شما کسر می‌کند. یک پاسخ 402 insufficient_balance شامل deficit دقیق است تا یک عامل بداند چقدر باید شارژ کند.

رمز root یک بار در زمان ایجاد برگردانده می‌شود و همیشه از endpoint اعتبارنامه‌ها قابل نمایش است. از طریق SSH مطابق مستندات وصل شوید.

خرابی‌های قابل پیش‌بینی.

خطاها از کدهای وضعیت HTTP استاندارد با بدنه قابل خواندن توسط دستگاه پایدار استفاده می‌کنند. 402 به این معناست که یک مرحله پرداخت لازم است (موجودی ناکافی، یا یک challenge x402).

{
  "error": "insufficient_balance",
  "message": "Top up your balance before ordering. Deficit: $19.00.",
  "price": 19, "balance": 0, "deficit": 19
}

• 200 / 201 — موفق.
• 400 — ورودی نادرست (invalid_plan، invalid_coin، amount_too_low…).
• 401 — کلید API گمشده یا نامعتبر (unauthorized).
• 402 — پرداخت لازم است (insufficient_balance، یا یک بلاک accepts برای x402).
• 404 — منبع ناشناخته. 5xx — به زودی دوباره تلاش کنید.

قرارداد کامل قابل خواندن توسط دستگاه در مشخصات OpenAPI 3.1 قرار دارد.