EQVPS
REST API · MCP

EQVPS API

راجستر شئ، په crypto بیلانس ډک کړئ او VPS په بشپړه توګه د کوډ له لارې امر کړئ — بې KYC، په حلقه کې بې انسان. د پرمخ‌کوونکو او د هغو AI اجنټانو لپاره جوړ شوی چې خپل سرورونه چمتو کوي.

OpenAPI 3.1MCP live · 26 toolsBearer authREST + MCP
Base URLhttps://api.eqvps.com/api/v1/eqvps
ژوندی وازمویئOpenAPI specبشپړ حواله

چټک پیل

څلور کالونه: له صفر څخه یو روان VPS ته. لاندې tokenونه placeholderونه دي — هیڅکله یو ریښتینی token په یوه پاڼه کې مه پیسټ کوئ.

# 1. Register — returns a Bearer token (no KYC, no human step)
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>" }
# 2. Top up balance — pay in USDC / USDT / PYUSD, get a checkout URL
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://…" }   # pay on-chain, balance credits automatically
# 3. Order a VPS — paid from balance (get slug + os_id from 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…"}'
# 4. Read SSH access — one-time root password is shown once here
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" } }

کلیدي endpointونه

اصلي سطحه. د هر parameter او ځواب لپاره تعاملي explorer خلاص کړئ.

POST/auth/registerیو حساب جوړ کړئ او یو Bearer token ترلاسه کړئ. بې پټنوم، بې انساني ګام.
GET/productsټول VPS پلانونه د مشخصاتو، بیې او ملاتړ شوو OS تصویرونو سره فهرست کړئ.
POST/balance/topupیو crypto ډکولو انوائس جوړ کړئ؛ یو checkout URL راګرځوي. بیلانس د on-chain تایید سره اعتبار کیږي.
POST/ordersVPS امر کړئ. که ډک شوی وي له بیلانس څخه تادیه کوي، که نه یو ناتادیه انوائس راګرځوي.
GET/services/{id}بشپړ حالت + ژوندی SSH لاسرسی. د یو‌ځلي root کوډ دلته یو ځل ښکاره کیږي.
GET/balanceمخکې-تادیه شوی د اعتبار بیلانس او اسعارو.

هر endpoint، parameter او schema په تعاملي explorer کې وګورئ →

د AI اجنټانو لپاره

یو اجنټ کولی شي پخپله له هیڅ څخه یو کاري سرور ته لاړ شي — کشف، تادیه، چمتو کول او SSH لوستل، ټول د API یا MCP له لارې.

MCP ژوندی دی — نه پلان شوی.

هر MCP client په https://mcp.eqvps.com/mcp ونښلوئ (Streamable HTTP). ۲۶ وسیلې کشف، حساب، تادیه او بشپړ د VPS کنټرول پوښي. عامه وسیلې: list_plans، register_account، login؛ نور ټول Bearer token ته اړتیا لري.

خپلواک بهیر

1. register_account → یو Bearer token ترلاسه کړئ
2. topup_balance → د checkout URL په USDC/USDT تادیه کړئ
3. order_vps → له بیلانس څخه چمتو کول
4. get_vps_status → تر فعالیدو پورې یې وګورئ، SSH ولولئ (host، port، کمانډ، یو‌ځلی کوډ)

د ماشین-لوستلو وړ سرچینې

تېروتنې

معیاري HTTP status codeونه. Bodyونه د ناکامۍ په صورت کې یو message ساحه لري.

حالتمعنی
200 / 201OK — request succeeded / resource created.
401Missing or invalid Bearer token.
403Authenticated, but not the owner of this resource.
404Resource not found.
409State conflict (e.g. an unpaid top-up already exists).
422Validation error — check the request body.
429Rate limited — back off and retry.

Rate limits

حساسې کړنې (امر، د بیلانس ډکول، د کوډ بیا تنظیم، بیا نصب، console) په هر حساب rate-limited دي. عادي اتوماتیک د حدونو دننه پاتې کیږي؛ په 429 کې، سست شئ او بیا هڅه وکړئ.

اوس پرې جوړ کړئ

spec ترلاسه کړئ، explorer خلاص کړئ یا د MCP تنظیم سره بشپړ روایتي حواله ولولئ.