Noms de domaine, DNS, hébergements web, e-mail et certificats SSL gérés de façon automatisée
Grâce à un système de droits disponibles via notre API, récupérez votre clé API personnelle et laissez la main à vos collaborateurs dans le périmètre de leurs actions. Travail d'équipe et sécurité garanties.
API Domaine
Démarrer avec l'API domaineEnregistrez, renouvelez, transférez vos noms de domaine simplement.
API Paiements & Factures
Voir l'API Paiements & FacturesVérifiez les prix des produits puis alimentez votre compte et passez vos commandes.
API LiveDNS
Découvrir l'API LiveDNSGérez vos domaines sur vos liveDNS. DNSSEC, zones DNS, redirections web.
API Email
Voir l'API EmailCréez, administrez et supprimez les boîtes mails associées aux domaines.
API Hébergement
Voir notre API hébergementGérez vos instances d'hébergement web.
C’est très simple d’utilisation. Voici des exemples.
Accédez au nom de domaine
Accédez par votre nom de domaine à votre serveur personnel auto-hébergé derrière votre box
Grâce à notre API, mettez automatiquement à jour l'IP de votre box de manière à ce que votre serveur personnel soit toujours accessible par votre nom de domaine.
Vous pourrez ainsi toujours avoir accès à distance à vos services personnels en vous connectant par votre nom de domaine mybox.example.net, que cela soit sur votre RasperryPI, votre système d'alarme ou de domotique.
# Mettre à jour un enregistrement DNS avec une nouvelle IP $ curl --request PUT --url https://api.gandi.net/api/v5/domains/example.net/records/mybox/A \ --header "authorization: Apikey ${API_KEY}" \ --header 'content-type: application/json' \ --data "{ \"rrset_ttl\": 300, \"rrset_values\": [\"1.2.3.4\"] }"
Surveillez l'expiration prochaines des noms de domaine.
Surveillez l'expiration prochaines des noms de domaine.
Gandi vous notifie déjà par email à partir de 60 jours avant la date d'expiration.
Cependant, vous souhaitez peut-être personnaliser ces notifications afin de les faire rentrer un workflow de validation, ou d'envoyer l'information dans le canal d'un autre logiciel de collaboration partagée dans une équipe, ou encore vous les envoyer sur votre smartphone pour ne pas prendre le risque que l'alerte ne soit considérée comme du spam.
Vous n'oublierez plus de renouveller un domaine car les notifications d'expiration sont passées en spam !Ou pour être tranquille de ce point de vue, activez le renouvellement automatique, ce qui est d'ailleurs également possible par l'API !
# Lister les dates d'expiration de vos domaines tous les jours. # 1. Lister tous vos noms de domaine $ curl --request GET --url https://api.gandi.net/v5/domain/domains --header "authorization: Apikey ${API_KEY}" | jq -r .[].fqdn # 2. Récupérer la date d'expiration d'un domaine en particulier $ curl --request GET --url https://api.gandi.net/v5/domain/domains/example.net --header "authorization: Apikey ${API_KEY}" | jq -r .dates.registry_ends_at
Personnalisez les notifications de modifications de zone DNS
Personnalisez les notifications de modifications de zone DNS
Dans un cadre professionnel avec des noms de domaine sensibles, il peut être pertinent d'automatiser la surveillance des modifications de zone.
Cela peut vous permettre de :
- Tracer vos changements dans vos propres outils afin de pouvoir facilement corréler avec d'autres évènements
- Alertez automatiquement les autres équipes des modifications comme l'équipe Sécurité pour qu'elle puisse faire des vérifications sur le nouveau serveur, ou l'équipe communication par exemple.
- Détecter d'éventuelles erreurs comme le fait d'avoir supprimé une ligne de trop.
# 1. 1. Récupérer le contenu de la zone DNS à intervalles réguliers $ curl --request GET --url https://api.gandi.net/api/v5/domains/example.net/records --header 'accept: text/plain' --header "authorization: Apikey ${API_KEY}" > ma.zone # 2. Comparer les enregistrements de la zone pour voir si des modifications ont été faites durant l'intervalle donné # 3. Recevoir les notifications des modifications effectuées
Industrialisez vos déploiements de site
Industrialisez vos déploiements de site
L'API publique vous permet d'automatiser le déploiement d'un vhost, et la génération du certificat TLS/SSL.Vous pouvez alors intégrer le déploiement d'un site internet pour vous ou l'un de vos clients dans votre chaîne de traitement automique.
# Listez vos instances hébergement curl -X GET \ https://api.gandi.net/v5/simplehosting/instances \ -H 'authorization: Apikey YOUR-API-KEY' # Créez un site web Wordpress sur une instance hébergement curl -X POST \ https://api.gandi.net/v5/simplehosting/instances/<;instance_id>/vhosts \ -H 'authorization: Apikey YOUR-API-KEY' \ -H 'content-type: application/json' \ -d '{"fqdn":"your.fqdn.tld", \ "linked_dns_zone":{"allow_alteration":"True"}, \ "application":{"name":"wordpress"}}'
Gandi pour les revendeurs : Intégrez l'API Gandi directement à vos outils
Vous êtes en charge de la gestion des produits de vos clients ?
Effectuez rapidement toutes les commandes essentielles à la vie d'un nom de domaine : création, renouvellement, transfert, création d'un contact, gestion des serveurs et des zones DNS...
Vos clients sont autonomes ?
Notre API permet une intégration totale et transparente des services Gandi, à vos couleurs, sur votre plateforme. Enrichissez votre catalogue produit pour offrir un écosystème complet sous votre marque et garantir la fidélisation de vos clients.
Profitez de notre interface en marque blanche
Notre outil en marque blanche permet à vos clients d'administrer facilement leurs zones DNS et leurs redirections web à l'aide d'une interface personnalisée, sécurisée et facile d'accès. Contactez notre équipe Corporate Services pour en savoir plus.
Voici des exemples pour une gestion sereine.
Gérez les tags de vos noms de domaines via notre API
Gérez les tags de vos noms de domaines via notre API
Créez, modifiez, ajoutez ou supprimez des tags sur vos noms de domaines afin de faciliter leur gestion au quotidien. Vous voulez identifier les domaines que vous avez enregistrés défensivement pour protéger votre marque ? Utilisez un tag "enregistrement défensif".
$ curl --request POST --url https://api.gandi.net/v5/domain/domains/{domain}/tags --header "authorization: Apikey XXXXX" --header 'content-type: application/json' --data "{\"tag\": \"enregistrement défensif\"}"
Renvoyer les demandes de vérification d'adresse email en une commande
Renvoyer les demandes de vérification d'adresse email en une commande
Dans le cas où vous clients n'auraient pas reçu/vu/validé les demandes de vérification d'adresse email qui leur ont été envoyées, vous pouvez les renvoyer en une seule commande.
$ curl --request PATCH --url https://api.gandi.net/v5/domain/domains/DOMAIN/reachability --header "authorization: Apikey XXXXX" --header 'content-type: application/json' --data '{"action":"resend"}'
API GandiCloud VPS : Passez à l'Infra-as-code
Conservez vos habitudes et utilisez vos propres outils pour la configuration de vos serveurs GandiCloud VPS.
S'appuyer sur Openstack pour la configuration et la livraison de nos serveurs VPS est un véritable gage de praticité pour vos usages quotidiens.
- Chaque serveur et ressource GandiCloud peut être déployé et piloté à partir de l'API publique Openstack, telle que vous la connaissez. Vous pouvez ainsi continuer de l'utiliser de la même manière que sur votre Infrastructure Cloud privée.
- Vous êtes également libre d'utiliser les mêmes outils de déploiement et pilotage d'infrastructure que vous avez mis en place avec d'autres providers Cloud tels que Terraform, Ansible, Cloudinit ou Puppet.
- L'API publique GandiCloud VPS vous offre la possibilité de gérer vos serveurs et votre infrastructure, en mode Infra-as-code, en utilisant vos outils habituels de gestion de serveurs.
Déployez automatiquement le logiciel de visio conference Jitsi à l'aide Terraform et Cloudinit
Déployez automatiquement le logiciel de visio conference Jitsi à l'aide Terraform et Cloudinit
En utilisant Terraform et Cloudinit, vous pouvez installer en 5 minutes l'outil de visio conférence sur un Serveur GandiCloud :
- Déploiement automatique du serveur via Terraform
- Génération du certificat SSL et modification de la zône DNS, via Terraform
- Téléchargement et installation automatisée de Jitsi sur le serveur grâce à Cloudinit
# Extrait du fichier Terraform main.tf # Création d'un serveur GandiCloud VPS V-R2 resource "openstack_compute_instance_v2" "jitsi" { name = "jitsi" key_pair = openstack_compute_keypair_v2.jitsi-keypair.name flavor_name = "V-R2" security_groups = ["default"] power_state = "active" network { name = "public" } user_data = "${data.template_file.user_data.rendered}" block_device { uuid = "47edd0a0-23ce-4ce5-9168-36de68990d1b" source_type = "image" volume_size = 25 boot_index = 0 destination_type = "volume" delete_on_termination = true }
Pourquoi utiliser l’API Gandi ?
Un environnement de test fiable
Testez en toute sécurité de nombreuses fonctionnalités de notre API grâce à notre sandbox V5.
Le service client 24h/24
Nos experts techniques sont internalisés et vous répondent en 6 langues, depuis 3 continents. Pour être à vos côtés, dès vous en avez besoin.
L’expérience client valorisée
Vos retours sont précieux et sources d’évolution produit. Comment utilisez-vous notre API ? Écrivez-nous à feedback@gandi.net!
FAQ / Questions fréquentes
Qu'est-ce qu'une API ?
Une API, pour "Interface de Programmation d’Applications" en français, est un ensemble de règles qui va permettre à deux logiciels de facilement communiquer et échanger des données de manière bilatérale.
L'utilisation d'une API est synonyme de gain de temps puisque, pour un programme donné, les équipes informatiques n'ont plus à le développer eux-mêmes, mais à utiliser l'API liée. C'est pourquoi les APIs sont désormais incontournables dans tous les secteurs d'activité.
À titre d'exemple, en utilisant l'API Gandi, vous pouvez automatiser le traitement d'informations via l'échange automatique de données avec les serveurs Gandi, et ainsi, automatiser la gestion des noms de domaine, des hébergements web ou encore des boites mails.
Comment fonctionne une API ?
L'API Gandi est une API RESTful qui s'appuie sur le protocole HTTPS et utilise JSON. À ce jour, ce sont les standards les plus utilisés pour des APIs.
Toute la documentation sur les fonctionnalités et la mise en place de notre API est disponible sur https://api.gandi.net/docs/.
Pourquoi utiliser l'API ?
L'API Gandi simplifie la gestion de vos produits. Elle permet de créer très facilement des applications personnalisées permettant de réaliser des actions en lien avec les services Gandi. L'objectif est d'automatiser un large nombre d'actions sur tous les produits et services :
- enregistrer, renouveler, transférer des noms de domaine grâce à l'API Domaine
- gérer les DNS grâce à l'API LiveDNS
- Vérifier les prix et passez des commandes grâce à l'API Paiements et Factures
- Administrer les boîtes mails grâce à l'API Email
- Gérez les instances d'hébergement Web à l'aide de l'API d'hébergement Web
Concrètement, l'API est votre allié pour réaliser très simplement des tâches répétitives (ou sur un nombre important de domaine) qui seraient compliquées à réaliser manuellement via l'interface d'administration web classique.
Articles et nouveautés API
Voir tout