域名API

通过Dynadot的域名API获取被放弃的域名并管理您的账户!我们的域名API允许您以编程的方式使用您自己的软件和服务器对域名进行搜索、注册、续期和删除。通过我们的域名API,您也可以轻松地为您的域名设置名字服务器、续期选项和文件夹。我们的域名API对所有账户开放,立即开始吧!

想要更多功能?查看我们的高级域名API

现在就开始使用域名API吧!

对域名API的请求已发送至以下URL:

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

请注意,请求应通过https(安全套接)发送,以确保安全性。一次仅能处理1条请求,所以请您等待当前请求处理完毕再发送另一条请求。请求应包含下列参数:

请求参数
解释
key您进入API的密匙,位于您账户的控制面板中
command目前支持的命令为“搜索”和“注册”

结果显示为由逗号划定的文本文件。第一行是命令结果。该行有2个字段。

结果字段
解释
1此API调用的结果:
ok - 命令成功
error - 命令不成功
2关于结果的更多信息,仅结果为“错误”时使用

第二行为空,后续各行为命令结果,例如您的搜索结果

搜索结果

如要发送搜索命令,则需包含下面参数:

搜索参数
解释
domain0 - domain99您正搜索的域名,您可指定多达100个域名
language0 - language99 (可选)各自域名的语言标签,仅用于国际化域名
show_price (可选)如果您想在账户货币中显示价格,请设置为等于“1”

每个提交的域名将有1个结果行,每行有5个字段

搜索结果字段
解释
1域名参数,例如: domain0
2已搜索域名,例如 mydomain.com
3语言(如存在),例如:spa
4搜索的结果:
yes -域名可用
no -域名不可用
offline -此域名的中央注册处目前处于离线状态
system_busy -所有连接正忙
error -处理此域名时出现与方法或注册错误
5有关结果/价格的更多信息,仅当结果为“错误”或当您将“show_price”在请求中设置为“1”时使用

搜索示例

请求

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

响应

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

注册命令

发送注册命令后将创建并处理注册订单。您账户中须由足够余额支付订单。如果发送注册命令,须包含下列参数:

注册请求参数
解释
domain您想注册的域名,每个请求仅可注册1个域名
language被请求域名的语言标签,仅国际化域名需要
duration您希望注册域名几年
option0 (如果必要).BE注册人姓名
option1 (如果必要).BE注册人组织名称(可选)

每个提交的请求将有1个结果行,每行有3个字段

注册结果字段
解释
1注册请求的结果:
success -域名已成功注册
not_available -域名不可用
insufficient_funds -没有足够的育儿处理此注册
offline -此域名的中央注册处目前处在离线状态
system_busy -所有连接正忙
error -处理此请求时出现语法或注册错误
2关于结果的更多信息,仅结果为“错误”时使用
3以unix时间(毫秒数,自UTC1970年1月1日午夜)计算的过期日期,仅当结果为“成功”时使用

注册示例

请求

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

响应

ok, success,,1180897681932

删除命令

调用删除命令将删除仍然处于宽限期内的域名。您的账户余额将存入注册费减去任何删除费用所得金额(查看我们的宽限删除页面获取更多信息)。已续期或已转移至新账户的域名将无法通过API删除。如果调用删除命令,应包括以下参数:

删除请求参数
解释
domain您想删除的域名,每次请求仅可删除1个域名

每个提交的请求将有1个结果行,每行有2个字段

删除结果字段
解释
1删除请求的结果:
success - 域名已成功删除
grace_expired - 宽限期已过期
too_soon - 无法在注册后的第一个小时删除域名
offline - 此域名的中央注册处目前处在离线状态
error - 处理此请求时出现语法或注册错误error - 处理此请求时出现语法或注册错误
2关于结果的更多信息,仅结果为“错误”时使用

删除示例

请求

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

响应

ok, success,

续费命令

调用续期(renew)命令将创建和处理续期订单。您必须具备足够的账户余额用于该订单。如果调用续期命令,应包括以下参数:

