EQVPS
Inizia
REST API · MCP

EQVPS API

Registrati, ricarica in crypto e ordina un VPS interamente via codice — niente KYC, nessun umano nel ciclo. Costruito per sviluppatori e per gli AI agent che provisionano i propri server.

OpenAPI 3.1MCP live · 26 toolsBearer authREST + MCP
URL di basehttps://api.eqvps.com/api/v1/eqvps
Prova liveSpecifica OpenAPIRiferimento completo

Avvio rapido

Quattro chiamate: da zero a un VPS in funzione. I token sotto sono placeholder — non incollare mai un token reale su una pagina.

# 1. Register — returns a Bearer token (no KYC, no human step)
curl -X POST https://api.eqvps.com/api/v1/eqvps/auth/register \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Ada","last_name":"Agent","email":"agent@example.com"}'
# → { "token": "<YOUR_API_TOKEN>" }
# 2. Top up balance — pay in USDC / USDT / PYUSD, get a checkout URL
curl -X POST https://api.eqvps.com/api/v1/eqvps/balance/topup \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"amount":20}'
# → { "checkout_url": "https://…" }   # pay on-chain, balance credits automatically
# 3. Order a VPS — paid from balance (get slug + os_id from GET /products)
curl -X POST https://api.eqvps.com/api/v1/eqvps/orders \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"product":"micro","os_id":1,"ssh_key":"ssh-ed25519 AAAA…"}'
# 4. Read SSH access — one-time root password is shown once here
curl https://api.eqvps.com/api/v1/eqvps/services/SV-XXXXXX \
  -H "Authorization: Bearer <YOUR_API_TOKEN>"
# → { "status":"active", "ssh": { "host":"…", "port":22, "command":"ssh root@… -p 22" } }

Endpoint principali

La superficie core. Apri l'explorer interattivo per ogni parametro e risposta.

POST/auth/registerCrea un account e ottieni un Bearer token. Niente password, nessun passo umano manuale.
GET/productsElenca tutti i piani VPS con specifiche, prezzi e le immagini OS supportate.
POST/balance/topupCrea una fattura di ricarica in crypto; restituisce un URL di pagamento. Il saldo viene accreditato alla conferma on-chain.
POST/ordersOrdina un VPS. Paga dal saldo se ricaricato, altrimenti restituisce una fattura non pagata.
GET/services/{id}Stato completo + accesso SSH live. La password root usa-e-getta viene mostrata qui una volta.
GET/balanceSaldo di credito prepagato e valuta.

Vedi ogni endpoint, parametro e schema nell'explorer interattivo →

Per gli AI agent

Un agente può andare da solo da zero a un server in funzione — scoprire, pagare, provisionare e leggere l'SSH, tutto tramite API o MCP.

MCP è live — non previsto.

Punta qualsiasi client MCP a https://mcp.eqvps.com/mcp (Streamable HTTP). 26 tool coprono scoperta, account, pagamento e controllo completo del VPS. Tool pubblici: list_plans, register_account, login; tutto il resto richiede un Bearer token.

Flusso automatico

1. register_account → ottieni un Bearer token
2. topup_balance → paga l'URL di checkout in USDC/USDT
3. order_vps → provisiona dal saldo
4. get_vps_status → fai polling finché active, leggi l'SSH (host, port, comando, password usa-e-getta)

Risorse leggibili dalla macchina

Errori

Codici di stato HTTP standard. I body portano un campo message in caso di errore.

StatoSignificato
200 / 201OK — request succeeded / resource created.
401Missing or invalid Bearer token.
403Authenticated, but not the owner of this resource.
404Resource not found.
409State conflict (e.g. an unpaid top-up already exists).
422Validation error — check the request body.
429Rate limited — back off and retry.

Rate limit

Le azioni sensibili (ordine, ricarica, reset password, reinstallazione, console) sono rate-limited per account. L'automazione normale sta comodamente entro i limiti; a un 429, fai back off e riprova.

Inizia a costruire ora

Prendi la specifica, apri l'explorer, o leggi il riferimento narrativo completo con il setup MCP.