API de Domaine

Récupérez des domaines (dropcatch) et gérez votre compte avec l'API de Domaines de Dynadot ! Notre API de Domaines vous permet de chercher, enregistrer, renouveler et supprimer des noms de domaines en le programmant, en utilisant votre propre logiciel et vos propres serveurs. Avec notre API de Domaines, vous pouvez aussi facilement configurer des serveurs de noms, les options de renouvellement, et des dossiers pour vos domaines. Notre API de Domaines est accessible pour tous les comptes, alors lancez-vous sans attendre !

Vous voulez plus de fonctions ? Consultez notre API de Domaines Avancée !

Bien Débuter Avec Notre API de Domaine

Les requêtes vers notre API de Domaines sont envoyées à l'URL suivante.:

https://api.dynadot.com/api2.html

Notez que les requêtes doivent être envoyées en https (socket sécurisée) pour la sécurité. Seul 1 requête peut être traitée à la fois, veuillez donc attendre que la requête en cours soit terminée avant d'en envoyer une autre. La requête doit contenir les paramètres suivants :

Paramètre de Requête
Explication
keyVotre clé pour accéder à l'API, disponible dans le tableau de bord de votre compte
commandLes commandes supportées à l'heure actuelle sont "search" (chercher) et "register" (enregistrer)

Les résultats sont envoyés sous forme de fichier texte séparés par des virgules. La première ligne est le résultat de la commande. Cette ligne a 2 champs.

Champ de Résultat
Explication
1Résultat de cet appel API:
ok - la commande a réussi
error - la commande a échoué
2Plus d'informations sur le résultat. Utilisé seulement quand le résultat est "error"

La deuxième ligne est vide. Les lignes suivantes sont les résultat de la commande, par exemple vos résultats de recherche.

Commande Search (Chercher)

Si la commande search est appelée, les paramètres suivants doivent être inclus :

Paramètre de Requête Search
Explication
domain0 - domain99Le nom de domaine que vous recherchez, vous pouvez spécifier jusqu'à 100 domaines
language0 - language99 (facultatif)Le tag de lagage pour le domaine respectif, à n'utiliser que pour les IDNs
show_price (facultatif)Si vous voulez afficher le prix dans votre devise de compte, paramétrez-le égal à "1".

Il y aura 1 de résultat pour chaque requête soumise. Chaque ligne comptera 5 champs.

Champ de Résultat de Recherche
Explication
1Le paramètre de domaine, par exemple : domain0
2Le nom de domaine recherché, par exemple : mydomain.com
3Le langage s'il existe, par exemple : spa
4Résultat de la recherche:
yes - le domaine est disponible
no - le domaine n'est pas disponible
offline - le bureau central d'enregistrement de ce domaine est actuellement hors ligne
system_busy - toutes les connexions sont occupées
error - une erreur de traitement de syntaxe ou de bureau d'enregistrement s'est produite
5Plus d'informations sur le résultat/prix, seulement utilisé quand le résultat est "error" ou que "show_price" est mis à "1" dans la requête.

Exemple de Recherche

Requête

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=search&domain0=mydomain.com&domain1=mydomain.net&show_price=1

Réponse

ok, domain0,mydomain.com,,no, domain1,mydomain.net,,yes,10.99 in USD

Commande Register (Enregistrer)

Appeler la commande register créera une commande d'enregistrement qui sera traitée. Vous devez avoir un montant suffisant sur votre compte pour pouvoir payer la commande. Lors d'un appel à la commande register, les paramètres suivants doivent être inclus :

Paramètres de Requête Register
Explication
domainLe nom de domaine que vous voulez enregistrer, seul 1 domaine peut être enregistré par requête
languageLe tag de langage pour le domaine en question, à utiliser seulement si le domaine est un IDN
durationPour combien d'années vous voulez enregistrer le domaine
option0 (si nécessaire)Le nom de déclarant (titulaire) de .BE
option1 (si nécessaire)Le nom de l'organisation du déclarant (titulaire) de .BE (facultatif)

Il y aura 1 de résultat pour chaque requête soumise. Chaque ligne comptera 3 champs.

Champ de Résultat d'Enregistrement
Explication
1Le résultat de la requête d'enregistrement:
success - le domaine a été enregistré avec succès
not_available - le domaine n'est pas disponible
insufficient_funds - pas suffisamment de solde de compte pour traiter cet enregistrement
offline - le bureau central d'enregistrement de ce domaine est actuellement hors ligne
system_busy - toutes les connexions sont occupées
error - une erreur de traitement de syntaxe ou de bureau d'enregistrement s'est produite
2Plus d'informations sur le résultat. Utilisé seulement quand le résultat est "error"
3Date d'expiration en temps unix (millisecondes depuis le 1 janvier 1970 à minuit UTC), seulement utilisée quand le résultat est "success"

Exemple d'Enregistrement

Requête

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=register&domain=mydomain.com&duration=1

Réponse

ok, success,,1180897681932

Commande Delete (Supprimer)

