መለያዎን ማገናኘት

ሁሉም እንዴት እንደሚገናኝ

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 ይላኩት (export)። የ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