Kuunganisha akaunti yako

Jinsi yote yanavyoungana

1. Pata tokeni

Rahisi zaidi: kwenye dashibodi fungua Mipangilio → Tokeni za API, unda tokeni (ipe jina la wakala, chagua muda wa kuisha) kisha uinakili. Huonyeshwa mara moja tu.

Kutoka kwenye mstari wa amri: ingia kwa barua pepe na nenosiri ili kupata tokeni mpya. Ikiwa ulijisajili kwa msimbo wa barua pepe na hukuwahi kuweka nenosiri, liweke mara moja ukitumia tokeni kutoka dashibodi. Unaweza pia kuunda akaunti mpya kwa POST /auth/register, ambayo hurudisha tokeni papo hapo.

# 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"

Tokeni ni halali kwa mwaka 1 (angalia token_expires_at kwenye jibu). Iongezee muda kwa POST /auth/token/refresh; batilisha zisizotumika tena kwenye Mipangilio.

2. Iweke kwenye usanidi

Usiweke tokeni kwenye msimbo: isafirishe kama EQVPS_API_KEY. Wateja wa MCP huipata kwenye kichwa cha 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. Anzisha sandbox ya kwanza

Unda, endesha msimbo, futa. exit_code isiyo sifuri ni matokeo ya kawaida ya amri yako, si kosa la 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"

Hali, mipango na mifano ya Python / Node.js: Sandbox →

4. Ongeza salio

Sandbox na seva hulipwa kutoka salio moja la kulipia mapema. Liongeze kwenye dashibodi (Salio: kripto, Monero au msimbo wa ofa) au kwa POST /balance/topup, ambayo hurudisha kiungo cha malipo. GET /balance huonyesha kiasi kilichobaki.

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

Makosa utakayokutana nayo zaidi

• 401 Unauthenticated — tokeni haipo, ina makosa ya kuandika, imeisha muda au imebatilishwa. Angalia kichwa cha Authorization: Bearer, unda tokeni mpya kwenye Mipangilio au ingia tena.
• 402 insufficient_balance — salio ni tupu, kwa hiyo sandbox mpya haiwezi kuanza. Ongeza salio kisha rudia ombi. Sandbox za kudumu zinazoendelea husitishwa badala ya kufutwa.
• 429 na 503 maana yake ombi lilikataliwa kabla chochote hakijaendeshwa: subiri Retry-After kisha ulitume tena. 409 sandbox_paused: ongeza salio na sandbox itaendelea.

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