Be API with Gandi !
Par Arti le mercredi 17 janvier 2007, 15:50 - Gandi - Lien permanent
Très attendue de nos revendeurs, voici Gandi API-XML, l'interface qui va leur permettre d'intégrer la gestion des noms de domaine à leur site web.
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.

Commentaires
WWWHHHOOOUUUUUUUUUU... Gandi l'a fait
Je lisais justement un thread sur frih ce matin, où mon homonyme, mais beaucoup plus calé en Dot&Co, disait qu'il existait très peu de registrars français qui mettaient à disposition un véritable outil de recherche de disponibilité de NdD, un vrai WHOIS, quoi ! comme il en existait il y a bien longtemps, avant que ça devienne n'importe quoi : en direct avec le registre, interface frugale, mais efficace.
Bref, j'ai pas encore tout compris et je n'ai pas le temps là de lire la doc, mais le test de la démo est déjà impressionnant.
Be API with Gandi :D
tout simplement génial, chapeau ^_^
un premier (grand) pas vers un gandi libre
Trop cool, j'étais à la recherche d'un sujet pour jouer avec Apollo.
Reste plus qu'a trouver le temps. :p
Si on passe par l'api avec un site en marque blanche, dans les whois ce sera toujours GANDI qui vas s'afficher ?
On reste le registrar des domaines donc oui, on verra Gandi, on peut difficilement faire autrement.
Je sais, je suis HS, en fait pas vraiement car c'est à propos de nouveaux services : savez vous, approximativement, quand GandiMail sera dispo ? Il y aura quoi comme services ? Thx
Les forums sortent demain, l'email est le prochain produit important (avec de nouvelles extensions bien sûr) sur lequel nous avançons. Puis viendra l'hébergement à notre sauce
Et oui, on pense faire tout cela au premier semestre de cette année
Je précise, parce que pour l'email, on a juste plus de 6 mois de retard ... mais quand on aime ... ^^
Ah ! et j'oubliais : on sort des tee shirts Gandi pour financer de nobles causes aussi ...
J'essai de mettre en oeuvre cette solution sur ma plateforme d'hebergement mais j'ai un pb de certificat lorsque j'accede au site de test api.ote.gandi.net en https via une page php :
error:14090086:SSL routines:SSL3_GET_SERVER_CERTIFICATE:certificate verify failed
J'ai fais un mail au support mais je n'ai pas encore de réponse.
Qqun a t'il eu le même problème ???
Bonne journée
fhermand (#9) : Le certificat était un peu... particulier. Un nouveau a été généré et devrait être moins désagréable : dans tous les cas, vous pouvez rajouter le certificat du NOC Gandi dans vos certificats de confiance. N'hésitez pas à nous contacter à l'adresse << api-ote de support.gandi.net >> pour toutes les questions techniques concernant l'API en OT&E.
Le lundi 22 janvier 2007, 10:05 par stephan
Ah ! et j'oubliais : on sort des tee shirts Gandi pour financer de nobles causes aussi ...
Le tshirt, le tshirt
et ils sont ou les tshirts...
Demain ou mercredi au plus tard si tout va bien pour le forum et les tee shirts
6 mois de retard ? sur les emails ? et l'hébergement devrait arriver avant fin juin ? Heu, c'est qui votre project manager ? :-#
dommage, mon hébergement doit être renouveler fin février...snif... je dois re-signer avec online alors? rahhhh... j'ai déjà anticipé et modifié les DNS pour pointer sur le blog gandi (propag en cours). Et si j'ai bien compris, va falloir attendre pour avoir du postgreSql, du perl, du python, du jakarta et du apache 2, le tout à la sauce Gandi bien sûr ? Ok je patiente. Quand on voit dotclear, c'est bien déjà, bravo olivier and team !! Et trac ? c'est pas mal apparemment. j'ai essayé scarab, puis mantis, plus coloré mais moins bien au final
Ah oui, dernier truc (je sais pas faire court) : c'est mon premier et dernier post ici, car j'ai immigré en Irlande, et vu que je veux garder 1 jour par semaine pour participer à des développements de free software, je ne vais plus lire les fils Fr ET En, mais continuer à poster in English. Parce que ouais, vraiment, un Gandi nouveau dans l'esprit de Gandi, c'est top !! Garder le cap, l'esprit et l'éthique, y'a que ça de vrai sur la longueur !! ouais, on vous aime gandi ;-*
API-XML , parfait ca marche ... BRAVO !
Ouf ... enfin ... Houba ... ca va nous aider dans notre back-office ...
Sinon pour l'erreur "error:14090086:SSL routines:SSL3_GET_SERVER_CERTIFICATE:certificate verify failed"
j'avais trouvé la solution de faire dans le code en attendant :
$proxy = new xmlrpc_client("https://api.ote.gandi.net/xmlrpc/");
$proxy->setSSLVerifyPeer(false);
tout le reste c'est comme dans la doc
Bonne soirée,
Chris.
fhermand (#9) et batchris (#14) : Nous venons de mettre sur l'OTE un certificat signé par Thawte. Par conséquent il n'est plus nécessaire d'utiliser la ligne : $proxy->setSSLVerifyPeer(false);
Bon, je vois que l'équipe Gandi manque de femmes :-))
Chez nous à Ouvaton, il y a des Tshirts avec découpe pour les femmes...
Cela n'empêche pas de rester amis avec des machos... bon, je sors, Stephan
Esther
hey nous aussi
Les modèles femme sont en coupe femme.
Je ne suis pas revendeur et je n'ai pas l'intention de l'être. Je voudrais juste modifier avec ma propre interface, l'enregistrement DNS (comme en mode expert) de mes domaines sur Gandi, pour pouvoir automatiser des modifs de dns.
C'est possible ?
(J'ai pas testé parceque je ne sais pas exactement ce qu'implique le fait de passer en revendeur)
Jean: pour le moment, il faut être revendeur pour utiliser les API XML Gandi, ca n'implique en rien.
D'ici quelques mois nous ouvrirons probablement certaines méthodes à tous nos clients pour ceux qui souhaitent fabriquer leur propre interface ou gérer leurs domaines sans se logguer sur Gandi.
Je reposte ici parceque je n'avais pas vu ta réponse ...
J'ai parcouru un peu l'API XML et je n'y ai pas vu de moyen de modifier l'enregistrement DNS. Je n'ai vu que des trucs de commerciaux (sans animosité aucune envers cette junte :))
Suis-je malvoyant ?
Jean (#20) : Les méthodes de gestion de zone seront bientôt disponibles ! Le développement a pris un peu de retard mais nous sommes dessus et on peut s'attendre à une API avec l'ensemble des méthodes de gestion de zone d'ici un mois, un mois et demi.
Bonjour à tous,
je souhaitais moi aussi utiliser l'api de gandi pour gérer ma propre interface, mais je ne dispose pas d'un compte revendeur, serait il possible de savoir quand cette magnifique api sera disponible pour tout les utilisateurs de gandi ?
merci de votre réponse !
Bonjour,
Je ne suis pas non plus revendeur, et moi aussi j'aimerais gérer certains paramètres de mon domaine (les redirections mail en l'occurrence) par API. Est-il prévu d'ouvrir cette facette de l'API Gandi aux non-revendeurs ?
Merci d'avance !
Bruno (#23) > Vous pouvez déjà créer des redirections mail via l'API a l'aide des fonctions domain_mail_redir_*
Plus d'infos sur la doc de l'API: http://api.ote.gandi.net/
Bruno: pas dans l'immédiat, mais c'est une idée qu'on garde pour les methodes XML qui ne sont pas liée à de la facturation
Jonathan (#24) : oui, j'ai vu, et c'est bien pour ça que je bave d'envie ! mais je ne suis pas revendeur (et ça n'a pas de sens pour moi de le devenir).
Nico (#25) : merci... j'attends ça avec impatience, et je suis sûr de ne pas être le seul !
Un an plus tard (ou presque) : où en est l'idée d'ouvrir aux non-revendeurs un accès par API à la gestion des redirections mail ?