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.

# Vérifier si l'adresse IP de votre retour a été modifiée
 
$ curl -4 https://me.gandi.net 
 
# Mettre à jour la zone DNS avec la nouvelle adresse 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 !

# Tous les jours, listez les dates d'expiration de tous vos domaines. 
 
# 1. Listez 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érez 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 Simple Hosting  
 
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 Simple Hosting 
 
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 du 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!

News et promotions

Voir tout

Abonnez-vous à notre newsletter

Rejoignez les 175 000 abonnés qui ont choisi de rester informés de nos publications récentes et de nos meilleures offres. Un email par mois. Nous ne partageons pas vos données.

Inscription invalide

Email de confirmation envoyé