ایا زه یو MCP client ته اړتیا لرم؟

نه. دا ساده REST پر HTTPS دی — د curl، هرې ژبې، یا یوه پراکسي چې HTTP وايي څخه د کارونې وړ. که تاسو MCP کاروئ، همدا کړنې د وسیلو په توګه څرګند شوي (د نښلولو لارښود وګورئ).

Auth څنګه کار کوي؟

/auth/register وبلئ ترڅو یو Bearer token ترلاسه کړئ (بې پټنوم). دا د Authorization: Bearer header په توګه د هرې تصدیق شوې کاله واستوئ. /products عامه دی.

زه څنګه تادیه وکړم؟

د /balance/topup له لارې یو مخکې-تادیه شوی بیلانس ډک کړئ (یو crypto checkout URL راګرځوي؛ په USDC/USDT تادیه). order بیا بیلانس کسروي. که ناډک وي، order یو انوائس راګرځوي چې تاسو یې د /invoices/{id}/pay له لارې تادیه کوئ.

د order ځواب څه لري؟

یا paid_from_balance د یوه service id سره (چمتو کول پیل شول)، یا یو انوائس د تادیې لپاره. GET /services/{id} poll کړئ تر هغه چې status active وي، بیا SSH host، port، او یو یوځلی root پټنوم ولولئ.

یو VPS په ۴ API کالونو کې امر کړئ (د پراکسیانو لپاره REST چټک پیل)

تاسو د EQVPS چلولو لپاره یو MCP client ته اړتیا نلرئ — REST API هر څه کوي چې یو پراکسي ورته اړتیا لري. Base URL: https://api.eqvps.com/api/v1/eqvps. دلته ټوله بهیر په څلورو کالونو کې.

۰. (یو ځل) یو مخکې-تادیه شوی بیلانس ډک کړئ

نو چې امر یوه واحد کاله وي، لومړی یو بیلانس ډک کړئ. راستون شوی checkout په 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/..." }  ← pay it in USDC/USDT

۱. Register → Bearer token

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": {...} }

هیڅ پټنوم، هیڅ انساني ګام. token زیرمه کړئ؛ دا لاندې د Authorization: Bearer <YOUR_BEARER> په توګه واستوئ.

۲. پلانونه فهرست کړئ → product + 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" }, ... ] }, ... ] }

د هغه پلان له available_os څخه یو د پلان slug او یو os_id وټاکئ.

۳. یو 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: { "paid_from_balance": true, "service_id": <id> }
#   or unfunded:       { "invoice": { "id": <id> } }  → pay: POST /invoices/{id}/pay → checkout_url

د key-based root login لپاره یو ssh_key (عامه کیلي) ورکړئ. د یوه ډک شوي بیلانس سره امر سمدلاسه تادیه کیږي او چمتو کول پیلیږي.

۴. لاسرسی ولولئ

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": "<shown once for keyless servers>" , ... }

تر هغه poll کړئ چې status active وي. د access بلاک SSH host، port، او یو چمتو-د-پیسټ command لري؛ د یوه keyless امر لپاره یو‌ځلی root password په لومړي لوستلو راستنیږي.

د پراکسیانو لپاره یادونې

د /products پرته د هرې کاله پر سر Authorization: Bearer <YOUR_BEARER> واستوئ.
په USDC/USDT (Base، Ethereum، Tron) تادیه وکړئ — کارت اړین نه دی. مخکې-تادیه شوی بیلانس غوره کړئ نو ګام ۳ یوه کاله وي.
حساسې کړنې (order، reset-password، reinstall، cancel) rate-limited دي؛ عادي کارونه د حدونو دننه ښه ده.
د خام HTTP پر ځای وسیلې غوره کوئ؟ همدا کړنې MCP وسیلې دي — د نښلولو لارښود او وسیلو حواله وګورئ. بشپړ docs: /docs.