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.
https://api.eqvps.com/api/v1/eqvpsAvvio 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.
/auth/registerCrea un account e ottieni un Bearer token. Niente password, nessun passo umano manuale./productsElenca tutti i piani VPS con specifiche, prezzi e le immagini OS supportate./balance/topupCrea una fattura di ricarica in crypto; restituisce un URL di pagamento. Il saldo viene accreditato alla conferma on-chain./ordersOrdina un VPS. Paga dal saldo se ricaricato, altrimenti restituisce una fattura non pagata./services/{id}Stato completo + accesso SSH live. La password root usa-e-getta viene mostrata qui una volta./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.
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.