Le Bar de Gandi

Accueil > Gandi > Nouvelle API noms de domaine et mail (mise à jour)

Nouvelle API noms de domaine et mail (mise à jour)

Une nouvelle API, mais toujours en XML RPC

Nous avons fait le choix de mettre à votre disposition la même API que celle utilisée par le site de Gandi.net. Cela signifie donc que vous bénéficierez de toutes nos améliorations de façon quasi-immédiate (nouvelles extensions, nouveaux produits...).
Cela signifie également que vous aurez désormais accès à l'ensemble des extensions proposées par Gandi, que le catalogue de prix sera interrogeable directement via l'API (grâce à de nouvelles méthodes permettant de connaitre le prix par rapport à votre grille).
Vous pourrez également créer des listes d'opérations, de noms de domaines, de contacts, sur lesquelles vous pourrez appliquer des filtres.
Enfin, vous pourrez gérer votre répondeur email via l'API Mail.

Une documentation est d'ores et déjà disponible à cette adresse, et celle-ci contient des exemples en Python, Php, Nodejs, Perl et Ruby.
Vous trouverez également un tutoriel sur son utilisation, étape par étape sur cette page ou, si vous préférez, téléchargeable en version PDF.

Les différences notables

Le postulat de départ était de ne pas tout changer, afin de vous faciliter la transition. Et puisque nous parlons de transition, sachez que l'API actuelle ne comportera plus aucune évolution mais sera toutefois maintenue jusqu'au 30 juin 2012 afin de vous permettre de migrer vers la nouvelle.
Concernant cette migration, sachez que les deux API sont compatibles et que vous pouvez migrer méthode par méthode afin d'avoir un contrôle continu sur votre passage en V2.
Un point qui peut sembler mineur mais qui posait beaucoup de soucis à certains : il n'y a plus de méthode d'identification par login et mot de passe dans cette version V2. Vous devrez désormais récupérer votre clé API sur votre interface Gandi.
Enfin, sachez que cette nouvelle API est ouverte à tous, que vous soyez revendeur ou non. La seule obligation reste d'avoir au moins un nom de domaine chez Gandi ou d'avoir un compte prépayé suffisamment approvisionné.

Une API oui, mais pour quoi faire ?

Notre API vous permettra de faire ce que vous faites avec vos domaines sur notre interface, mais via les méthodes API, donc directement à partir d'un site, de façon scriptée si vous le souhaitez. Par exemple ? Vous pourrez vous programmer vos rappels de renouvellement aux dates que vous souhaitez, mettre à disposition de votre famille (de vos clients, si vous êtes revendeur) une interface permettant de créer des redirections mails ou web, programmer le répondeur mail...

C'est disponible quand ?

La plateforme de test OT&E (Operational Test and Evaluation) est disponible dès maintenant à l'adresse https://rpc.ote.gandi.net/xmlrpc.
La plateforme de production, quant à elle, devrait être disponible d'ici 3 à 4 semaines.

Les évolutions à venir

Ce que nous prévoyons d'intégrer prochainement dans l'API Domaine V2 (et qui ne sera pas implémenté dans l'API V1) devrait satisfaire plusieurs utilisateurs actuels. La gestion de zone DNS est actuellement en cours de finalisation (tests internes) et sera disponible d'ici très peu de temps. Le DNSSEC devrait suivre quelques semaines plus tard. Concernant les changements de propriétaires, c'est prévu mais nous avons encore une migration de notre système à faire pour les rendre compatibles avec les méthodes API.

 

 

Mise à jour du mardi 28 février : La nouvelle API a été déployée en production ce matin et donc désormais disponible. La documentation (encore en cours de modification), est disponible sur cette adresse : http://doc.rpc.gandi.net/

Pour rappel: si vous n'avez pas encore activé l'API sur votre compte, il vous faut déjà activer et utiliser l'API en OT&E (version de test, sur laquelle vous aurez un compte crédité et pourrez acheter des domaines) puis ensuite récupérer votre clé API pour la version de Production, à condition que vous disposiez d'au moins un nom de domaine ou ayez un compte prépayé crédité.