Tabla de Contenidos

¡Ayúdanos con el español!

Esta página todavía no ha sido traducida (o sólo parcialmente) en español. Si hablas francés o inglés, puedes ayudarnos.
Aquí encontrarás la versión FR de esta página, que podrás editar sólo con identificarte (con tu usuario Gandi).

Si prefieres traducir a partir de la versión EN, sólo tienes que abrir una nueva ventana, copiar-pegar la URL de la página y hacer clic en la bandera (arriba a la derecha) del idioma correspondiente. Si la página existe, aparecerá en el idioma deseado.

Gracias de antemano por ayudarnos con el español :)

API Mail

Qu'est ce que le système de commande par 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.

Pour toute modification postérieure sur ces noms de domaines, vous devrez utiliser l'interface web.

Comment activer et gérer Gandi API Mail ?


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 :

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.

-----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.

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.

Comment fonctionne le système de commande par mail ?


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 :

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 :

Quels en sont les principaux avantages et restrictions ?


Les avantages :

Les restrictions :

Comment acheter un nom de domaine par mail ?


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.

Comment transférer un nom de domaine par mail ?


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.

Comment renouveler un nom de domaine par mail ?


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

Quelle est la syntaxe des champs utilisables par le système de commande par mail ?