Cómo funciona cada función — y cómo automatizarla con la API
Consulta pública para clientes y desarrolladores: el paso a paso de cada pantalla del panel y la referencia de las rutas de la API, con ejemplos listos para copiar.
Dominios
Dominios, subdominios y redirecciones
Cada cuenta tiene un dominio principal y puede tener dominios adicionales (con carpeta propia), dominios aparcados (apuntan al mismo sitio), subdominios y redirecciones 301/302. Cada dominio nuevo ya nace con zona DNS y certificado SSL automático.
Cómo usarlo en el panel
Abre Dominios en el menú lateral y elige el tipo: adicional, aparcado o subdominio.
Indica el nombre y, si corresponde, la carpeta del sitio.
Espera a que el estado cambie de “Aprovisionando” a “Activo”.
Para redirigir, usa Dominios → Redirecciones.
Al eliminar un dominio, todo lo que depende de él se borra de forma definitiva: carpeta, zona DNS, certificado y cuentas de correo. El panel siempre pide confirmación antes.
G-Painel tiene DNS autoritativo propio. Editas registros A, AAAA, CNAME, MX, TXT, SRV y CAA con TTL por registro, y el panel publica SPF, DKIM y DMARC para el correo.
Cómo usarlo en el panel
Abre Dominios → Editor de zona.
Elige el dominio y haz clic en Añadir registro.
Completa tipo, nombre, valor y TTL.
Guarda: el cambio se publica en segundos.
¿Prefieres Cloudflare? Conecta tu cuenta en Dominios → Cloudflare y gestiona las zonas desde allí.
Conecta una o más cuentas de Cloudflare con un token de API. El panel lista tus zonas, permite crear y editar registros DNS y configurar health checks para monitorear direcciones.
Cómo usarlo en el panel
En Cloudflare, crea un token de API con permiso de edición de DNS.
En G-Painel, abre Dominios → Cloudflare y haz clic en Conectar cuenta.
Pega el token: el panel lo valida y muestra las zonas.
Gestiona registros y health checks directamente desde el panel.
El token se guarda cifrado en el servidor y nunca vuelve a mostrarse. Cada cuenta de Cloudflare queda aislada en el cliente que la conectó.
Crea buzones con cuota propia, reenvíos, cuenta comodín y respuestas automáticas. El Webmail funciona en la dirección de tu dominio y el antispam filtra los mensajes.
Cómo usarlo en el panel
Abre Correo → Cuentas de correo y haz clic en Nueva cuenta de correo.
Elige el dominio, el nombre y la contraseña.
Define la cuota en MB (o ilimitada).
Usa Configurar cliente de correo para ver los datos de IMAP y SMTP.
Cada dominio recibe su propio certificado para IMAP y SMTP, renovado automáticamente.
Sube archivos arrastrándolos a la pantalla, con barra de progreso; edítalos con resaltado de sintaxis, comprime, extrae, ajusta permisos y recupera desde la papelera. Cuentas FTP con FTPS por dominio.
Cómo usarlo en el panel
Abre Archivos → Administrador de archivos.
Arrastra archivos o carpetas de tu ordenador a la lista.
Haz clic derecho para copiar, mover, comprimir o editar.
Los elementos eliminados van a la papelera y pueden restaurarse.
El límite de subida por archivo lo define el administrador en el WHM.
Haz copias completas de la cuenta (archivos, correos y bases de datos) de forma manual o programada a diario, semanal o mensualmente. Envíalas al propio servidor, FTP, SFTP o cualquier almacenamiento compatible con S3: Amazon S3, Cloudflare R2, Backblaze B2, Wasabi, DigitalOcean Spaces y MinIO.
Cómo usarlo en el panel
Abre Archivos → Backup y registra un destino (Local, FTP, SFTP o S3).
En Programación automática, elige la frecuencia y la hora (UTC).
Define la retención: cuántas copias conservar (1 a 90).
Para restaurar, elige el backup y haz clic en Restaurar — o sube un archivo desde tu ordenador.
Un destino en uso por una programación no puede eliminarse. Las copias que superan la retención se borran solas, también en el destino remoto.
Instala WordPress, Joomla, Drupal, PrestaShop, OpenCart, Zen Cart, Dolibarr, phpBB, Nextcloud y otros en un clic, en cualquier dominio, subdominio o carpeta.
Cómo usarlo en el panel
Abre Software → Instalador de apps.
Elige la aplicación y el destino.
Indica el usuario administrador de la aplicación.
El panel crea la base de datos e instala la versión más reciente.
Fail2Ban protege SSH, correo y sitios y detecta automáticamente escaneos en busca de archivos sensibles. En el área de cliente hay bloqueador de IP, protección contra hotlink y privacidad de directorios por dominio.
Cómo usarlo en el panel
Abre Seguridad → Bloqueador de IP para denegar el acceso de una IP o rango a tu sitio.
Usa Protección contra hotlink para impedir que otros sitios usen tus imágenes.
Protege una carpeta con usuario y contraseña en Privacidad de directorios.
Revisa tus sesiones abiertas en Mi cuenta y cierra las que no reconozcas.
Los bloqueos del servidor, las IP de confianza y los eventos del firewall los gestiona el administrador en el WHM.
Crea claves de API con alcances limitados para integrar tus sistemas con el panel. Las aplicaciones OAuth y los webhooks, que avisan a tu sistema cuando algo ocurre, los configura el administrador del servidor en el WHM.
Cómo usarlo en el panel
Abre Avanzado → Desarrollador.
Crea una API Key y marca solo los alcances necesarios.
Copia la clave: se muestra una sola vez.
Úsala en el encabezado Authorization de las solicitudes.
Las claves de cliente nunca reciben alcances de administración del servidor.
Todas las rutas usan la dirección de tu servidor G-Painel y un token en el encabezado Authorization: Bearer — el token de inicio de sesión, una API Key o un token OAuth. Crea una API Key en el área de cliente, en Avanzado → Desarrollador.
Las rutas de administración del servidor están en el WHM
Esta página reúne las rutas de uso del cliente y de las API Keys. La documentación completa — incluidas cuentas, planes, firewall, webhooks, OAuth y servidor — está disponible y siempre actualizada dentro del WHM, en Otros → Documentación, para el administrador de tu servidor G-Painel.
Área:
Clientecuenta de cliente o API KeyAutenticadocualquier usuario con sesiónPúblicasin sesión⟳ asíncronaresponde en provisioning
Los nombres y descripciones de las rutas de la API están en portugués.
Autenticación
Inicio de sesión con token de acceso corto (15 min) y refresh que rota en cada uso, sesiones revocables al instante, API Keys con alcances y OAuth client_credentials.
Operaciones asíncronas
Crear un sitio, correo o base de datos responde en provisioning. Consulta el recurso hasta que esté active.
Idempotencia y errores
Envía Idempotency-Key para repetir una creación sin duplicarla. Los errores siempre vienen en JSON, con mensaje en portugués.
Webhooks
16 eventos firmados con HMAC, configurados por el administrador en el WHM. Verifica la firma antes de confiar en el mensaje; las entregas fallidas pueden reenviarse.
Paginación y eliminación
Las listas aceptan limit y offset. Eliminar un recurso borra de forma definitiva todo lo que depende de él.
OpenAPI y Exportar para IA
La especificación OpenAPI 3 completa y el archivo “Exportar para IA” — con reglas y prompts listos para que un asistente cree integraciones — están en el WHM, en Otros → Documentación.