Como cada recurso funciona — e como automatizar pela API
Consulta pública para clientes e desenvolvedores: o passo a passo de cada tela do painel e a referência das rotas da API, com exemplos prontos para copiar.
Domínios
Domínios, subdomínios e redirecionamentos
Cada conta tem um domínio principal e pode ter domínios adicionais (com pasta própria), domínios estacionados (apontam para o mesmo site), subdomínios e redirecionamentos 301/302. Todo domínio novo já nasce com zona DNS e certificado SSL automático.
Como usar no painel
Abra Domínios no menu lateral e escolha o tipo: adicional, estacionado ou subdomínio.
Informe o nome e, se for o caso, a pasta do site.
Aguarde o status mudar de “Provisionando” para “Ativo”.
Para redirecionar, use Domínios → Redirecionamentos.
Ao excluir um domínio, tudo o que depende dele é removido em definitivo: pasta, zona DNS, certificado e contas de e-mail. O painel sempre pede confirmação antes.
O G-Painel tem DNS autoritativo próprio. Você edita registros A, AAAA, CNAME, MX, TXT, SRV e CAA com TTL por registro, e o painel publica SPF, DKIM e DMARC para o e-mail.
Como usar no painel
Abra Domínios → Editor de Zona.
Escolha o domínio e clique em Adicionar registro.
Preencha tipo, nome, valor e TTL.
Salve: a alteração é publicada em segundos.
Prefere a Cloudflare? Conecte sua conta em Domínios → Cloudflare e gerencie as zonas de lá.
Conecte uma ou mais contas Cloudflare usando um token de API. O painel lista suas zonas, permite criar e editar registros DNS e configurar health checks para monitorar endereços.
Como usar no painel
Na Cloudflare, crie um token de API com permissão de edição de DNS.
No G-Painel, abra Domínios → Cloudflare e clique em Conectar conta.
Cole o token: o painel valida e mostra as zonas.
Gerencie registros e health checks direto pelo painel.
O token fica cifrado no servidor e nunca é mostrado de novo. Cada conta Cloudflare fica isolada no cliente que a conectou.
Crie caixas postais com cota própria, encaminhadores, conta pega-tudo e respostas automáticas. O Webmail funciona no endereço do seu domínio e o antispam filtra as mensagens.
Como usar no painel
Abra E-mail → Contas de E-mail e clique em Nova conta de e-mail.
Escolha o domínio, o nome e a senha.
Defina a cota em MB (ou ilimitada).
Use Configurar em Cliente de E-mail para ver os dados de IMAP e SMTP.
Cada domínio recebe certificado próprio para IMAP e SMTP, renovado automaticamente.
Envie arquivos arrastando para a tela, com barra de progresso, edite com realce de sintaxe, compacte, extraia, ajuste permissões e recupere da lixeira. Contas FTP com FTPS por domínio.
Como usar no painel
Abra Arquivos → Gerenciador de Arquivos.
Arraste arquivos ou pastas do computador para a lista.
Clique com o botão direito para copiar, mover, compactar ou editar.
Itens excluídos vão para a lixeira e podem ser restaurados.
O limite de envio por arquivo é definido pelo administrador no WHM.
Faça backups completos da conta (arquivos, e-mails e bancos) manualmente ou por agendamento diário, semanal ou mensal. Envie para o próprio servidor, FTP, SFTP ou qualquer armazenamento compatível com S3: Amazon S3, Cloudflare R2, Backblaze B2, Wasabi, DigitalOcean Spaces e MinIO.
Como usar no painel
Abra Arquivos → Backup e cadastre um destino (Local, FTP, SFTP ou S3).
Em Agendamento automático, escolha a frequência e o horário (UTC).
Defina a retenção: quantas cópias manter (1 a 90).
Para restaurar, escolha o backup e clique em Restaurar — ou envie um arquivo do seu computador.
Um destino em uso por um agendamento não pode ser excluído. As cópias antigas além da retenção são apagadas sozinhas, inclusive no destino remoto.
Instale WordPress, Joomla, Drupal, PrestaShop, OpenCart, Zen Cart, Dolibarr, phpBB, Nextcloud e outros em um clique, em qualquer domínio, subdomínio ou pasta.
Como usar no painel
Abra Software → Instalador de Apps.
Escolha o aplicativo e o destino.
Informe o usuário administrador do app.
O painel cria o banco e instala a versão mais recente.
O Fail2Ban protege SSH, e-mail e sites e detecta sozinho varreduras em busca de arquivos sensíveis. Na área do cliente há bloqueador de IP, proteção contra hotlink e privacidade de diretório por domínio.
Como usar no painel
Abra Segurança → Bloqueador de IP para negar acesso de um IP ou faixa ao seu site.
Use Proteção contra Hotlink para impedir que outros sites usem suas imagens.
Proteja uma pasta com usuário e senha em Privacidade de Diretório.
Revise suas sessões abertas em Minha Conta e encerre as que não reconhecer.
Bloqueios de servidor, IPs confiáveis e eventos do firewall são gerenciados pelo administrador no WHM.
Crie chaves de API com escopos limitados para integrar seus sistemas ao painel. Aplicativos OAuth e webhooks, que avisam seu sistema quando algo acontece, são configurados pelo administrador do servidor no WHM.
Como usar no painel
Abra Avançado → Desenvolvedor.
Crie uma API Key e marque só os escopos necessários.
Copie a chave: ela é exibida uma única vez.
Use-a no cabeçalho Authorization das requisições.
Chaves de cliente nunca recebem escopos de administração do servidor.
Todas as rotas usam o endereço do seu servidor G-Painel e um token no cabeçalho Authorization: Bearer — o token de login, uma API Key ou um token OAuth. Crie uma API Key na área do cliente, em Avançado → Desenvolvedor.
Esta página reúne as rotas de uso do cliente e de API Keys. A documentação completa — incluindo contas, planos, firewall, webhooks, OAuth e servidor — está disponível e sempre atualizada dentro do WHM, em Outros → Documentação, para o administrador do seu servidor G-Painel.
Área:
Clienteconta do cliente ou API KeyAutenticadoqualquer usuário logadoPúblicasem login⟳ assíncronaresponde em provisioning
As descrições das rotas da API estão em português.
Autenticação
Login com token de acesso curto (15 min) e refresh que gira a cada uso, sessões revogáveis na hora, API Keys com escopos e OAuth client_credentials.
Operações assíncronas
Criar site, e-mail ou banco responde em provisioning. Consulte o recurso até ficar active.
Idempotência e erros
Envie Idempotency-Key para repetir uma criação sem duplicar. Erros sempre em JSON, com mensagem em português.
Webhooks
16 eventos assinados com HMAC, configurados pelo administrador no WHM. Verifique a assinatura antes de confiar na mensagem; entregas com falha podem ser reenviadas.
Paginação e exclusão
Listas aceitam limit e offset. Excluir um recurso remove tudo o que depende dele, em definitivo.
OpenAPI e Exportar para IA
A especificação OpenAPI 3 completa e o arquivo “Exportar para IA” — com regras e prompts prontos para um assistente criar integrações — ficam no WHM, em Outros → Documentação.