آیا به یک کلاینت MCP نیاز دارم؟

نه. این REST ساده روی HTTPS است — از curl، هر زبانی، یا هر عاملی که HTTP صحبت میکند قابل استفاده است. اگر از MCP استفاده کنید، همان کنشها بهصورت ابزار در معرض قرار میگیرند (راهنمای اتصال را ببینید).

احراز هویت چطور کار میکند؟

‏/auth/register را فراخوانی کنید تا یک توکن Bearer بگیرید (بدون رمز عبور). آن را بهعنوان هدر Authorization: Bearer روی هر فراخوان احراز هویتشده بفرستید. ‏/products عمومی است.

چطور پرداخت کنم؟

یک موجودی پیشپرداخت را از طریق /balance/topup شارژ کنید (یک آدرس چکاوت رمزارز برمیگرداند؛ با USDC/USDT پرداخت کنید). سپس order از موجودی کسر میکند. اگر شارژ نشده باشد، order یک فاکتور برمیگرداند که از طریق /invoices/{id}/pay پرداختش میکنید.

پاسخ order چه چیزی دربردارد؟

یا paid_from_balance با یک شناسهی سرویس (تأمین آغاز شد)، یا یک فاکتور برای پرداخت. GET /services/{id} را نظرسنجی کنید تا وضعیت active شود، سپس هاست SSH، پورت، و یک رمز عبور root یکبارمصرف را بخوانید.

یک VPS را در ۴ فراخوان API سفارش دهید (شروع سریع REST برای عامل‌ها)

برای راندن اکوی‌پی‌اس نیازی به یک کلاینت MCP ندارید — API از نوع REST هر کاری که یک عامل نیاز دارد را انجام می‌دهد. آدرس پایه: https://api.eqvps.com/api/v1/eqvps. اینجا کل جریان در چهار فراخوان آمده.

۰. (یک بار) یک موجودی پیش‌پرداخت را شارژ کنید

برای اینکه سفارش‌دادن یک فراخوان واحد باشد، اول یک موجودی را شارژ کنید. چک‌اوت بازگشتی را با USDC/USDT پرداخت کنید:

curl -s -X POST https://api.eqvps.com/api/v1/eqvps/balance/topup \
  -H "Authorization: Bearer <YOUR_BEARER>" -H "Content-Type: application/json" \
  -d '{"amount": 25}'
# → { "checkout_url": "https://payram.eqvps.com/..." }  ← آن را با USDC/USDT پرداخت کنید

۱. ثبت‌نام ← توکن Bearer

curl -s -X POST https://api.eqvps.com/api/v1/eqvps/auth/register \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Ada","last_name":"Agent","email":"ada@example.com"}'
# → { "token": "<YOUR_BEARER>", "token_type": "Bearer", "user": {...} }

بدون رمز عبور، بدون گام انسانی. توکن را ذخیره کنید؛ آن را در ادامه به‌عنوان Authorization: Bearer <YOUR_BEARER> بفرستید.

۲. فهرست پلن‌ها ← انتخاب محصول + os_id (عمومی)

curl -s https://api.eqvps.com/api/v1/eqvps/products
# → { "data": [ { "slug": "<product-slug>", "price": {...},
#       "specs": {...}, "available_os": [ { "id": <os_id>, "name": "Ubuntu 24.04" }, ... ] }, ... ] }

یک slug پلن و یک os_id از available_os همان پلن انتخاب کنید.

۳. یک VPS سفارش دهید

curl -s -X POST https://api.eqvps.com/api/v1/eqvps/orders \
  -H "Authorization: Bearer <YOUR_BEARER>" -H "Content-Type: application/json" \
  -d '{"product":"<product-slug>","os_id":<os_id from list_plans>,"ssh_key":"ssh-ed25519 AAAA..."}'
# → پرداخت‌شده از موجودی: { "paid_from_balance": true, "service_id": <id> }
#   یا شارژ نشده:        { "invoice": { "id": <id> } }  → پرداخت: POST /invoices/{id}/pay → checkout_url

یک ssh_key (کلید عمومی) برای ورود root مبتنی بر کلید بفرستید. با یک موجودیِ شارژشده، سفارش فوراً پرداخت می‌شود و تأمین آغاز می‌شود.

۴. خواندن دسترسی

curl -s https://api.eqvps.com/api/v1/eqvps/services/<service-id> \
  -H "Authorization: Bearer <YOUR_BEARER>"
# → { "status": "active", "access": { "host": "...", "port": 22, "command": "ssh root@..." },
#     "password": "<برای سرورهای بدون‌کلید یک بار نمایش داده می‌شود>" , ... }

نظرسنجی کنید تا status برابر active شود. بلوک access هاست SSH، پورت، و یک command آماده‌ی چسباندن دارد؛ برای یک سفارش بدون‌کلید، رمز عبور root یک‌بارمصرف در اولین خواندن بازگردانده می‌شود.

نکاتی برای عامل‌ها

روی هر فراخوان به جز /products، هدر Authorization: Bearer <YOUR_BEARER> را بفرستید.
با USDC/USDT پرداخت کنید (Base، Ethereum، Polygon) — بدون نیاز به کارت. موجودی پیش‌پرداخت را ترجیح دهید تا گام ۳ یک فراخوان باشد.
کنش‌های حساس (سفارش، بازنشانی رمز عبور، نصب مجدد، لغو) محدودیت نرخ دارند؛ استفاده‌ی عادی کاملاً درون محدوده است.
ابزارها را به HTTP خام ترجیح می‌دهید؟ همان کنش‌ها ابزارهای MCP هستند — راهنمای اتصال و مرجع ابزارها را ببینید. مستندات کامل: /fa/docs.