API Mail

Si vous voulez enregistrer des noms de domaines en nombre et de façon régulière (au moins 20 domaines à l'ouverture du compte), notre système d'enregistrement par mail vous simplifiera la tâche. Après avoir activé cette API mail sur votre compte Revendeur, vous pourrez l'utiliser pour vos enregistrements (créations, transferts ou renouvellements) de domaines en utilisant une interface basée sur le courrier électronique.

Dans votre interface revendeur vous pouvez activer une API Mail, qui permet de passer vos commandes de création, renouvellement et transfert de noms de domaine par mail signé PGP.

Voici les différentes étapes pour activer et utiliser l'API Mail :

• Compte revendeur : vérifiez que votre identifiant a bien un statut revendeur. Si ce n'est pas le cas, vous pouvez transformer votre compte habituel en compte Revendeur.
• Création d'une clé PGP : si vous n'en avez pas déjà une, créez une clé PGP ou GPG.

PGP est un système standard pour authentifier et chiffrer des données. Nous ne fournissons pas de support technique pour vous former à PGP, mais vous pouvez consulter des documentations aux adresses suivantes (en anglais): site de GPG (un logiciel libre équivalent) ; sites de PGP pgp.com ou pgpi.com ; plug-in Thunderbird Enigmail, pour ajouter la fonction PGP à votre messagerie si vous utilisez le logiciel libre Mozilla Thunderbird.

• Envoi de votre clé à Gandi : envoyez votre clé publique GPG ou PGP à notre robot keys@gandi.net, non chiffrées, en format texte brut ASCII dans le corps du message, sans aucun fichier attaché, en précisant ADD dans le sujet de votre message, et en conservant bien les balises

-----BEGIN PGP PUBLIC KEY BLOCK-----
-----END PGP PUBLIC KEY BLOCK-----

Veillez à ne pas envoyer une clé utilisant l'algorithme IDEA, car notre système utilise le logiciel libre GPG non compatible avec cet algorithme. Assurez-vous également que vous n'utilisez pas des fichiers attachés MIME PGP comme ceux qui sont générés par la plupart des logiciels de courrier électronique modernes (pas de BASE 64 ou de Quoted Printable), cela ferait échouer la vérification de votre signature.

• Liez votre clé à votre compte Revendeur : dans vos options Revendeur, activez l'API mail, et déclarez votre clé.

• Alimentation du compte prépayé : vérifiez que vous avez bien un compte prépayé activé et suffisamment alimenté, afin de pouvoir passer vos commandes.

Vous trouverez dans notre faq la syntaxe pour créer, transférer et renouveler des domaines, ainsi qu'un récapitulatif de toutes les syntaxes.

Si vous êtes impatient d'effectuer votre premier enregistrement via l'API Mail, voici un exemple tout fait :

action:creation
reseller_handle:[à compléter]-GANDI
owner_handle:new_handle
owner_type: individual
owner_organization:[prénom nom, ou nom de la société]
owner_firstname:[prénom]
owner_lastname:[nom]
owner_address-1:[à compléter]
owner_city:[à compléter]
owner_postal-code:[à compléter]
owner_country:FR
owner_email:[à compléter]
owner_phone:+33.[à compléter]
owner_fax:+33.[à compléter]
admin_handle:[à compléter]-GANDI
tech_handle:[à compléter]-GANDI
billing_handle:[à compléter]-GANDI
domains0:[premier domaine]
domains1:[deuxième domaine]
ns0-domain-name:a.dns.gandi.net
ns0-ip-address:217.70.179.40
ns1-domain-name:b.dns.gandi.net
ns1-ip-address:217.70.184.40
ns2-domain-name:c.dns.gandi.net
ns2-ip-address:217.70.182.20

Vous avez la possibilité de chiffrer vos commandes en utilisant notre clé publique. Il est conseillé de chiffrer tout courrier électronique contenant le mot de passe d'un contact.

Vous pouvez enregistrer par courrier électronique autant de domaines que votre crédit le permet. Votre courrier électronique doit respecter une certaine syntaxe, être signé avec PGP (sans fichier MIME), puis être envoyé à notre serveur automatisé secure@gandi.net. Vous recevrez deux réponses automatiques :

• Une réponse immédiate, signifiant que la syntaxe de votre requête est correcte (« queuing domain for… ») ou incorrecte (« error… »)
• Plus tard, à l'adresse que vous avez indiquée lors de la création du compte, le résultat de votre requête.

Votre courrier électronique va être décodé par un automate: respectez bien la syntaxe indiquée pour chaque type d'enregistrement. Chaque ligne de votre courrier électronique doit contenir une paire (clé, attribut), séparés par deux points (:), comme ceci : clé:valeur
Ces paires (clé:valeur) définissent les éléments suivants :

• Votre identifiant revendeur
• Nature de l'action (par défaut c'est une création)
• Paramètres du propriétaire (particulier, société, le cas échéant n° SIREN…)
• Identifiant et paramètres de chaque contact (Propriétaire, admin, tech, billing)
• Liste des domaines à traiter
• Liste des serveurs de noms pour les domaines

Les avantages :

• Interface adaptée à vos nombreux enregistrements: un courrier électronique suffit pour enregistrer jusqu'à 10 domaines.
• Gain de temps lors des transferts (sauf .FR): vous économisez le délai d'acceptation par les contacts (5 jours).