Appeler la commande de suppression supprimera un domaine qui est encore dans le délai de grâce. Votre solde de compte sera crédité du montant de l'enregistrement moins tout frais de suppression (voir notre page suppression dans le délai de grâce pour plus d'informations). Les domaines qui ont été renouvelés, ou qui ont été déplacés vers un nouveau compte, ne peuvent pas être supprimés avec l'API. Si vous appelez la commande de suppression, les paramètres suivants doivent être inclus :

Paramètres de Requête Delete
Explication
domainLe nom de domaine que vous voulez supprimer, seul 1 domaine peut être supprimé par requête

Il y aura 1 de résultat pour chaque requête soumise. Chaque ligne comptera 2 champs.

Champ de Résultat de Suppression
Explication
1Résultat de la requête delete:
success - le domaine a été supprimé avec succès
grace_expired - le délai de grâce a déjà expiré
too_soon - impossible de supprimer un domaine la première heure qui suit l'enregistrement
offline - le bureau central d'enregistrement est actuellement hors ligne
error - une erreur de traitement de syntaxe ou de bureau d'enregistrement s'est produiteerror - une erreur de traitement de syntaxe ou de bureau d'enregistrement s'est produite
2Plus d'informations sur le résultat. Utilisé seulement quand le résultat est "error"

Exemple de Suppression

Requête

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=delete&domain=mydomain.com

Réponse

ok, success,

Commande Renew (Renouveler)

Appeler la commande de renouvellement créera et traitera une commande de renouvellement. Vous devez avoir suffisamment de solde de compte pour payer la commande. Quand la commande de renouvellement est appelée, les paramètres suivants doivent être inclus :

Paramètre de Requête Renew
Explication
domainLe nom de domaine que vous voulez renouveler, 1 seul domaine peut être renouvelé par requête
durationRenouveler le domaine pour combien d'années
year (facultatif)L'année actuelle d'expiration du domaine

Il y aura 1 de résultat pour chaque requête soumise. Chaque ligne comptera 3 champs.

Paramètre de Requête Renew
Explication
1Résultat de la requête renew:
success - le domaine a été renouvelé avec succès
insufficient_funds - solde de compte insuffisant pour procéder au renouvellement
offline - le bureau central d'enregistrement de ce domaine est actuellement hors ligne
error - une erreur de traitement de syntaxe ou de bureau d'enregistrement s'est produite
2Plus d'informations sur le résultat. Utilisé seulement quand le résultat est "error"
3Date d'expiration en temps unix (millisecondes depuis le 1 janvier 1970 à minuit UTC), seulement utilisée quand le résultat est "success"

Exemple de Renouvellement

Requête

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=renew&domain=mydomain.com&duration=1

Réponse

ok, success,,1180897681932

Commande Get Name Servers (Obtenir les Serveurs de Noms)

Si la commande get name servers est appelée, les paramètres suivants doivent être inclus :

Paramètres de Requête Get Name Servers
Explication
domainLe domaine avec les informations de serveur de noms que vous voulez obtenir, seules les informations de serveur de noms du domaine 1 peuvent être transférées (pull) par requête.

Il y aura 1 de résultat pour chaque requête soumise. Chaque ligne comptera 2 champs.

Champ de Résultat Get Name Servers
Explication
1Réqultat de la requête get name servers:
success - les serveurs de noms ont été renvoyés avec succès
offline - le bureau central d'enregistrement de ce domaine est actuellement hors ligne
error - une erreur de traitement de syntaxe ou de bureau d'enregistrement s'est produite
2Les informations détaillées des serveurs de noms (ns0 - ns12) ou plus d'informations à propos du résultat si le résultat est "error"
3Plus d'informations à propos de la configuration des serveurs de noms, seulement utilisé quand le résultat est "success"

Exemple Get Name Servers

Requête

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=get_ns&domain=mydomain.com

Réponse

ok, success,ns1.dynadot.com,ns2.dynadot.com,,,,,,,,,,,,Dynadot Forwarding

Commande Set Name Servers (Définir les Serveurs de Noms)

Si la commande set name servers est appelée, les paramètres suivants doivent être inclus :

Paramètres de Requête Get Name Servers
Explication
domainLe nom de domaine à mettre à jour, seul 1 domaine peut être modifié par requête
ns0 - ns12Les serveurs de noms à définir pour votre domaine, vous pouvez spécifier jusqu'à 13 serveurs de noms, mais ils doivent déjà être sur votre compte.

Il y aura 1 de résultat pour chaque requête soumise. Chaque ligne comptera 2 champs.

Champ de Résultat de Set Name Servers (Définir Serveurs de Noms)
Explication
1Résultat de la requête set name servers:
success - les serveurs de noms ont été paramétrés avec succès
offline - le bureau central d'enregistrement est actuellement hors ligne
error - une erreur de traitement de syntaxe s'est produite
2Plus d'informations sur le résultat. Utilisé seulement quand le résultat est "error"

Exemple Set Name Servers

Requête

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=set_ns&domain=mydomain.com&ns0=ns1.hostns.com&ns1=ns2.hostns.com

Réponse

ok, success,

