Come funziona ogni funzionalità — e come automatizzarla con l’API
Consultazione pubblica per clienti e sviluppatori: la guida passo passo di ogni schermata del pannello e il riferimento delle rotte API, con esempi pronti da copiare.
Domini
Domini, sottodomini e reindirizzamenti
Ogni account ha un dominio principale e può avere domini aggiuntivi (con cartella propria), domini parcheggiati (puntano allo stesso sito), sottodomini e reindirizzamenti 301/302. Ogni nuovo dominio nasce già con zona DNS e certificato SSL automatico.
Come usarlo nel pannello
Apri Domini nel menu laterale e scegli il tipo: aggiuntivo, parcheggiato o sottodominio.
Inserisci il nome e, se serve, la cartella del sito.
Attendi che lo stato passi da “In provisioning” ad “Attivo”.
Per reindirizzare, usa Domini → Reindirizzamenti.
Eliminando un dominio, tutto ciò che ne dipende viene rimosso definitivamente: cartella, zona DNS, certificato e account e-mail. Il pannello chiede sempre conferma prima.
G-Painel ha un DNS autoritativo proprio. Modifichi record A, AAAA, CNAME, MX, TXT, SRV e CAA con TTL per record, e il pannello pubblica SPF, DKIM e DMARC per l’e-mail.
Come usarlo nel pannello
Apri Domini → Editor di zona.
Scegli il dominio e fai clic su Aggiungi record.
Compila tipo, nome, valore e TTL.
Salva: la modifica viene pubblicata in pochi secondi.
Preferisci Cloudflare? Collega il tuo account in Domini → Cloudflare e gestisci le zone da lì.
Collega uno o più account Cloudflare con un token API. Il pannello elenca le tue zone, permette di creare e modificare record DNS e di configurare health check per monitorare gli indirizzi.
Come usarlo nel pannello
In Cloudflare, crea un token API con permesso di modifica DNS.
In G-Painel, apri Domini → Cloudflare e fai clic su Collega account.
Incolla il token: il pannello lo convalida e mostra le zone.
Gestisci record e health check direttamente dal pannello.
Il token è cifrato sul server e non viene mai più mostrato. Ogni account Cloudflare resta isolato nel cliente che lo ha collegato.
Crea caselle con quota propria, inoltri, casella catch-all e risposte automatiche. La Webmail funziona all’indirizzo del tuo dominio e l’antispam filtra i messaggi.
Come usarlo nel pannello
Apri E-mail → Account e-mail e fai clic su Nuovo account e-mail.
Scegli il dominio, il nome e la password.
Imposta la quota in MB (o illimitata).
Usa Configura client e-mail per vedere i dati IMAP e SMTP.
Ogni dominio riceve un certificato proprio per IMAP e SMTP, rinnovato automaticamente.
Carica file trascinandoli sullo schermo, con barra di avanzamento; modificali con evidenziazione della sintassi, comprimi, estrai, cambia i permessi e recupera dal cestino. Account FTP con FTPS per dominio.
Come usarlo nel pannello
Apri File → File manager.
Trascina file o cartelle dal computer nell’elenco.
Fai clic destro per copiare, spostare, comprimere o modificare.
Gli elementi eliminati vanno nel cestino e possono essere ripristinati.
Il limite di caricamento per file è definito dall’amministratore nel WHM.
Esegui backup completi dell’account (file, e-mail e database) manualmente o con pianificazione giornaliera, settimanale o mensile. Inviali al server stesso, a FTP, SFTP o a qualsiasi storage compatibile S3: Amazon S3, Cloudflare R2, Backblaze B2, Wasabi, DigitalOcean Spaces e MinIO.
Come usarlo nel pannello
Apri File → Backup e registra una destinazione (Locale, FTP, SFTP o S3).
In Pianificazione automatica, scegli frequenza e orario (UTC).
Imposta la conservazione: quante copie mantenere (da 1 a 90).
Per ripristinare, scegli il backup e fai clic su Ripristina — oppure carica un file dal computer.
Una destinazione usata da una pianificazione non può essere eliminata. Le copie oltre la conservazione si cancellano da sole, anche nella destinazione remota.
Installa WordPress, Joomla, Drupal, PrestaShop, OpenCart, Zen Cart, Dolibarr, phpBB, Nextcloud e altri con un clic, su qualsiasi dominio, sottodominio o cartella.
Come usarlo nel pannello
Apri Software → Installer di app.
Scegli l’applicazione e la destinazione.
Inserisci l’utente amministratore dell’app.
Il pannello crea il database e installa l’ultima versione.
Fail2Ban protegge SSH, e-mail e siti e rileva automaticamente le scansioni alla ricerca di file sensibili. Nell’area cliente ci sono blocco IP, protezione hotlink e privacy delle directory per dominio.
Come usarlo nel pannello
Apri Sicurezza → Blocco IP per negare l’accesso al tuo sito a un IP o a un intervallo.
Usa Protezione hotlink per impedire ad altri siti di usare le tue immagini.
Proteggi una cartella con utente e password in Privacy delle directory.
Controlla le sessioni aperte in Il mio account e chiudi quelle che non riconosci.
Blocchi del server, IP attendibili ed eventi del firewall sono gestiti dall’amministratore nel WHM.
Crea chiavi API con ambiti limitati per integrare i tuoi sistemi con il pannello. Le applicazioni OAuth e i webhook, che avvisano il tuo sistema quando accade qualcosa, sono configurati dall’amministratore del server nel WHM.
Come usarlo nel pannello
Apri Avanzate → Sviluppatore.
Crea una API Key e seleziona solo gli ambiti necessari.
Copia la chiave: viene mostrata una sola volta.
Usala nell’intestazione Authorization delle richieste.
Le chiavi dei clienti non ricevono mai ambiti di amministrazione del server.
Tutte le rotte usano l’indirizzo del tuo server G-Painel e un token nell’intestazione Authorization: Bearer — il token di accesso, una API Key o un token OAuth. Crea una API Key nell’area cliente, in Avanzate → Sviluppatore.
Le rotte di amministrazione del server sono nel WHM
Questa pagina raccoglie le rotte per i clienti e per le API Key. La documentazione completa — inclusi account, piani, firewall, webhook, OAuth e server — è disponibile e sempre aggiornata all’interno del WHM, in Altro → Documentazione, per l’amministratore del tuo server G-Painel.
Area:
Clienteaccount cliente o API KeyAutenticatoqualsiasi utente connessoPubblicasenza accesso⟳ asincronarisponde in provisioning
Nomi e descrizioni delle rotte API sono in portoghese.
Autenticazione
Accesso con token breve (15 min) e refresh che ruota a ogni uso, sessioni revocabili all’istante, API Key con ambiti e OAuth client_credentials.
Operazioni asincrone
Creare un sito, un’e-mail o un database risponde in provisioning. Interroga la risorsa finché non è active.
Idempotenza ed errori
Invia Idempotency-Key per ripetere una creazione senza duplicarla. Gli errori sono sempre in JSON, con messaggio in portoghese.
Webhook
16 eventi firmati con HMAC, configurati dall’amministratore nel WHM. Verifica la firma prima di fidarti del messaggio; le consegne fallite possono essere reinviate.
Paginazione ed eliminazione
Gli elenchi accettano limit e offset. Eliminare una risorsa rimuove definitivamente tutto ciò che ne dipende.
OpenAPI ed Esporta per IA
La specifica OpenAPI 3 completa e il file “Esporta per IA” — con regole e prompt pronti perché un assistente crei integrazioni — sono nel WHM, in Altro → Documentazione.