−25%

Windows के सालाना भुगतान पर, 31 अक्टूबर तक। प्लान देखें

EQVPS
शुरू करें

4 API कॉल में एक VPS ऑर्डर करें (एजेंट्स के लिए REST क्विकस्टार्ट)

10 जून 2026 · 2 मिनट पढ़ने में · EQVPS

आपको EQVPS चलाने के लिए एक MCP क्लाइंट नहीं चाहिए — REST API वह सब कुछ करता है जो एक एजेंट को चाहिए। बेस URL: https://api.eqvps.com/api/v1/eqvps। यहाँ पूरा फ़्लो चार कॉल में है।

0. (एक बार) एक प्रीपेड बैलेंस भरें

ताकि ऑर्डरिंग एक अकेली कॉल हो, पहले एक बैलेंस भरें। लौटे हुए चेकआउट को 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. रजिस्टर → 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> के रूप में भेजें।

2. प्लान सूचीबद्ध करें → 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" }, ... ] }, ... ] }

एक प्लान 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> }
#   या बिना-फ़ंड:       { "invoice": { "id": <id> } }  → चुकाएँ: POST /invoices/{id}/pay → checkout_url

की-आधारित root लॉगिन के लिए एक ssh_key (सार्वजनिक कुंजी) पास करें। एक फ़ंडेड बैलेंस के साथ ऑर्डर तुरंत चुक जाता है और प्रोविज़निंग शुरू होती है।

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": "<की-रहित सर्वरों के लिए एक बार दिखाया गया>" , ... }

status के active होने तक पोल करें। access ब्लॉक में SSH होस्ट, पोर्ट, और एक पेस्ट-के-लिए-तैयार command है; एक की-रहित ऑर्डर के लिए एक बार का root password पहली रीड पर लौटाया जाता है।

एजेंट्स के लिए नोट्स

  • /products को छोड़कर हर कॉल पर Authorization: Bearer <YOUR_BEARER> भेजें।
  • USDC/USDT (Base, Ethereum, Polygon) में चुकाएँ — कोई कार्ड ज़रूरी नहीं। प्रीपेड बैलेंस को प्राथमिकता दें ताकि चरण 3 एक कॉल हो।
  • संवेदनशील क्रियाएँ (order, reset-password, reinstall, cancel) दर-सीमित हैं; सामान्य उपयोग सीमाओं के भीतर ख़ूब है।
  • रॉ HTTP के बजाय टूल पसंद हैं? वही क्रियाएँ MCP टूल हैं — कनेक्ट गाइड और टूल संदर्भ देखें। पूरे दस्तावेज़: /docs।

FAQ

क्या मुझे एक MCP क्लाइंट चाहिए?

नहीं। यह HTTPS पर सादा REST है — curl, किसी भी भाषा, या एक एजेंट से जो HTTP बोलता हो, इस्तेमाल-योग्य। अगर आप MCP इस्तेमाल करते हैं, वही क्रियाएँ टूल के रूप में उजागर हैं (कनेक्ट गाइड देखें)।

auth कैसे काम करता है?

एक Bearer टोकन पाने के लिए /auth/register कॉल करें (कोई पासवर्ड नहीं)। इसे हर प्रमाणित कॉल पर हेडर Authorization: Bearer <token> के रूप में भेजें। /products सार्वजनिक है।

मैं कैसे भुगतान करूँ?

/balance/topup के ज़रिए एक प्रीपेड बैलेंस भरें (एक क्रिप्टो चेकआउट URL लौटाता है; USDC/USDT में चुकाएँ)। order फिर बैलेंस से काटता है। अगर बिना-फ़ंड, order एक इनवॉइस लौटाता है जो आप /invoices/{id}/pay के ज़रिए चुकाते हैं।

order जवाब में क्या होता है?

या तो एक service id वाला paid_from_balance (प्रोविज़निंग शुरू), या चुकाने के लिए एक इनवॉइस। GET /services/{id} तब तक पोल करें जब तक status active न हो, फिर SSH होस्ट, पोर्ट, और एक बार का root पासवर्ड पढ़ें।

टिप्पणियाँ

अभी तक कोई टिप्पणी नहीं। पहले बनें।

एक टिप्पणी छोड़ें

टिप्पणियाँ दिखने से पहले मॉडरेट की जाती हैं।