Comandă un VPS în 4 apeluri API (ghid rapid REST pentru agenți)

Nu ai nevoie de un client MCP ca să folosești EQVPS — API-ul REST face tot ce-i trebuie unui agent. URL de bază: https://api.eqvps.com/api/v1/eqvps. Iată tot fluxul în patru apeluri.

0. (o singură dată) Alimentează un sold preplătit

Ca o comandă să fie un singur apel, alimentează întâi un sold. Plătește checkout-ul returnat în USDC/USDT:

curl -s -X POST https://api.eqvps.com/api/v1/eqvps/balance/topup \
  -H "Authorization: Bearer <YOUR_BEARER>" -H "Content-Type: application/json" \
  -d '{"amount": 25}'
# → { "checkout_url": "https://payram.eqvps.com/..." }  ← pay it in USDC/USDT

1. Înregistrare → Bearer token

curl -s -X POST https://api.eqvps.com/api/v1/eqvps/auth/register \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Ada","last_name":"Agent","email":"ada@example.com"}'
# → { "token": "<YOUR_BEARER>", "token_type": "Bearer", "user": {...} }

Fără parolă, fără pas uman. Păstrează tokenul; trimite-l ca Authorization: Bearer <YOUR_BEARER> mai jos.

2. Listează planurile → alege produsul și os_id (public)

curl -s https://api.eqvps.com/api/v1/eqvps/products
# → { "data": [ { "slug": "<product-slug>", "price": {...},
#       "specs": {...}, "available_os": [ { "id": <os_id>, "name": "Ubuntu 24.04" }, ... ] }, ... ] }

Alege un slug de plan și un os_id din available_os al acelui plan.

3. Comandă un VPS

curl -s -X POST https://api.eqvps.com/api/v1/eqvps/orders \
  -H "Authorization: Bearer <YOUR_BEARER>" -H "Content-Type: application/json" \
  -d '{"product":"<product-slug>","os_id":<os_id from list_plans>,"ssh_key":"ssh-ed25519 AAAA..."}'
# → paid from balance: { "paid_from_balance": true, "service_id": <id> }
#   or unfunded:       { "invoice": { "id": <id> } }  → pay: POST /invoices/{id}/pay → checkout_url

Trimite un ssh_key (cheie publică) pentru autentificare root cu cheie. Cu un sold alimentat, comanda e plătită instant și pornirea serverului începe.

4. Citește accesul

curl -s https://api.eqvps.com/api/v1/eqvps/services/<service-id> \
  -H "Authorization: Bearer <YOUR_BEARER>"
# → { "status": "active", "access": { "host": "...", "port": 22, "command": "ssh root@..." },
#     "password": "<shown once for keyless servers>" , ... }

Interoghează până când status e active. Blocul access are hostul SSH, portul și o command gata de lipit; pentru o comandă fără cheie, password-ul root de unică folosință e returnat la prima citire.

Note pentru agenți

• Trimite Authorization: Bearer <YOUR_BEARER> la fiecare apel, în afară de /products.
• Plătește în USDC/USDT (Base, Ethereum, Tron) — fără card. Preferă soldul preplătit, ca pasul 3 să fie un singur apel.
• Acțiunile sensibile (order, reset-password, reinstall, cancel) au limită de rată; utilizarea normală e mult sub limite.
• Preferi uneltele în locul HTTP-ului brut? Aceleași acțiuni sunt unelte MCP — vezi ghidul de conectare și referința uneltelor. Documentația completă: /docs.