API DO VIRTUALIZOR PARA REVENDA

Os 93 endpoints da API do painel, em português. Encontre o que precisa e monte o comando em curl, PHP, Python ou Node.js.

API do Virtualizor

Esta página é a busca. A documentação completa — autenticação, parâmetros, respostas e os cuidados de cada chamada — está na base de conhecimento. Comece pelo artigo API do Virtualizor para revendedores: primeiros passos.

O montador não pede a sua chave de API: o comando sai com $VIRT_KEY e $VIRT_PASS, para você preencher no seu servidor. Nada do que você digita aqui sai do navegador.

93 endpoints

  1. Ver a cota e o uso da conta Cloud

    act=cloudres GET Cloud Conta Cloud

    Mostra os recursos que a sua conta de revenda tem direito a usar e quanto já está em uso. É a primeira chamada a fazer antes de criar uma VPS: se a cota acabou, a criação falha.

    Ver no artigo
  2. Ver saldo, faturas e consumo (cobrança do Virtualizor)

    act=billing GET Cloud Conta Cloud

    Devolve o saldo, as faturas, as transações e o consumo por hora da conta, quando a cobrança interna do próprio Virtualizor está ligada.

    Ver no artigo
  3. Alterar nome e sobrenome do perfil

    act=profile POST Conta Cloud

    Atualiza o nome e o sobrenome da conta que está chamando a API.

    Ver no artigo
  4. Alterar idioma, tema e fuso horário do painel

    act=usersettings POST Conta Cloud

    Muda as preferências do painel da conta: idioma, tema (skin) e fuso horário. Sem `editsettings`, a chamada devolve as opções disponíveis.

    Ver no artigo
  5. Trocar a senha da conta

    act=userpassword POST Conta Cloud

    Troca a senha de acesso ao painel da conta que está chamando a API. Não mexe na senha de root de nenhuma VPS.

    Ver no artigo
  6. Ver os alertas de uma VPS

    act=system_alerts GET Conta Cloud

    Lista os alertas registrados para uma VPS, com os valores de CPU, RAM e disco no momento de cada um.

    Ver no artigo
  7. Listar os clientes da conta

    act=users POST Cloud Clientes

    Lista os usuários criados debaixo da sua conta Cloud, com a cota de cada um.

    Ver no artigo
  8. Criar um cliente

    act=adduser POST Cloud Clientes

    Cria um usuário do painel debaixo da sua conta. É o cliente que depois recebe VPS e acessa o painel com a sua marca.

    Ver no artigo
  9. Alterar e-mail ou senha de um cliente

    act=edituser POST Cloud Clientes

    Muda o e-mail de login e a senha de um cliente da sua conta.

    Ver no artigo
  10. Apagar um cliente

    act=users GET Cloud Clientes

    Remove um cliente da sua conta.

    Ver no artigo
  11. Gerar link de acesso sem senha (SSO)

    act=sso GET Clientes

    Gera um link que abre o painel de uma VPS já autenticado. Serve para pôr um botão "Gerenciar servidor" na sua área do cliente, sem o cliente digitar senha.

    Ver no artigo
  12. Listar as VPS

    act=listvs GET VPS

    Lista as VPS que a conta enxerga, com os recursos e o estado de cada uma.

    Ver no artigo
  13. Ver os detalhes de uma VPS

    act=vpsmanage GET VPS

    Devolve o estado e os detalhes de uma VPS: se está ligada, há quanto tempo, IPs, sistema e consumo de banda.

    Ver no artigo
  14. Criar uma VPS

    act=create POST Cloud VPS

    Cria uma VPS para um cliente, descontando os recursos da cota da sua conta Cloud. Sem `addvs`, nada é criado: a resposta traz os dados da tela de criação, como a cota livre e a lista de sistemas.

    Ver no artigo
  15. Mudar os recursos de uma VPS

    act=editvm POST Cloud VPS

    Altera hostname, disco, RAM, núcleos, banda, IPs e VNC de uma VPS da conta. A diferença entra ou sai da cota.

    Ver no artigo
  16. Apagar uma VPS

    act=listvs GET Cloud VPS

    Apaga uma VPS de vez, com o disco, e devolve os recursos dela à cota.

    Ver no artigo
  17. Configurar o escalonamento vertical

    act=vpsmanage POST VPS

    Define de quanto em quanto a RAM e os núcleos da VPS sobem ou descem quando o escalonamento vertical age. Disponível a partir do Virtualizor 3.1.3.

    Ver no artigo
  18. Ligar uma VPS

    act=start GET Energia e suspensão

    Liga uma VPS que está desligada.

    Ver no artigo
  19. Desligar uma VPS

    act=stop GET Energia e suspensão

    Pede o desligamento da VPS.

    Ver no artigo
  20. Reiniciar uma VPS

    act=restart GET Energia e suspensão

    Reinicia a VPS.

    Ver no artigo
  21. Forçar o desligamento de uma VPS

    act=poweroff GET Energia e suspensão

    Corta a energia da VPS, sem esperar o sistema fechar: o equivalente a tirar da tomada. Para quando o desligamento normal não responde.

    Ver no artigo
  22. Suspender uma VPS

    act=listvs GET Energia e suspensão

    Suspende a VPS: ela para e o cliente não consegue ligá-la. É o que se usa em inadimplência.

    Ver no artigo
  23. Reativar uma VPS suspensa

    act=listvs GET Energia e suspensão

    Tira a suspensão de uma VPS.

    Ver no artigo
  24. Suspender só a rede de uma VPS

    act=listvs GET Energia e suspensão

    Corta a rede da VPS sem desligá-la. Útil para conter um servidor que está atacando ou mandando spam, sem desligá-lo.

    Ver no artigo
  25. Reativar a rede de uma VPS

    act=listvs GET Energia e suspensão

    Devolve a rede a uma VPS que teve a rede suspensa.

    Ver no artigo
  26. Agendar ligar, desligar ou reiniciar

    act=self_shutdown POST Energia e suspensão

    Agenda uma ação de energia para data e hora marcadas: ligar, desligar, reiniciar ou forçar o desligamento.

    Ver no artigo
  27. Cancelar um agendamento

    act=self_shutdown POST Energia e suspensão

    Apaga uma ação de energia agendada.

    Ver no artigo
  28. Trocar o hostname

    act=hostname POST Configuração da VPS

    Muda o hostname da VPS.

    Ver no artigo
  29. Trocar a senha do root

    act=changepassword POST Configuração da VPS

    Troca a senha do root dentro da VPS.

    Ver no artigo
  30. Alterar ordem de boot, placa de rede e opções da VM

    act=hvmsettings POST Configuração da VPS

    Ajusta a máquina virtual: ordem de boot, ISO montada, modelo da placa de rede, teclado do VNC e opções como ACPI e aceleração de vídeo. Sem `hvmsettings`, a chamada devolve as opções aceitas.

    Ver no artigo
  31. Reinstalar o sistema operacional

    act=ostemplate POST Configuração da VPS

    Reinstala a VPS com o mesmo sistema ou com outro. Sem `reinsos`, a chamada devolve a lista de sistemas disponíveis.

    Ver no artigo
  32. Instalar um painel de controle

    act=controlpanel POST Configuração da VPS

    Instala um painel de hospedagem dentro da VPS.

    Ver no artigo
  33. Listar as aplicações do Webuzo

    act=webuzo GET Configuração da VPS

    Lista as aplicações que o Webuzo instala na VPS e se o Webuzo está liberado para ela.

    Ver no artigo
  34. Listar as receitas

    act=listrecipes GET Configuração da VPS

    Lista as receitas disponíveis para a VPS. Receita é um script que o Virtualizor roda dentro da VPS — para instalar um painel, configurar o firewall ou subir uma aplicação.

    Ver no artigo
  35. Executar uma receita

    act=listrecipes POST Configuração da VPS

    Executa uma ou mais receitas dentro da VPS.

    Ver no artigo
  36. Ver os dados de acesso ao VNC

    act=vnc GET Acesso de emergência

    Devolve o endereço, a porta e a senha do console VNC da VPS: a tela dela, acessível mesmo quando a rede ou o SSH caíram.

    Ver no artigo
  37. Trocar a senha do VNC

    act=vncpass POST Acesso de emergência

    Define uma senha nova para o console VNC da VPS. Só KVM.

    Ver no artigo
  38. Ligar o modo de resgate

    act=rescue POST Acesso de emergência

    Dá boot na VPS por um sistema de resgate, com o disco dela disponível para consertar: senha perdida, fstab errado, sistema que não sobe.

    Ver no artigo
  39. Desligar o modo de resgate

    act=rescue POST Acesso de emergência

    Volta a VPS a dar boot pelo próprio disco.

    Ver no artigo
  40. Listar as ISOs

    act=euiso GET Acesso de emergência

    Lista as imagens ISO que o usuário enviou e que podem ser montadas na VPS.

    Ver no artigo
  41. Adicionar uma ISO por URL

    act=addiso POST Acesso de emergência

    Baixa uma imagem ISO de uma URL para o servidor, para depois montá-la na VPS.

    Ver no artigo
  42. Apagar uma ISO

    act=euiso POST Acesso de emergência

    Remove uma ISO enviada pelo usuário.

    Ver no artigo
  43. Ver os IPs de uma VPS

    act=ips GET Rede

    Lista os endereços IPv4 e IPv6 atribuídos à VPS.

    Ver no artigo
  44. Ver as sub-redes IPv6 de uma VPS

    act=managesubnets GET Rede

    Mostra as sub-redes IPv6 atribuídas à VPS.

    Ver no artigo
  45. Listar o DNS reverso

    act=rdns GET Rede

    Lista os registros de DNS reverso (PTR) da conta: qual nome responde quando alguém consulta um IP seu.

    Ver no artigo
  46. Criar DNS reverso para um IP

    act=rdns POST Rede

    Define o nome que um IP da conta devolve na consulta reversa (registro PTR).

    Ver no artigo
  47. Apagar um DNS reverso

    act=rdns GET Rede

    Remove um registro de DNS reverso.

    Ver no artigo
  48. Listar os redirecionamentos de domínio

    act=managevdf GET Rede

    Lista os redirecionamentos de domínio da VPS. No redirecionamento, o servidor recebe o acesso a um hostname e porta e o repassa para um IP e porta da VPS — útil para publicar um site em VPS sem IP público próprio.

    Ver no artigo
  49. Criar um redirecionamento de domínio

    act=managevdf POST Rede

    Cria um redirecionamento de um hostname e porta de entrada para um IP e porta da VPS.

    Ver no artigo
  50. Alterar um redirecionamento de domínio

    act=managevdf POST Rede

    Altera um redirecionamento existente. Mande todos os campos, não só os que mudam.

    Ver no artigo
  51. Apagar redirecionamentos de domínio

    act=managevdf POST Rede

    Apaga um ou mais redirecionamentos de uma vez.

    Ver no artigo
  52. Listar as zonas de DNS

    act=pdns GET DNS

    Lista as zonas de DNS (os domínios) que a conta mantém no servidor de DNS do painel. A documentação oficial chama isto de "DNS Server".

    Ver no artigo
  53. Criar uma zona de DNS

    act=pdns POST DNS

    Cria a zona de um domínio, onde depois entram os registros.

    Ver no artigo
  54. Apagar uma zona de DNS

    act=pdns POST DNS

    Apaga a zona de um domínio, com todos os registros dela.

    Ver no artigo
  55. Ver os registros de uma zona

    act=managezone GET DNS

    Lista os registros de uma zona de DNS.

    Ver no artigo
  56. Criar um registro de DNS

    act=managezone POST DNS

    Cria um registro (A, AAAA, CNAME, MX, TXT…) numa zona.

    Ver no artigo
  57. Alterar um registro de DNS

    act=managezone POST DNS

    Altera um registro existente. Mande todos os campos, não só os que mudam.

    Ver no artigo
  58. Apagar um registro de DNS

    act=managezone POST DNS

    Apaga um registro de uma zona.

    Ver no artigo
  59. Listar as chaves SSH guardadas

    act=sshkeys GET Segurança

    Lista as chaves públicas SSH guardadas na conta, prontas para aplicar em VPS.

    Ver no artigo
  60. Guardar uma chave SSH

    act=addsshkey POST Segurança

    Guarda uma chave pública SSH na conta. Guardar não instala a chave em nenhuma VPS — para isso, use Aplicar chaves SSH numa VPS.

    Ver no artigo
  61. Alterar uma chave SSH guardada

    act=editsshkey POST Segurança

    Troca o nome ou a chave pública de uma chave guardada.

    Ver no artigo
  62. Apagar chaves SSH guardadas

    act=sshkeys POST Segurança

    Apaga uma ou mais chaves guardadas na conta.

    Ver no artigo
  63. Aplicar chaves SSH numa VPS

    act=sshkeys POST Segurança

    Instala chaves guardadas na conta dentro de uma VPS, para acesso por chave em vez de senha.

    Ver no artigo
  64. Gerar um par de chaves SSH

    act=create GET Segurança

    Gera um par de chaves SSH no servidor. O par serve para criar uma VPS com `ssh_options=generate_keys` (veja Criar uma VPS).

    Ver no artigo
  65. Listar os planos de firewall

    sem ação HTTP documentada GET Segurança

    Lista os planos de firewall criados pelo usuário e as regras de cada um.

  66. Criar um plano de firewall

    sem ação HTTP documentada POST Segurança

    Cria um plano de firewall com uma política padrão e regras de exceção.

  67. Alterar um plano de firewall

    sem ação HTTP documentada POST Segurança

    Altera o nome, a política padrão, a observação e as regras de um plano. Os campos de edição levam o prefixo `edit_`.

  68. Apagar planos de firewall

    sem ação HTTP documentada POST Segurança

    Apaga um ou mais planos de firewall.

  69. Listar as chaves de API

    act=apikey GET Segurança

    Lista as chaves de API da conta.

    Ver no artigo
  70. Criar uma chave de API

    act=apikey GET Segurança

    Cria uma chave de API nova. A primeira chave se cria pelo painel (veja Primeiros passos); daí em diante, dá para criar outras pela própria API — uma por sistema que acessa, por exemplo.

    Ver no artigo
  71. Apagar uma chave de API

    act=apikey POST Segurança

    Revoga uma chave de API. Use quando um sistema deixa de acessar o painel ou quando a chave pode ter vazado.

    Ver no artigo
  72. Listar os backups de uma VPS

    act=backup2 GET Backups e volumes

    Lista os backups de uma VPS e mostra quantos backups e restaurações ainda cabem no período.

    Ver no artigo
  73. Fazer um backup agora

    act=backup2 POST Backups e volumes

    Inicia um backup da VPS fora do agendamento.

    Ver no artigo
  74. Restaurar um backup

    act=backup POST Backups e volumes

    Restaura a VPS a partir de um backup. O processo roda em segundo plano e leva alguns minutos.

    Ver no artigo
  75. Apagar um backup

    act=backup POST Backups e volumes

    Apaga um backup da VPS.

    Ver no artigo
  76. Listar os volumes

    act=volume GET Cloud Backups e volumes

    Lista os volumes da conta Cloud: discos adicionais que se criam à parte e se ligam a uma VPS.

    Ver no artigo
  77. Criar um volume

    act=volume POST Cloud Backups e volumes

    Cria um volume e, se pedido, já o liga e monta numa VPS.

    Ver no artigo
  78. Ligar, desligar ou aumentar um volume

    act=volume POST Cloud Backups e volumes

    Liga um volume a uma VPS, tira de uma VPS ou muda o tamanho dele.

    Ver no artigo
  79. Apagar um volume

    act=volume POST Cloud Backups e volumes

    Apaga um volume, com os dados dele.

    Ver no artigo
  80. Ver o uso de RAM

    act=ram GET Monitoramento

    Mostra o uso de memória da VPS.

    Ver no artigo
  81. Ver o uso de CPU

    act=cpu GET Monitoramento

    Mostra o uso de processador da VPS.

    Ver no artigo
  82. Ver o uso de disco

    act=disk GET Monitoramento

    Mostra o uso de disco da VPS, em espaço e em inodes.

    Ver no artigo
  83. Ver o consumo de banda

    act=bandwidth POST Monitoramento

    Mostra o tráfego da VPS no mês, dia a dia. Sem `show`, vem o mês atual.

    Ver no artigo
  84. Ver o histórico de uso da VPS

    act=monitor GET Monitoramento

    Devolve o histórico de CPU, RAM e disco da VPS, para gráficos. Com `show`, o histórico de um mês.

    Ver no artigo
  85. Ver o histórico de estado da VPS

    act=statuslogs GET Monitoramento

    Lista os registros de estado da VPS ao longo do tempo.

    Ver no artigo
  86. Ver os logs da VPS

    act=logs GET Monitoramento

    Lista os logs de ações da VPS.

    Ver no artigo
  87. Ver as tarefas da VPS

    act=ctasks GET Monitoramento

    Lista, com detalhes, as tarefas executadas na VPS. Útil para conferir se uma operação que a API só iniciou, como reinstalação ou backup, já terminou.

    Ver no artigo
  88. Listar os processos da VPS

    act=processes GET Monitoramento

    Lista os processos que rodam dentro da VPS.

    Ver no artigo
  89. Encerrar processos da VPS

    act=processes POST Monitoramento

    Encerra um ou mais processos dentro da VPS, pelo PID.

    Ver no artigo
  90. Listar os serviços da VPS

    act=services GET Monitoramento

    Lista os serviços da VPS e diz quais estão rodando e quais sobem no boot.

    Ver no artigo
  91. Iniciar serviços

    act=services POST Monitoramento

    Inicia um ou mais serviços dentro da VPS.

    Ver no artigo
  92. Parar serviços

    act=services POST Monitoramento

    Para um ou mais serviços dentro da VPS.

    Ver no artigo
  93. Reiniciar serviços

    act=services POST Monitoramento

    Reinicia um ou mais serviços dentro da VPS.

    Ver no artigo

Texto da Vitt Host, escrito a partir da documentação oficial da Virtualizor, lida em 07/10/2026. O catálogo também está em JSON.