续费请求参数
解释
domain您想续费的域名,每个请求仅可续费1个域名
duration需要为域名续费多少年
year (可选)域名过期的当前年份

每个提交的请求将有1个结果行,每行有3个字段

续费请求参数
解释
1续期勤求:结果
success - 域名已成功续期
insufficient_funds - 没有足够的账户余额进行此续期
offline - 此域名的中央注册处现在处于离线状态
error - 处理此请求时出现语法或注册错误
2关于结果的更多信息,仅结果为“错误”时使用
3以unix时间(毫秒数,自UTC1970年1月1日午夜)计算的过期日期,仅当结果为“成功”时使用

续费示例

请求

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

响应

ok, success,,1180897681932

获取域名服务器命令

如要呼叫获取域名服务器命令,应包含下列参数:

获取域名服务器请求参数
解释
domain您想获得的该域名的域名服务器信息,每次请求仅能抓取1条该域名的域名服务器信息

每个提交的请求将有1个结果行,每行有2个字段

获取域名服务器结果字段
解释
1获取名字服务器请求的结果:
success - 名字服务器已成功返回
offline - 此域名的中央注册处目前处于离线状态
error - 处理此请求时出现语法或注册错误
2(ns0 - ns12)域名服务器的详细信息,或者结果的更多信息,若结果为“错误”
3域名服务器设置的更多信息,仅结果为“成功”时使用

获取域名服务器示例

请求

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

响应

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

设置域名服务器命令

如要呼叫设置域名服务器命令,应包含下列参数:

设置域名服务器请求参数
解释
domain要更新的域名,每次请求仅可设置1个域名
ns0 - ns12设置以启用您域名的域名服务器,您可指定多达13个域名服务器,但它们必须已经在您的账户中

每个提交的请求将有1个结果行,每行有2个字段

设置名字服务器结果字段
解释
1设置名字服务器请求结果:
success - 名字服务器已成功设置
offline - 此域名的中央注册处目前处于离线状态
error - 处理此请求时出现语法或注册错误
2关于结果的更多信息,仅结果为“错误”时使用

设置域名服务器示例

请求

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

响应

ok, success,

设置续费选项命令

如果发送设置续费选项命令,则须包含下列参数:

设置续费选项请求参数
解释
domain要更新的域名,每次请求仅可设置1个域名
renew-optionreset - 设置域名的续期选项为“无续期选项”
donot - 设置域名的续期选项为“不续期”
auto - 设置域名的续期选项为“自动续期”

每个提交的请求将有1个结果行,每行有2个字段

设置续费选项结果字段
解释
1设置续期选项请求结果。设置续期选项请求结果:
success - 续期选项已成功设置
error - 处理此请求时出现语法错误
2关于结果的更多信息,仅结果为“错误”时使用

设置续费选项示例

请求

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

响应

ok, success,

设置文件夹命令

如果发送设置文件夹命令,则须包含下列参数:

设置文件夹请求参数
解释
domain要更新的域名,每次请求仅可设置1个域名
folder您要把域名移入其中的文件夹名称
如果您想把域名移动至默认文件夹,可使用"Default"作为文件夹名称
文件夹名称为大小写敏感,例如"Folder1"和"folder1"是不同的文件夹名称

每个提交的请求将有1个结果行,每行有2个字段

设置文件夹请求参数
解释
1设置文件夹请求结果:
success - 文件夹已成功设置
error - 处理此请求时出现语法错误
2关于结果的更多信息,仅结果为“错误”时使用

设置文件夹示例

请求

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

响应

ok, success,

Is_Processing命令

如果呼叫is_processing命令,则须包含以下参数:

正在处理请求参数
解释
不需额外参数

每个提交的域名将有1个结果行,每行有1个字段

正在处理结果字段
解释
1处理请求的结果:
yes - 正在处理一个请求,不应发送新请求
no - 没有正在处理的请求。可以安全地发送新请求。

Is_Processing示例

请求

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

响应

ok, yes,

语言

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