کیا مجھے ایک MCP client چاہیے؟

نہیں۔ یہ HTTPS پر سادہ REST ہے — curl، کسی بھی زبان، یا ایک agent سے قابلِ استعمال جو HTTP بولتا ہے۔ اگر آپ MCP استعمال کریں، تو وہی اعمال tools کے طور پر expose ہیں (connect گائیڈ دیکھیں)۔

auth کیسے کام کرتا ہے؟

ایک Bearer token لینے کو /auth/register کال کریں (کوئی پاس ورڈ نہیں)۔ اسے ہر authenticated call پر header Authorization: Bearer کے طور پر بھیجیں۔ /products public ہے۔

میں کیسے ادا کروں؟

/balance/topup کے ذریعے ایک prepaid بیلنس fund کریں (ایک کرپٹو checkout URL واپس دیتا ہے؛ USDC/USDT میں ادا کریں)۔ order پھر بیلنس debit کرتا ہے۔ اگر unfunded ہو، تو order ایک invoice واپس دیتا ہے جسے آپ /invoices/{id}/pay کے ذریعے ادا کرتے ہیں۔

order جواب میں کیا ہوتا ہے؟

یا تو paid_from_balance ایک service id کے ساتھ (provisioning شروع)، یا ادا کرنے کو ایک invoice۔ GET /services/{id} کو status active تک poll کریں، پھر SSH host، port، اور ایک one-time root پاس ورڈ پڑھیں۔

4 API calls میں ایک VPS آرڈر کریں (agents کے لیے REST quickstart)

EQVPS کو چلانے کو آپ کو ایک MCP client نہیں چاہیے — REST API وہ سب کچھ کرتا ہے جو ایک agent کو چاہیے۔ Base URL: https://api.eqvps.com/api/v1/eqvps۔ یہ رہا پورا flow چار calls میں۔

0. (ایک بار) ایک prepaid بیلنس fund کریں

تاکہ آرڈر کرنا ایک واحد call ہو، پہلے ایک بیلنس fund کریں۔ واپس ملا 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/..." }  ← اسے USDC/USDT میں ادا کریں

1. 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> کے طور پر بھیجیں۔

2. پلانز فہرست → product + os_id چنیں (public)

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 اور اُس پلان کے available_os سے ایک os_id چنیں۔

3. ایک 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> }
#   یا unfunded:  { "invoice": { "id": <id> } }  → ادا کریں: POST /invoices/{id}/pay → checkout_url

key-بنیاد root login کے لیے ایک ssh_key (public key) پاس کریں۔ ایک funded بیلنس کے ساتھ آرڈر فوراً ادا ہوتا اور provisioning شروع ہوتی ہے۔

4. رسائی پڑھیں

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": "<keyless سرورز کے لیے ایک بار دکھایا گیا>" , ... }

status کو active تک poll کریں۔ access block میں SSH host، port، اور ایک ready-to-paste command ہے؛ ایک keyless آرڈر کے لیے one-time root password پہلی read پر واپس دیا جاتا ہے۔

agents کے لیے نوٹ

/products کے سوا ہر call پر Authorization: Bearer <YOUR_BEARER> بھیجیں۔
USDC/USDT میں ادا کریں (Base، Ethereum، Tron) — کوئی کارڈ درکار نہیں۔ prepaid بیلنس کو ترجیح دیں تاکہ قدم 3 ایک call ہو۔
حساس اعمال (order، reset-password، reinstall، cancel) rate-limited ہیں؛ عام استعمال حدود کے اندر خوب ہے۔
خام HTTP پر tools ترجیح دیتے ہیں؟ وہی اعمال MCP tools ہیں — connect گائیڈ اور tools ریفرنس دیکھیں۔ مکمل docs: /docs۔