−25%

la planurile Windows anuale, până pe 31 oct. Vezi planurile

EQVPS
Începe
REST API · MCP

API EQVPS

Te înregistrezi, alimentezi soldul cu cripto și comanzi un VPS doar din cod — fără KYC, fără om în buclă. Făcut pentru dezvoltatori și pentru agenți AI care își pornesc singuri serverele.

OpenAPI 3.1MCP live · 45 toolsBearer authREST + MCP
URL de bazăhttps://api.eqvps.com/api/v1/eqvps
Încearcă liveSpecificație OpenAPIReferință completă

Pornire rapidă

Patru apeluri: de la zero la un VPS care rulează. Tokenurile de mai jos sunt doar exemple — nu lipi niciodată un token real într-o pagină.

# 1. Înregistrare — întoarce un token Bearer (fără KYC, fără pas uman)
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. Alimentezi soldul — plătești în USDC / USDT / PYUSD, primești un URL de checkout
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://…" }   # plătești on-chain, soldul se încarcă automat
# 3. Comanzi un VPS — plătit din sold (slug + os_id din 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. Citești accesul SSH — parola root de unică folosință apare aici o singură dată
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" } }

Endpointuri principale

Partea esențială. Deschide exploratorul interactiv pentru fiecare parametru și răspuns.

POST/auth/registerCreează un cont și primești un token Bearer. Fără parolă, fără pas uman.
GET/productsLista tuturor planurilor VPS, cu specificații, preț și imagini OS suportate.
POST/balance/topupCreează o factură de alimentare în cripto; întoarce un URL de checkout. Soldul se încarcă la confirmarea on-chain.
POST/ordersComandă un VPS. Plătește din sold dacă ai fonduri, altfel întoarce o factură neplătită.
GET/services/{id}Stare completă + acces SSH live. Parola root de unică folosință apare aici o singură dată.
GET/balanceSoldul preplătit și moneda.

Vezi toate endpointurile, parametrii și schemele în exploratorul interactiv →

Pentru agenți AI

Un agent poate ajunge singur de la zero la un server funcțional — găsește planul, plătește, pornește serverul și citește datele SSH, totul prin API sau MCP.

MCP funcționează acum — nu e doar în plan.

Conectează orice client MCP la https://mcp.eqvps.com/mcp (Streamable HTTP). Cele 45 de unelte acoperă descoperirea, contul, plata și controlul complet al VPS-ului. Unelte publice: list_plans, register_account, login; restul cer un token Bearer.

Flux autonom

1. register_account → primești un token Bearer
2. topup_balance → plătești URL-ul de checkout în USDC/USDT
3. order_vps → pornești serverul din sold
4. get_vps_status → verifici până devine activ, citești datele SSH (host, port, comandă, parolă de unică folosință)

Resurse citibile de mașini

Sandbox-uri de cod pentru agenți AI

MicroVM-uri Linux izolate, care pornesc în aproximativ o secundă și rulează Python, Node.js și shell pentru agenții tăi. Facturare pe secundă din același sold cripto, de la $0.0165 pe oră. Le pornești cu SDK-ul, prin MCP sau REST.

pip install eqvps          # Python
npm i @eqvps/sdk           # TypeScript / JavaScript
# MCP: create_sandbox -> run_code / exec_command -> kill_sandbox

Încearcă sandbox-urile — $1 gratuit →Documentație și SDK pentru sandbox-uri →

Erori

Coduri de stare HTTP standard. La eșec, răspunsul conține un câmp message.

StareSemnificație
200 / 201OK — cererea a reușit / resursa a fost creată.
401Token Bearer lipsă sau invalid.
403Autentificat, dar nu ești proprietarul acestei resurse.
404Resursa nu a fost găsită.
409Conflict de stare (de ex. există deja o alimentare neplătită).
422Eroare de validare — verifică corpul cererii.
429Limită depășită — așteaptă și reîncearcă.

Limite de rată

Acțiunile sensibile (comandă, alimentare, resetare parolă, reinstalare, consolă) au limite pe cont. Automatizarea obișnuită rămâne mult sub limite; la un 429, așteaptă puțin și reîncearcă.

Începe acum

Ia specificația, deschide exploratorul sau citește referința completă, cu configurarea MCP.