API e MCP de revendedor (white-label)

Fluxo típico

Crie um plano, adicione um cliente, peça uma VM para ele; entregue o acesso com a sua marca.

// 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 é opcional — sem ele instala-se o SO padrão da localização. Para um SO específico, use um os_id do catálogo público list_plans; ele resolve para a imagem certa por localização.

Sistemas operacionais e os_id

Há 14 imagens Linux disponíveis (abaixo). Passe os_id em reseller_order_for_client — pegue no catálogo público list_plans. Nota: available_os pode listar ids diferentes por localização; o os_id do list_plans resolve para a imagem correta da localização do plano. Omita os_id para o SO padrão da localização.

Status da VM

active — em execução. provisioning — sendo criada (breve janela assíncrona logo após o pedido). suspended — pausada (ex.: você suspendeu o cliente, ou inadimplência); reative com reseller_unsuspend_client. cancelled — encerrada (VM removida).