REST API · MCP

EQVPS API

رجسٹر کریں، کرپٹو میں ٹاپ اپ کریں اور مکمل طور پر کوڈ کے ذریعے VPS آرڈر کریں — نہ KYC، لوپ میں کوئی انسان نہیں۔ ڈویلپرز اور اپنے سرور خود فراہم کرنے والے AI ایجنٹس کے لیے بنایا گیا۔

OpenAPI 3.1MCP live · 26 toolsBearer authREST + MCP

Base URLhttps://api.eqvps.com/api/v1/eqvps

لائیو آزمائیں OpenAPI اسپیک مکمل حوالہ

کوئیک اسٹارٹ

چار کالز: صفر سے چلتے ہوئے VPS تک۔ نیچے دیے ٹوکنز پلیس ہولڈر ہیں — کبھی کسی صفحے پر اصل ٹوکن پیسٹ نہ کریں۔

# 1. رجسٹر — ایک Bearer token واپس کرتا ہے (نہ 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>" }

# 2. بیلنس ٹاپ اپ — USDC / USDT / PYUSD میں ادائیگی کریں، ایک 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://…" }   # آن چین ادائیگی، بیلنس خودکار طور پر کریڈٹ ہوتا ہے

# 3. ایک VPS آرڈر — بیلنس سے ادا شدہ (GET /products سے slug + os_id حاصل کریں)
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. 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 token حاصل کریں۔ نہ پاس ورڈ، نہ کوئی انسانی مرحلہ۔

GET/productsاسپیک، قیمت اور معاون OS امیجز کے ساتھ تمام VPS پلانز کی فہرست دیں۔

POST/balance/topupایک کرپٹو ٹاپ اپ انوائس بنائیں؛ ایک checkout URL واپس کرتا ہے۔ آن چین تصدیق پر بیلنس کریڈٹ ہوتا ہے۔

POST/ordersایک VPS آرڈر کریں۔ فنڈڈ ہونے پر بیلنس سے ادائیگی، ورنہ ایک غیر ادا شدہ انوائس واپس کرتا ہے۔

GET/services/{id}مکمل اسٹیٹس + لائیو SSH رسائی۔ ایک بار کا root پاس ورڈ یہاں ایک بار ظاہر ہوتا ہے۔

GET/balanceپیشگی ادا شدہ کریڈٹ بیلنس اور کرنسی۔

انٹرایکٹو ایکسپلورر میں ہر اینڈ پوائنٹ، پیرامیٹر اور اسکیما دیکھیں →

AI ایجنٹس کے لیے

ایک ایجنٹ خود بخود صفر سے ایک فعال سرور تک پہنچ سکتا ہے — API یا MCP کے ذریعے دریافت، ادائیگی، فراہمی اور SSH پڑھنا۔

MCP لائیو ہے — منصوبہ بند نہیں۔

کسی بھی MCP کلائنٹ کو https://mcp.eqvps.com/mcp پر پوائنٹ کریں (Streamable HTTP)۔ 26 ٹولز دریافت، اکاؤنٹ، ادائیگی اور مکمل VPS کنٹرول کا احاطہ کرتے ہیں۔ پبلک ٹولز: list_plans، register_account، login؛ باقی سب ایک Bearer token لیتے ہیں۔

خودمختار فلو

1. register_account → ایک Bearer token حاصل کریں
2. topup_balance → USDC/USDT میں checkout URL ادا کریں
3. order_vps → بیلنس سے فراہمی
4. get_vps_status → active ہونے تک پول کریں، SSH پڑھیں (host، port، command، ایک بار کا پاس ورڈ)

مشین پڑھنے کے قابل وسائل

agent.jsonمشین پروفائل — پلانز، اینڈ پوائنٹس، MCP اسٹیٹس۔mcp.jsonMCP مینی فیسٹ — سرور URL اور ٹولز کی فہرست۔llms.txtاینڈ ٹو اینڈ مثال کے ساتھ مختصر LLM گائیڈ۔llms-full.txtتوسیع شدہ LLM حوالہ۔openapi.jsonOpenAPI 3.1 تفصیلات (explorer کو چلاتا ہے)۔

خرابیاں

معیاری HTTP اسٹیٹس کوڈز۔ ناکامی پر باڈی میں ایک message فیلڈ ہوتا ہے۔

اسٹیٹسمطلب

200 / 201OK — درخواست کامیاب / وسیلہ بن گیا۔

401Bearer token غائب یا غلط۔

403تصدیق شدہ، لیکن اس وسیلے کے مالک نہیں۔

404وسیلہ نہیں ملا۔

409حالت کا تصادم (مثلاً ایک غیر ادا شدہ ٹاپ اپ پہلے سے موجود ہے)۔

422توثیق کی خرابی — درخواست باڈی چیک کریں۔

429ریٹ محدود — رک کر دوبارہ کوشش کریں۔

ریٹ لیمٹس

حساس اعمال (آرڈر، ٹاپ اپ، پاس ورڈ ری سیٹ، ری انسٹال، کنسول) فی اکاؤنٹ ریٹ لمیٹڈ ہیں۔ عام آٹومیشن حدود کے اندر رہتی ہے؛ 429 پر، بیک آف کر کے دوبارہ کوشش کریں۔

ابھی اس پر بنائیں

اسپیک لیں، ایکسپلورر کھولیں، یا MCP سیٹ اپ کے ساتھ مکمل تفصیلی حوالہ پڑھیں۔

ایکسپلورر کھولیں دستاویزات پڑھیں