Comment fonctionne chaque fonctionnalité — et comment l’automatiser avec l’API
Consultation publique pour clients et développeurs : le pas-à-pas de chaque écran du panneau et la référence des routes de l’API, avec des exemples prêts à copier.
Domaines
Domaines, sous-domaines et redirections
Chaque compte a un domaine principal et peut avoir des domaines supplémentaires (avec leur propre dossier), des domaines parqués (pointant vers le même site), des sous-domaines et des redirections 301/302. Chaque nouveau domaine est créé avec une zone DNS et un certificat SSL automatique.
Comment l’utiliser dans le panneau
Ouvrez Domaines dans le menu latéral et choisissez le type : supplémentaire, parqué ou sous-domaine.
Indiquez le nom et, si besoin, le dossier du site.
Attendez que le statut passe de « Provisionnement » à « Actif ».
Pour rediriger, utilisez Domaines → Redirections.
Lorsque vous supprimez un domaine, tout ce qui en dépend est définitivement effacé : dossier, zone DNS, certificat et comptes e-mail. Le panneau demande toujours une confirmation avant.
G-Painel dispose de son propre DNS faisant autorité. Vous modifiez les enregistrements A, AAAA, CNAME, MX, TXT, SRV et CAA avec un TTL par enregistrement, et le panneau publie SPF, DKIM et DMARC pour l’e-mail.
Comment l’utiliser dans le panneau
Ouvrez Domaines → Éditeur de zone.
Choisissez le domaine et cliquez sur Ajouter un enregistrement.
Renseignez le type, le nom, la valeur et le TTL.
Enregistrez : la modification est publiée en quelques secondes.
Vous préférez Cloudflare ? Connectez votre compte sous Domaines → Cloudflare et gérez vos zones depuis là.
Connectez un ou plusieurs comptes Cloudflare avec un jeton d’API. Le panneau liste vos zones, permet de créer et modifier des enregistrements DNS et de configurer des health checks pour surveiller vos adresses.
Comment l’utiliser dans le panneau
Dans Cloudflare, créez un jeton d’API avec l’autorisation de modifier le DNS.
Dans G-Painel, ouvrez Domaines → Cloudflare et cliquez sur Connecter un compte.
Collez le jeton : le panneau le valide et affiche les zones.
Gérez les enregistrements et les health checks directement depuis le panneau.
Le jeton est chiffré sur le serveur et n’est plus jamais affiché. Chaque compte Cloudflare reste isolé chez le client qui l’a connecté.
Créez des boîtes aux lettres avec leur propre quota, des redirections, une adresse fourre-tout et des réponses automatiques. Le Webmail fonctionne à l’adresse de votre domaine et l’antispam filtre les messages.
Comment l’utiliser dans le panneau
Ouvrez E-mail → Comptes e-mail et cliquez sur Nouveau compte e-mail.
Choisissez le domaine, le nom et le mot de passe.
Définissez le quota en Mo (ou illimité).
Utilisez Configurer le client e-mail pour voir les paramètres IMAP et SMTP.
Chaque domaine reçoit son propre certificat pour IMAP et SMTP, renouvelé automatiquement.
Créez des bases et des utilisateurs MySQL/MariaDB ou PostgreSQL, accordez des privilèges et gérez-les dans phpMyAdmin ou pgAdmin à connexion automatique.
Comment l’utiliser dans le panneau
Ouvrez Bases de données et choisissez MySQL ou PostgreSQL.
Créez la base et l’utilisateur.
Associez l’utilisateur à la base avec les privilèges.
Cliquez sur phpMyAdmin ou pgAdmin pour l’administrer.
Les bases de données sont incluses automatiquement dans les sauvegardes du compte.
Envoyez des fichiers en les glissant à l’écran, avec barre de progression ; modifiez-les avec coloration syntaxique, compressez, extrayez, changez les permissions et récupérez depuis la corbeille. Comptes FTP avec FTPS par domaine.
Comment l’utiliser dans le panneau
Ouvrez Fichiers → Gestionnaire de fichiers.
Glissez des fichiers ou dossiers de votre ordinateur dans la liste.
Faites un clic droit pour copier, déplacer, compresser ou modifier.
Les éléments supprimés vont dans la corbeille et peuvent être restaurés.
La limite d’envoi par fichier est définie par l’administrateur dans le WHM.
Réalisez des sauvegardes complètes du compte (fichiers, e-mails et bases de données) manuellement ou selon une planification quotidienne, hebdomadaire ou mensuelle. Envoyez-les sur le serveur lui-même, en FTP, SFTP ou vers tout stockage compatible S3 : Amazon S3, Cloudflare R2, Backblaze B2, Wasabi, DigitalOcean Spaces et MinIO.
Comment l’utiliser dans le panneau
Ouvrez Fichiers → Sauvegarde et ajoutez une destination (Locale, FTP, SFTP ou S3).
Dans Planification automatique, choisissez la fréquence et l’heure (UTC).
Définissez la rétention : combien de copies conserver (1 à 90).
Pour restaurer, choisissez la sauvegarde et cliquez sur Restaurer — ou envoyez un fichier depuis votre ordinateur.
Une destination utilisée par une planification ne peut pas être supprimée. Les copies au-delà de la rétention sont supprimées automatiquement, y compris sur la destination distante.
Installez WordPress, Joomla, Drupal, PrestaShop, OpenCart, Zen Cart, Dolibarr, phpBB, Nextcloud et d’autres en un clic, sur n’importe quel domaine, sous-domaine ou dossier.
Comment l’utiliser dans le panneau
Ouvrez Logiciels → Installateur d’applications.
Choisissez l’application et la destination.
Indiquez l’utilisateur administrateur de l’application.
Le panneau crée la base de données et installe la dernière version.
Disponible avec les offres Empresarial et Business.
Exécutez des services en conteneurs — comme n8n, Redis ou Uptime Kuma — avec volumes persistants, limites de CPU et de mémoire et domaine propre avec SSL.
Comment l’utiliser dans le panneau
Ouvrez Logiciels → Docker et cliquez sur Nouveau conteneur.
Indiquez l’image, les réplicas, le CPU et la mémoire.
Choisissez la version de PHP par site, ajustez les directives du php.ini, exécutez des applications Node.js avec redémarrage automatique et planifiez des commandes récurrentes.
Comment l’utiliser dans le panneau
Ouvrez Logiciels → Paramètres PHP pour changer la version d’un site.
Utilisez php.ini pour ajuster des limites comme la mémoire et l’envoi de fichiers.
Dans Node.js, créez l’application, installez les dépendances et démarrez-la.
Dans Avancé → Cron, ajoutez la commande et l’horaire.
Chaque compte dispose de ses propres limites de CPU, de mémoire et de processus définies par l’offre.
Fail2Ban protège SSH, l’e-mail et les sites et détecte automatiquement les scans à la recherche de fichiers sensibles. L’espace client propose un bloqueur d’IP, une protection contre le hotlink et la confidentialité des répertoires par domaine.
Comment l’utiliser dans le panneau
Ouvrez Sécurité → Bloqueur d’IP pour refuser l’accès à votre site à une IP ou une plage.
Utilisez Protection contre le hotlink pour empêcher d’autres sites d’utiliser vos images.
Protégez un dossier par identifiant et mot de passe dans Confidentialité des répertoires.
Vérifiez vos sessions ouvertes dans Mon compte et fermez celles que vous ne reconnaissez pas.
Les blocages au niveau du serveur, les IP de confiance et les événements du pare-feu sont gérés par l’administrateur dans le WHM.
Créez des clés d’API aux portées limitées pour connecter vos systèmes au panneau. Les applications OAuth et les webhooks, qui préviennent votre système lorsqu’un événement se produit, sont configurés par l’administrateur du serveur dans le WHM.
Comment l’utiliser dans le panneau
Ouvrez Avancé → Développeur.
Créez une clé d’API et cochez uniquement les portées nécessaires.
Copiez la clé : elle n’est affichée qu’une seule fois.
Utilisez-la dans l’en-tête Authorization de vos requêtes.
Les clés client ne reçoivent jamais de portées d’administration du serveur.
Toutes les routes utilisent l’adresse de votre serveur G-Painel et un jeton dans l’en-tête Authorization: Bearer — le jeton de connexion, une clé d’API ou un jeton OAuth. Créez une clé d’API dans l’espace client, sous Avancé → Développeur.
Les routes d’administration du serveur sont dans le WHM
Cette page regroupe les routes destinées aux clients et aux clés d’API. La documentation complète — comptes, offres, pare-feu, webhooks, OAuth et serveur compris — est disponible et toujours à jour dans le WHM, sous Autres → Documentation, pour l’administrateur de votre serveur G-Painel.
Domaine :
Clientcompte client ou clé d’APIAuthentifiétout utilisateur connectéPubliquesans connexion⟳ asynchronerépond en provisioning
Les noms et descriptions des routes de l’API sont en portugais.
Authentification
Connexion avec jeton d’accès court (15 min) et refresh renouvelé à chaque utilisation, sessions révocables instantanément, clés d’API avec portées et OAuth client_credentials.
Opérations asynchrones
Créer un site, un e-mail ou une base de données répond en provisioning. Interrogez la ressource jusqu’à ce qu’elle soit active.
Idempotence et erreurs
Envoyez Idempotency-Key pour relancer une création sans doublon. Les erreurs sont toujours en JSON, avec un message en portugais.
Webhooks
16 événements signés en HMAC, configurés par l’administrateur dans le WHM. Vérifiez la signature avant de vous fier au message ; les livraisons échouées peuvent être renvoyées.
Pagination et suppression
Les listes acceptent limit et offset. Supprimer une ressource efface définitivement tout ce qui en dépend.
OpenAPI et Exporter pour l’IA
La spécification OpenAPI 3 complète et le fichier « Exporter pour l’IA » — avec des règles et des prompts prêts pour qu’un assistant crée des intégrations — se trouvent dans le WHM, sous Autres → Documentation.