অ্যাকাউন্ট যুক্ত করা

সবকিছু কীভাবে মেলে

১. টোকেন নিন

সবচেয়ে সহজ: ড্যাশবোর্ডে সেটিংস → 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 দিয়ে মেয়াদ বাড়ান; যেগুলো আর ব্যবহার করেন না সেগুলো সেটিংসে বাতিল করুন।

২. এটি কনফিগে বসান

টোকেন কোডের বাইরে রাখুন: 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>" }
    }
  }
}

৩. প্রথম স্যান্ডবক্স চালান

তৈরি করুন, কোড চালান, মুছে ফেলুন। শূন্য নয় এমন 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 উদাহরণ: স্যান্ডবক্স →

৪. ব্যালেন্স টপ-আপ করুন

স্যান্ডবক্স আর সার্ভার একটি প্রিপেইড ব্যালেন্স থেকে চলে। ড্যাশবোর্ডে টপ-আপ করুন (ব্যালেন্স: ক্রিপ্টো, 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