अकाउंट जोड़ना

सब कुछ कैसे जुड़ता है

1. टोकन लें

सबसे आसान: डैशबोर्ड में सेटिंग्स → API टोकन खोलें, एक टोकन बनाएँ (एजेंट के नाम पर रखें, अवधि चुनें) और कॉपी करें। यह सिर्फ़ एक बार दिखाया जाता है।

कमांड लाइन से: नया टोकन पाने के लिए ईमेल और पासवर्ड से लॉग इन करें। अगर आपने ईमेल कोड से साइन अप किया था और कभी पासवर्ड नहीं रखा, तो डैशबोर्ड के टोकन से एक बार पासवर्ड रख लें। नया अकाउंट POST /auth/register से भी बन सकता है, जो तुरंत टोकन लौटाता है।

# log in with email + password → token
curl -s https://api.eqvps.com/api/v1/eqvps/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","password":"your-password"}'
# → {"token":"eyJ0…","token_type":"Bearer","token_expires_at":"2027-10-03T…","user":{…}}

# signed up with an email code and have no password? set one once
# (authorise with a token from Settings → API tokens)
curl -s https://api.eqvps.com/api/v1/eqvps/auth/set-password \
  -H "Authorization: Bearer $EQVPS_API_KEY" -H "Content-Type: application/json" \
  -d '{"password":"new-pass-123","password_confirmation":"new-pass-123"}'

# no account yet: register straight from the API (password is optional)
curl -s https://api.eqvps.com/api/v1/eqvps/auth/register \
  -H "Content-Type: application/json" -d '{"email":"you@example.com"}'

# extend a token before it expires
curl -s -X POST https://api.eqvps.com/api/v1/eqvps/auth/token/refresh \
  -H "Authorization: Bearer $EQVPS_API_KEY"

टोकन 1 साल के लिए मान्य है (जवाब में token_expires_at देखें)। POST /auth/token/refresh से बढ़ाएँ; जो इस्तेमाल नहीं करते उन्हें सेटिंग्स में रद्द करें।

2. इसे कॉन्फ़िग में डालें

टोकन को कोड से बाहर रखें: इसे EQVPS_API_KEY के रूप में एक्सपोर्ट करें। MCP क्लाइंट इसे Authorization हेडर में पाते हैं।

# shell / CI secret — keep it out of the code
export EQVPS_API_KEY="eyJ0…"

# SDKs read the same variable (0.2.0+: give your code its secrets as env, not in the source)
pip install -U eqvps         # Python
npm i @eqvps/sdk@latest      # TypeScript / JavaScript

# Claude Code
claude mcp add --transport http eqvps https://mcp.eqvps.com/mcp \
  --header "Authorization: Bearer $EQVPS_API_KEY"

# Cursor, Claude Desktop, other MCP clients (mcp.json)
{
  "mcpServers": {
    "eqvps": {
      "type": "streamable-http",
      "url": "https://mcp.eqvps.com/mcp",
      "headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
    }
  }
}

3. पहला सैंडबॉक्स चलाएँ

बनाएँ, कोड चलाएँ, हटाएँ। शून्य से अलग exit_code आपकी कमांड का सामान्य नतीजा है, HTTP त्रुटि नहीं।

API=https://api.eqvps.com/api/v1/eqvps
H="Authorization: Bearer $EQVPS_API_KEY"

SB=$(curl -s -X POST $API/sandboxes -H "$H" -H "Content-Type: application/json" \
  -d '{"tariff":"micro"}' | python3 -c 'import sys,json; print(json.load(sys.stdin)["id"])')

curl -s -X POST $API/sandboxes/$SB/run -H "$H" -H "Content-Type: application/json" \
  -d '{"language":"bash","code":"uname -sr && python3 --version && node --version"}'
# → {"exit_code":0,"stdout":"Linux 6.1…\nPython 3.12…\nv22…\n","stderr":"",…}

curl -s -X DELETE $API/sandboxes/$SB -H "$H"

मोड, टैरिफ़ और Python / Node.js उदाहरण: सैंडबॉक्स →

4. बैलेंस टॉप-अप करें

सैंडबॉक्स और सर्वर एक ही प्रीपेड बैलेंस से चलते हैं। इसे डैशबोर्ड में टॉप-अप करें (बैलेंस: क्रिप्टो, Monero या प्रोमो कोड) या POST /balance/topup से, जो भुगतान का लिंक लौटाता है। GET /balance बताता है कितना बचा है।

curl -s $API/balance -H "$H"
# → {"balance":12.4,"currency":"USD","promo_balance":0,"real_balance":12.4,"promo_scope":"sandboxes"}

curl -s -X POST $API/balance/topup -H "$H" -H "Content-Type: application/json" -d '{"amount":10}'
# → {"invoice_id":…,"checkout_url":"https://…"}   open the link and pay with crypto

त्रुटियाँ जो आपको शायद दिखेंगी

• 401 Unauthenticated — टोकन नहीं है, उसमें टाइपो है, उसकी अवधि खत्म हो गई है या वह रद्द है। Authorization: Bearer हेडर जाँचें, सेटिंग्स में नया टोकन बनाएँ या फिर से लॉग इन करें।
• 402 insufficient_balance — बैलेंस खाली है, इसलिए नया सैंडबॉक्स शुरू नहीं होता। टॉप-अप करें और अनुरोध दोहराएँ। चल रहे स्थायी सैंडबॉक्स हटाए नहीं जाते, रोक दिए जाते हैं।
• 429 और 503 का मतलब है कि अनुरोध कुछ भी चलने से पहले ठुकरा दिया गया: Retry-After तक रुकें और फिर से भेजें। 409 sandbox_paused: टॉप-अप करें, सैंडबॉक्स फिर चल पड़ेगा।

HTTP 401  {"message":"Unauthenticated."}
HTTP 402  {"error":"insufficient_balance","message":"Your balance cannot cover this sandbox. Top up (topup_balance / POST /balance/topup) and retry."}
HTTP 429  {"error":"too_many_concurrent", …}      → wait Retry-After, then retry
HTTP 503  {"error":"capacity","retry_after":30, …} → wait Retry-After, then retry