Commande Set Renew Options (Définir les Options de Renouvellement)

Si la commande set renew options est appelée, les paramètres suivants doivent être inclus :

Paramètre de Requête Set Renew Options
Explication
domainLe nom de domaine à mettre à jour, seul 1 domaine peut être modifié par requête
renew-optionreset - réinitialise l'option de renouvellement de domaine à "no renew option" (pas d'option de renouvellement)
donot - positionne l'option de renouvellement de domaine à "do not renew" (ne pas renouveler)
auto - positionne l'option de renouvellement de domaine à "auto-renew" (renouvellement automatique)

Il y aura 1 de résultat pour chaque requête soumise. Chaque ligne comptera 2 champs.

Champ de Résultat Set Renew Options
Explication
1Résultat de la requête set renew options:
success - les options de renouvellement ont été paramétrées avec succès
error - une erreur de traitement de syntaxe s'est produit
2Plus d'informations sur le résultat. Utilisé seulement quand le résultat est "error"

Exemple Set Renew Options

Requête

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=set_renew_option&domain=mydomain.com&renew-option=donot

Réponse

ok, success,

Commande Set Folder (Définir le Dossier)

Si la commande set folder est appelée, les paramètres suivants doivent être inclus :

Paramètre de la Requête Set Folder
Explication
domainLe nom de domaine à mettre à jour, seul 1 domaine peut être modifié par requête
folderLe nom de dossier vers lequel vous voulez déplacer votre domaine.
Utilisez "Default" pour le nom de dossier si vous voulez déplacer le domaine vers le dossier par défaut.
Le nom de dossier est sensible à la casse, par exemple, "Folder1" et "folder1" sont deux noms de dossiers différents.

Il y aura 1 de résultat pour chaque requête soumise. Chaque ligne comptera 2 champs.

Paramètre de Requête Set Folder
Explication
1Résultat de la requête set folder:
success - le dossier a été paramétré avec succès
error - une erreur de traitement de syntaxe s'est produite.
2Plus d'informations sur le résultat. Utilisé seulement quand le résultat est "error"

Exemple Set Folder

Requête

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=set_folder&domain=mydomain.com&folder=folder1

Réponse

ok, success,

Commande Is-Processing

Si la commande is_processing est appelée, les paramètres suivants doivent être inclus.

Paramètre de la requête Is-Processing
Explication
aucun paramètre supplémentaire n'est requis

Il y aura 1 de résultat pour chaque requête soumise. Chaque ligne comptera 1 champs.

Champ de Résultat de Is-Processing
Explication
1Résultat de la requête is_processing:
yes - une requête est en cours de traitement, une nouvelle requête ne devrait pas être envoyée
no - aucune requête en cours de traitement. Une nouvelle requête peut être envoyée en toute sécurité.

Exemple Is-Processing

Requête

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=is_processing

Réponse

ok, yes,

Langages

Afrikaans:afr Chinese:chi Arabic:ara Persian:per Russian:rus Japanese:jpn Spanish:spa Hebrew:heb Korean:kor Bulgarian:bul Chinese-Simplified:zh-cn French:fre Hungarian:hun Turkish:tur Danish:dan Thai:tha German:ger Hindi:hin Greek:gre Icelandic:ice Portuguese:por Swedish:swe Polish:pol Ukrainian:ukr Chinese-Traditional:zh-tw Bosnian:bos Czech:cze Norwegian:nor Finnish:fin Italian:ita Cyrillic:cyrl Belarusian:bel Georgian:geo Vietnamese:vie Latvian:lav Bengali:ben Albanian:alb Romanian:rum Serbian:scc Tamil:tam Panjabi:pan Slovak:slo Armenian:arm Irish:gle Catalan:cat Urdu:urd Slovenian:slv Gujarati:guj Lithuanian:lit Macedonian:mac Khmer:khm Telugu:tel Dutch:dut Kazakh:kaz Malayalam:mal Welsh:wel Tibetan:tib Estonian:est Indic:inc Mongolian:mon Gaelic:gla Bodo:brx Uzbek:uzb Somali:som Javanese:jav Pushto:pus Swahili:swa Aragonese:arg Assamese:asm Sanskrit:san Chechen:che Kirghiz:kir Luxembourgish:ltz Maltese:mlt Kashmiri:kas Yiddish:yid Burmese:bur Nepali:nep Carib:car Coptic:cop Malay:may Syriac:syr Oriya:ori Samoan:smo Asturian:ast Avestan:ave Awadhi:awa Azerbaijani:aze Balinese:ban Baluchi:bal Basa:bas Bashkir:bak Basque:baq Bhojpuri:bho Chuvash:chv Corsican:cos Croatian:scr Divehi:div Dogri:doi Faroese:fao Fijian:fij Frisian:fry Gondi:gon Indonesian:ind Ingush:inh Kurdish:kur Lao:lao Maori:mao Moldavian:mol Ossetian:oss Rajasthani:raj Sardinian:srd Sindhi:snd Sinhalese:sin Tajik:tgk Latin:latn Konkani:knn Maithili:mai Marathi:mar Punjabi:pun