Σύνδεση του λογαριασμού σας

Πώς δένουν όλα μαζί

1. Πάρτε ένα token

Το πιο εύκολο: στον πίνακα ελέγχου ανοίξτε Ρυθμίσεις → API tokens, δημιουργήστε ένα token (ονομάστε το όπως τον agent, διαλέξτε λήξη) και αντιγράψτε το. Εμφανίζεται μόνο μία φορά.

Από τη γραμμή εντολών: συνδεθείτε με email και κωδικό για να πάρετε νέο token. Αν εγγραφήκατε με κωδικό στο email και δεν ορίσατε ποτέ κωδικό πρόσβασης, ορίστε έναν μία φορά με ένα token από τον πίνακα ελέγχου. Μπορείτε επίσης να δημιουργήσετε νέο λογαριασμό με POST /auth/register, που επιστρέφει αμέσως token.

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

Ένα token ισχύει 1 χρόνο (δείτε το token_expires_at στην απάντηση). Παρατείνετέ το με POST /auth/token/refresh· ανακαλέστε όσα δεν χρησιμοποιείτε πια στις Ρυθμίσεις.

2. Βάλτε το στη ρύθμιση

Κρατήστε το token έξω από τον κώδικα: κάντε το export ως EQVPS_API_KEY. Οι MCP clients το λαμβάνουν στην κεφαλίδα 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. Ξεκινήστε το πρώτο sandbox

Δημιουργία, εκτέλεση κώδικα, διαγραφή. Ένα 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: Sandboxes →

4. Πιστώστε το υπόλοιπο

Τα sandboxes και οι servers πληρώνονται από ένα κοινό προπληρωμένο υπόλοιπο. Πιστώστε το στον πίνακα ελέγχου (Υπόλοιπο: crypto, 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 — το token λείπει, έχει τυπογραφικό λάθος, έληξε ή ανακλήθηκε. Ελέγξτε την κεφαλίδα Authorization: Bearer, δημιουργήστε νέο token στις Ρυθμίσεις ή συνδεθείτε ξανά.
• 402 insufficient_balance — το υπόλοιπο είναι άδειο, οπότε δεν ξεκινά νέο sandbox. Πιστώστε και επαναλάβετε το αίτημα. Τα μόνιμα sandboxes που τρέχουν μπαίνουν σε παύση αντί να διαγραφούν.
• Τα 429 και 503 σημαίνουν ότι το αίτημα απορρίφθηκε πριν εκτελεστεί οτιδήποτε: περιμένετε το Retry-After και στείλτε το ξανά. 409 sandbox_paused: πιστώστε και το sandbox συνεχίζει.

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