Le Bar de Gandi

Accueil > Gandi > Be API with Gandi !

Be API with Gandi !

Qu'est-ce qu'une API (Application Programming Interface) ? En vulgarisant, c'est un gros bout de code permettant de communiquer à travers plusieurs langages avec des tiers. Dans le cas de Gandi, c'est une suite de méthodes permettant à des revendeurs d'acheter mais aussi de gérer des domaines directement chez eux, en personnalisant leur interface et ainsi permettre à leurs propres clients de gérer leurs domaines via leur site.

C'est bien pour cela que cet outil est principalement à destination de nos revendeurs qui auront désormais la possibilité de se fabriquer leur propre Gandi estampillé de leur marque bien au chaud chez eux :) Le choix du XML-RPC nous est paru évident par sa simplicité d'intégration et d'utilisation. Nous avons commencé à mettre en place une FAQ dédiée à cet outil qui évoluera rapidement. J'invite les plus techniques (et les plus curieux) à jeter un oeil sur notre documentation en ligne. Celle-ci correspond à la version 0.9 de notre API XML-RPC et est exhaustive.

Pourquoi une V0.9 ? Car celle-ci a été testée en Alpha par notre équipe technique et certains revendeurs (encore merci à eux !) et malgré sa stabilité, elle ne pourra pas se prévaloir d'un numéro entier tant qu'elle ne comprendra pas toutes les méthodes de gestion utilisables sur Gandi. Les principales méthodes implémentées (31 méthodes tout de même) sont bien sûr opérationnelles, mais quelques-unes (7) seront disponibles un peu plus tard, dans un futur proche.

Afin de vous aider à avancer dans l'implémentation de cette API, nous avons créé un environnement de test dit OT&E (Operational Test & Evaluation). Cet environnement est connecté aux OT&E des Registres que nous vendons (à l'exception temporaire du .FR qui vient d'ouvrir son OT&E), ce qui vous laisse toute liberté de tester des achats et gestions de noms de domaine dans un monde virtuel :) Afin de vous montrer ce que cela peut donner rapidement, voici l'exemple de gandi-test.fr développé par Nicolas, notre Directeur Produit (pas un développeur donc) en moins de deux jours !

A vous de bosser ! Le banc de test est disponible et la doc est là ! Pour ceux qui se lancent, et qui auraient besoin d'aide, nous avons mis en place une mailing-list pour le lancement de notre produit : api-ote _ar0base_ support.gandi.net . N'hesitez pas à utiliser cette adresse pour nous remonter d'eventuels problemes ou bugs que vous décèleriez.

Si l'API-XML semble correspondre à vos besoins, voici ce que vous devez faire pour que votre compte soit ouvert en Production :

  • Etape 1: vous devez créer un compte Gandi de type revendeur (ou bien convertir votre compte facturation dans la partie "Gestion de mon compte")
  • Etape 2: vous devez activer les Gandi API XML sur la plateforme de test (OT&E) dans la gestion de vos options revendeur.
  • Etape 3: à vous d'implémenter et de tester Gandi API XML sur la plate forme de test OT&E
  • Etape 4: il vous faudra ensuite alimenter votre compte prépayé.
  • Etape 5: enfin il vous sera demandé de nous envoyer une demande d'autorisation d'ouverture de la plate-forme de production sur l'adresse email mentionnée dans l'interface d'activation
  • Etape 6: il ne vous restera plus qu'à activer Gandi API XML en production et passer vos commandes.