−25%

روی پرداخت سالانه Windows، تا ۳۱ اکتبر. مشاهده پلن‌ها

EQVPS
REST API · MCP

EQVPS API

ثبت‌نام کنید، با رمزارز شارژ کنید، و VPS را کاملاً برنامه‌نویسی‌شده سفارش دهید — بدون KYC، بدون دخالت انسان. ساخته‌شده برای توسعه‌دهندگان و ایجنت‌های هوش مصنوعی که سرورهای خود را آماده می‌کنند.

OpenAPI 3.1MCP live · 26 toolsBearer authREST + MCP
آدرس URL پایهhttps://api.eqvps.com/api/v1/eqvps
همین حالا امتحان کنیدمشخصات OpenAPIمرجع کامل

شروع سریع

چهار استدعا: از صفر تا یک VPS فعال. توکن‌های زیر عناصر نمایشی‌اند — توکن واقعی را در یک صفحه نچسبانید.

# ۱. ثبت‌نام — یک توکن Bearer برمی‌گرداند (بدون KYC، بدون گام انسانی)
curl -X POST https://api.eqvps.com/api/v1/eqvps/auth/register \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Ada","last_name":"Agent","email":"agent@example.com"}'
# ← { "token": "<YOUR_API_TOKEN>" }
# ۲. شارژ موجودی — با USDC / USDT / PYUSD بپرداز، یک لینک پرداخت بگیر
curl -X POST https://api.eqvps.com/api/v1/eqvps/balance/topup \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"amount":20}'
# ← { "checkout_url": "https://…" }   # روی زنجیره بپرداز، موجودی خودکار اضافه می‌شود
# ۳. یک VPS سفارش بده — از موجودی پرداخت می‌شود (slug + os_id را از GET /products بگیر)
curl -X POST https://api.eqvps.com/api/v1/eqvps/orders \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"product":"micro","os_id":1,"ssh_key":"ssh-ed25519 AAAA…"}'
# ۴. دسترسی SSH را بخوان — رمز عبور root یک‌بارمصرف اینجا یک‌بار نمایش داده می‌شود
curl https://api.eqvps.com/api/v1/eqvps/services/SV-XXXXXX \
  -H "Authorization: Bearer <YOUR_API_TOKEN>"
# → { "status":"active", "ssh": { "host":"…", "port":22, "command":"ssh root@… -p 22" } }

نقاط پایانی اصلی

سطح اصلی. کاوشگر تعاملی را برای هر پارامتر و پاسخ باز کنید.

POST/auth/registerیک حساب بسازید و یک توکن Bearer بگیرید. بدون رمز عبور، بدون گام انسانی.
GET/productsهمه پلن‌های VPS را با مشخصات، قیمت و ایمیج‌های سیستم‌عامل پشتیبانی‌شده ببینید.
POST/balance/topupیک فاکتور شارژ رمزارزی بسازید؛ یک پیوند پرداخت برمی‌گرداند. موجودی با تأیید زنجیره اضافه می‌شود.
POST/ordersیک VPS سفارش دهید. اگر ممول باشد از موجودی می‌پردازد، وگرنه یک فاکتور پرداخت‌نشده برمی‌گرداند.
GET/services/{id}وضعیت کامل + دسترسی SSH زنده. رمز عبور root یک‌بار اینجا نمایش داده می‌شود.
GET/balanceموجودی پیش‌پرداخت و ارز.

هر نقطه پایانی، پارامتر و شِما را در کاوشگر تعاملی ببینید ←

برای ایجنت‌های هوش مصنوعی

یک ایجنت می‌تواند به‌تنهایی از هیچ به یک سرور فعال برسد — کشف می‌کند، می‌پردازد، آماده می‌کند و SSH را می‌خواند، همه از طریق API یا MCP.

MCP زنده — نه برنامه‌ریزی‌شده.

هر کلاینت MCP را به https://mcp.eqvps.com/mcp (Streamable HTTP) بفرستید. ۲۶ ابزار کشف، حساب، پرداخت و کنترل کامل VPS را پوشش می‌دهند. ابزارهای عمومی: list_plans، register_account و login؛ همه بقیه به توکن Bearer نیاز دارند.

جریان خودخدمت

1. register_account ← یک توکن Bearer بگیرید
2. topup_balance ← پیوند پرداخت را با USDC/USDT بپردازید
3. order_vps ← از موجودی آماده کنید
4. get_vps_status ← استعلام کنید تا فعال شود، SSH را بخوانید (میزبان، پورت، دستور، رمز عبور یک‌بار)

منابع ماشین‌خوان

خطاها

کدهای وضعیت HTTP استاندارد. بدنه‌ها هنگام شکست یک فیلد message دارند.

وضعیتمعنی
200 / 201موفق — درخواست موفق شد / منبع ساخته شد.
401توکن Bearer مفقود یا نامعتبر.
403احراز شده، اما مالک این منبع نیستید.
404منبع یافت نشد.
409تعارض وضعیت (مثلاً یک شارژ پرداخت‌نشده از قبل وجود دارد).
422خطای اعتبارسنجی — بدنه درخواست را بررسی کنید.
429محدودیت نرخ — عقب‌نشینی و دوباره تلاش کنید.

حدود نرخ

عملیات‌های حساس (سفارش، شارژ، ری‌ست رمز عبور، نصب مجدد، کنسول) برای هر حساب محدود نرخ‌اند. اتوماسیون عادی به‌راحتی درون حدود می‌ماند؛ هنگام ۴۲۹ عقب‌نشینی و دوباره تلاش کنید.

همین حالا رویش توسعه دهید

مشخصات را بگیرید، کاوشگر را باز کنید، یا مرجع روایی کامل با راه‌اندازی MCP را بخوانید.