API și MCP pentru revânzători (white-label)

Flux tipic

Creezi un plan, adaugi un client, comanzi un VM pentru el; livrezi accesul sub propriul brand.

// Reseller token (rk_...) from the Partners cabinet -> Authorization: Bearer rk_...
// One MCP endpoint, role-filtered: a reseller token exposes the 30 reseller_* tools.
reseller_create_plan({ name, cores, ram_gb, disk_gb, ipv4, ipv6, locations, markup_price })   // ipv4 0-4, ipv6 0-1, at least one
reseller_add_client({ email }) -> { client_id }
reseller_order_for_client({ plan_id, client_id, os_id? })   // os_id: see list_plans catalog
reseller_vm_details({ service_id }) -> { access, password }  // deliver to your client

os_id este opțional — omite-l pentru OS-ul implicit al locației. Pentru un anumit OS, folosește un os_id din catalogul public list_plans; se transformă în imaginea corectă pentru fiecare locație.

Sisteme de operare și os_id

Sunt disponibile 14 imagini Linux (mai jos). Trimiți os_id în reseller_order_for_client — îl iei din catalogul public list_plans. Atenție: available_os poate lista id-uri diferite pentru fiecare locație; os_id din list_plans se transformă în imaginea corectă pentru locația planului. Omite os_id ca să folosești OS-ul implicit al locației.

Stările VM-urilor

active — rulează. provisioning — se creează (o scurtă fereastră asincronă imediat după comandă). suspended — pus pe pauză (de exemplu ai suspendat clientul sau neplată); reactivezi cu reseller_unsuspend_client. cancelled — încheiat (VM eliminat).

Conectezi orice agent sau unealtă

Un singur endpoint MCP — mcp.eqvps.com/mcp — cu autentificare prin tokenul de revânzător. Îl conectezi la ce folosești deja.

# Claude Code - add the reseller MCP server (token: Partners cabinet -> API)
claude mcp add --transport http eqvps-reseller https://mcp.eqvps.com/mcp \
  --header "Authorization: Bearer rk_YOUR_RESELLER_TOKEN"

// Claude Desktop / Cursor / Windsurf - mcp.json
{
  "mcpServers": {
    "eqvps-reseller": {
      "type": "http",
      "url": "https://mcp.eqvps.com/mcp",
      "headers": { "Authorization": "Bearer rk_YOUR_RESELLER_TOKEN" }
    }
  }
}

# LangChain / LangGraph (Python) - langchain-mcp-adapters
from langchain_mcp_adapters.client import MultiServerMCPClient
client = MultiServerMCPClient({"eqvps": {"transport": "streamable_http",
  "url": "https://mcp.eqvps.com/mcp",
  "headers": {"Authorization": "Bearer rk_YOUR_RESELLER_TOKEN"}}})
tools = await client.get_tools()   # 30 reseller_* tools

# Raw MCP (JSON-RPC) - n8n HTTP, Zapier/Make, cURL, any language
curl -X POST https://mcp.eqvps.com/mcp \
  -H "Authorization: Bearer rk_YOUR_RESELLER_TOKEN" -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
        "name":"reseller_order_for_client","arguments":{"client_id":123,"plan_id":45}}}'
# List tools first: {"jsonrpc":"2.0","id":1,"method":"tools/list"}

Prompturi gata de folosit pentru agenți

Reînnoire automată

Serverele clienților se reînnoiesc fără muncă manuală. reseller_set_autorenew o activează sau o dezactivează pentru fiecare VM (ACTIVĂ implicit); un job zilnic reînnoiește din soldul en-gros tot ce expiră în următoarele 3 zile. Reînnoiești acum pentru N perioade cu reseller_renew (1–24 de luni). Dacă soldul nu ajunge, primești o singură alertă și perioada obișnuită de grație — niciodată o pierdere pe tăcute.

Testare sandbox (dry-run)

Trimite test: true la reseller_order_for_client (sau POST /api/reseller/orders cu {"test":true}) pentru un dry-run: primești un răspuns simulat cu structură identică unei comenzi reale, dar nu se creează niciun VM și nu se debitează nimic din sold. Îl folosești ca să verifici de la cap la coadă integrarea API/MCP înainte de lansare.

Notificări prin e-mail către clienți

Implicit, EQVPS trimite e-mailuri contului la creare/suspendare/încheiere/parolă/reinstalare. În cabinetul revânzătorului poți dezactiva „Notify clients by email” ca să te ocupi singur de notificările către clienți (white-label) — crearea serverelor și reînnoirile funcționează în continuare, doar fără mesaje.