API e MCP rivenditori (white-label)

Flusso tipico

Crea un piano, aggiungi un cliente, ordina una VM per lui; consegna l'accesso dal tuo 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, location, markup })
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 è facoltativo — ometti per l'OS predefinito della località. Per un OS specifico, usa un os_id dal catalogo pubblico list_plans; si risolve nell'immagine giusta per località.

Sistemi operativi e os_id

Sono disponibili 14 immagini Linux (sotto). Passa os_id in reseller_order_for_client — prendilo dal catalogo pubblico list_plans. Nota: available_os può elencare id diversi per località; l'os_id da list_plans si risolve nell'immagine corretta per la località del piano. Ometti os_id per usare l'OS predefinito della località.

Stati della VM

active — in esecuzione. provisioning — in creazione (breve finestra asincrona subito dopo l'ordine). suspended — in pausa (es. hai sospeso il cliente, o mancato pagamento); riattiva con reseller_unsuspend_client. cancelled — terminata (VM rimossa).