Les restrictions :

• Le montant minimum de chaque versement sur le compte pré-payé est de 120€ HT.
• Pour pouvoir signer vos courriers électroniques, vous devez savoir utiliser PGP, ou être capable de l'apprendre par vous-même.

Pour acheter un nom de domaine par mail, une fois votre compte créé et activé, vous devez envoyer un mail signé PGP à notre robot à l'adresse secure@gandi.net avec la clé que vous avez renseignée dans votre compte.

Ci-dessous, un exemple de syntaxe pour une création de 2 domaines :

action:creation   <= cette ligne spécifie l'opération
reseller_handle: AB18-GANDI  <= l'identifiant de votre compte revendeur (obligatoire)
owner_handle:new_handle  <= vous allez créer un nouveau propriétaire
owner_type: particulier   <= le type de contact que vous créez
owner_organization:Marcel Dugenou  <= Société ou nom du particulier
owner_firstname: Marcel  <= Prenom du propriétaire ou du responsable
owner_lastname: dugenou  <= Nom du propriétaire ou du responsable
owner_brand:12162099 <= dans le cas d'un .FR avec un numero de marque
owner_siret:123456789  <= dans le cas d'un .FR pour une société
owner_birthdep: 75  <= dans le cas d'un .FR pour un particulier
owner_birthcity: paris  <= dans le cas d'un .FR pour un particulier
owner_birthdate: 1979/03/20  <= dans le cas d'un .FR pour un particulier
owner_birthcountry: FR  <= dans le cas d'un .FR pour un particulier
owner_address-1:42 rue du Pied
owner_city:PARIS
owner_postal-code:75013
owner_country:FR   <= Code ISO sur 2 lettres
owner_email:dugenou@yahoo.fr
owner_phone:+33.123456789 <= format internationnal
owner_fax:+33.123456789

tech_handle:AR41-GANDI   <= ici on réutilise un identifiant Gandi existant

admin_handle: same_as_billing  <=  syntaxe également acceptée

billing_handle:new_handle  <=  syntaxe pour créer un nouvel identifiant
bl_name: Marcel Dugenou
bl_address-1:42 rue du Pied
bl_postal-code:75013
bl_city:PARIS
bl_country:FR
bl_phone:+33.123456789
bl_fax:+33.876543210
bl_email:marcel@dugenou.com
bl_password:123456

domains0:mondomaine.com  <= domaine(s) à acheter avec ces paramètres
domains1: mondeuxiemedomaine.net
...
domains9: mondixiemedomaine.net <= vous pouvez spécifier jusqu'à 10 domaines

ns0-domain-name:a.dns.gandi.net  <= 1er DNS pour les domaines ci-dessus
ns0-ip-address: 217.70.179.40 <= adresse IP du serveur DNS
ns1-domain-name:b.dns.gandi.net <= 2eme DNS 
ns1-ip-address:217.70.184.40
ns2-domain-name:c.dns.gandi.net  <= 3eme DNS pour les domaines ci-dessus
ns2-ip-address:  217.70.182.20<= adresse IP du serveur DNS

Si la syntaxe de votre mail est valide, vous recevrez alors une confirmation de la prise en compte de votre commande de la forme suivante :

IMPORTANT NOTICE: any use of a production account implies acceptance of
our domain contract. See:
http://www.gandi.net/contracts

Mail signed with keyid XXXXX.

Account information for keyid XXXX before processing:
	You have XX.XX Euros left in your account.
THESE COUNTS DO NOT INCLUDE DOMAINS PROCESSED BELOW.

Handle for owner contact is MD12345-GANDI
Handle for reseller contact is AB1888-GANDI
Handle for admin contact is MD12346-GANDI
Handle for tech contact is AR41-GANDI
Handle for billing contact is MD12346-GANDI

Queuing domain mondomaine.com for creation.
Queuing domain monautredomaine.net for creation.

End of processing.

Voici un exemple de commande pour transférer un nom de domaine via le système de commande par mail. L'ensemble des champs utilisables est disponible sur la page “Recapitulatif sur la syntaxe”.

action:transfer

reseller_handle:AR41-GANDI

owner_handle:AR41-GANDI
ou
owner_organization:Dugenou ets
owner_type:societe
owner_siret:123456789
owner_firstname:Marcel
owner_lastname:Dugenou
owner_email:monom@monsite.net
owner_phone:+33.123456789
owner_address-1:42 rue du Pied
owner_city:PARIS
owner_postal-code:75013
owner_country:FR

admin_handle:AR41-GANDI
tech_handle: same_as_admin
billing_handle:same_as_admin

domains0:mondomaine.com
eppkey0:epp authorization key
domains1: monautredomaine.net
eppkey1:1245214521

Avant de pouvoir utiliser l'API de transfert, vous devez contacter notre service client pour paramétrer votre compte.

Voici un exemple de commande pour renouveler un nom de domaine via le système de commande par mail.

action:renew
reseller_handle: AB18-GANDI  <= l'identifiant de votre compte revendeur (obligatoire)
period:2  <= nombre d'année que vous souhaitez renouveler
current_year:2006 <= optionnel mais conseillé pour éviter les doublons
domains0:mondomaine.com
domains1:monautredomaine.net