Une API exhaustive, gratuite et sécurisée pour la gestion de vos produits Gandi

Simplifiez la gestion de vos produits sur Gandi grâce à notre API REST. Accessible à travers une documentation complète, elle est votre alliée pour effectuer des actions en masse, automatisables, sur nos produits et services.

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.

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 :

  1. Déploiement automatique du serveur via Terraform
  2. Génération du certificat SSL et modification de la zône DNS, via Terraform
  3. 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 
 }

Nos serveurs VPS sont fiables et à la pointe pour héberger toutes vos applications

Découvrez les serveurs GandiCloud VPS

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

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.

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/.

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 :

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.

Obtenir de l'aide

Articles et nouveautés API

Voir tout

Abonnez-vous à la newsletter Gandi API

Un e-mail pour vous informer des mises à jour importantes de l'API publique. Restez informé sur les améliorations et mises à jour des fonctionnalités de l'API (en anglais seulement).

Inscription invalide

E-mail de confirmation envoyé

Veuillez vérifier votre boîte mail pour confirmer votre abonnement.

Discutez avec nous

L'outil de discussion nécessite d'accepter des cookies.

L'outil de discussion nécessite des cookies pour fonctionner correctement. Vous pouvez visualiser le détail des cookies utilisés dans notre politique de confidentialité et d'utilisation des cookies.

Merci de les accepter pour continuer ou utilisez le formulaire de contact si vous préférez les refuser.