高级域名API

Advanced Domain API from Dynadot - Manage Domains with Your Own Software

希望获得域名API的更多功能?只需看看我们的高级域名API。该版本的API让您可以使用自己的软件和服务器操作超过50条命令,包括创建文件夹、设置Whois、设置隐私、设置电子邮件转发等等!我们的高级域名API对所有账户开放,只需按照以下指引开始即可。

需要使用API的更简单方式?查看我们的域名API页面

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

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

https://api.dynadot.com/api3.xml

请注意,请求应通过https(安全套管)发送,以确保安全。每次仅可处理1条请求,所以在发送另一条请求前,请等待您目前的请求处理完毕。请求应包含以下参数:

请求参数
解释
Key您进入API的密匙,位于您账户的控制面板中

我们的高级域名API将返回XML格式结果;您的请求应包含下列2个或3个字段:

XML标签名称
解释
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用
 

搜索结果

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

搜索参数
解释
domain0 - domain99您正搜索的域名,您可指定多达100个域名
language0 - language99 (可选)各自域名的语言标签,仅用于国际化域名
show_price (可选)如果您想在账户货币中显示价格,请设置为等于“1”
XML结果标签
解释
<Results></Results>搜索命令XML响应的根节点
<SearchResponse></SearchResponse>搜索响应标签
<SearchHeader></SearchHeader>搜索标头标签
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用
<DomainName></DomainName>您刚刚搜索的域名
<Available></Available>如果域名可用
<Price></Price>若您将"show_price"设为等于“1”,且该域名可购,则将告知您相关价格信息
<Language></Language>域名的语言信息

搜索示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=search&domain0=mydomain.com&domain1=mydomain.net&show_price=1

响应
<Results>
  <SearchResponse>
    <SearchHeader>
      <SuccessCode>0</SuccessCode>
      <DomainName>mydomain.com</DomainName>
      <Status>success</Status>
      <Available>yes</Available>
      <Price>10.99 in USD</Price>
    </SearchHeader>
  </SearchResponse>
  <SearchResponse>
    <SearchHeader>
      <SuccessCode>0</SuccessCode>
      <DomainName>mydomain.net</DomainName>
      <Status>success</Status>
      <Available>yes</Available>
      <Price>9.99 in USD</Price>
    </SearchHeader>
  </SearchResponse>
</Results>
 

注册命令

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

注册请求参数
解释
domain您想注册的域名,每个请求仅可注册1个域名
language (可选)被请求域名的语言标签,仅国际化域名需要
duration注册所需的时长
option0 (如果必要).UK注册人名称或组织
.AT, .BE, .LT,或.PH 注册人名称
option1 (如果必要).AT, .BE, .LT,或.PH注册人组织(可选)
对于.AT,您可指定为option0, option1,,或两者同时指定
option2 (如果必要)
XML结果标签
解释
<RegisterResponse></RegisterResponse>注册响应标签
<RegisterHeader></RegisterHeader>注册标头标签
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用
<RegisterContent></RegisterContent>注册内容标签
<Expiration></Expiration>以Unix时间计的过期日期(毫秒,自1970年1月1日午夜起),仅结果为"success"时使用
<Registration></Registration>以Unix时间计的注册日期(毫秒,自1970年1月1日午夜起),仅结果为"success"时使用

注册示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=register&domain=domain1.net&duration=3

响应
<RegisterResponse>
  <RegisterHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </RegisterHeader>
  <RegisterContent>
    <Expiration>1458379145266</Expiration>
  </RegisterContent>
</RegisterResponse>
 

删除命令

调用删除(delete)命令将删除仍然处于宽限期中的域名。注册费将退回至您的账户余额。已续期或已移动至新账户的域名不得通过API进行删除。如果调用删除命令,应包括以下参数:

删除请求参数
解释
domain您想删除的域名,每次请求仅可删除1个域名
XML结果标签
解释
<DeleteResponse></DeleteResponse>删除响应标签
<DeleteHeader></DeleteHeader>删除标头标签
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

删除示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=delete&domain=domain1.com

响应
<DeleteResponse>
  <DeleteHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </DeleteHeader>
</DeleteResponse>
 

续费命令

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

续费请求参数
解释
domain您想续费的域名,每个请求仅可续费1个域名
duration需要为域名续费多少年
year (可选)域名过期的当前年份
XML结果标签
解释
<RenewResponse></RenewResponse>续费响应标签,它是响应XML文档的根节点
<RenewHeader></RenewHeader>续费标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用
<RenewContent></RenewContent>续费内容标签,仅状态为"success"时使用
<Expiration></Expiration>以Unix时间计的过期日期(毫秒,自1970年1月1日午夜起),仅结果为"success"时使用

续费示例

请求

https://api.dynadot.com/api3.xml?key=50&domain=domian1.com&command=renew&duration=1

响应
<RenewResponse>
  <RenewHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </RenewHeader>
  <RenewContent>
    <Expiration>73984579834</Expiration>
  </RenewContent>
</RenewResponse>
 

域名信息命令

该命令尽在XML格式下可用:

域名信息请求参数
解释
domain每个请求仅允许1个域名
XML结果标签
解释
<DomainInfoResponse></DomainInfoResponse>响应XML文档的根节点
<DomainInfoResponseHeader></DomainInfoResponseHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用
<DomainInfoContent></DomainInfoContent>响应内容
<Domain></Domain>域名
<Name></Name>域名名称
<Expiration></Expiration>以Unix时间计的域名过期日期(毫秒,自1970年1月1日起)
<NameServerSettings></NameServerSettings>域名的域名服务器设置
<Type></Type>域名的域名服务器类型
<WithAds></WithAds>如果您想为域名创建停放页面
<Whois></Whois>Whois信息
<Registrant></Registrant>注册人信息
<ContactId></ContactId>联系方式ID
<Admin></Admin>管理员信息
<Technical></Technical>技术信息
<Billing></Billing>计费信息
<Locked></Locked>是否锁定
<Disabled></Disabled>启用状态
<UdrpLocked></UdrpLocked>UDRP锁定或未锁定
<UdrpLocked></UdrpLocked>UDRP锁定或未锁定
<RegistrantUnverified></RegistrantUnverified>未验证注册人
<Hold></Hold>暂停
<Privacy></Privacy>隐私保护状态
<isForSale></isForSale>销售状态
<RenewOption></RenewOption>续费选项
<Note></Note>备注
<Folder></Folder>文件夹信息
<FolderId></FolderId>文件夹ID
<FolderName></FolderName>文件夹名称

域名信息示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=domain_info&domain=domain1.com

响应
<DomainInfoResponse>
  <DomainInfoResponseHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </DomainInfoResponseHeader>
  <DomainInfoContent>
    <Domain>
      <Name>domain1.com</Name>
      <Expiration>1370056762789</Expiration>
      <NameServerSettings>
        <Type>Dynadot Parking</Type>
        <WithAds>yes</WithAds>
      </NameServerSettings>
      <Whois>
        <Registrant>
          <ContactId>0</ContactId>
        </Registrant>
        <Admin>
          <ContactId>0</ContactId>
        </Admin>
        <Technical>
          <ContactId>0</ContactId>
        </Technical>
        <Billing>
          <ContactId>0</ContactId>
        </Billing>
      </Whois>
      <Locked>yes</Locked>
      <Disabled>no</Disabled>
      <UdrpLocked>no</UdrpLocked>
      <RegistrantUnverified>no</RegistrantUnverified>
      <Hold>no</Hold>
      <Privacy>none</Privacy>
      <isForSale>yes</isForSale>
      <RenewOption>no renew option</RenewOption>
      <Note></Note>
      <Folder>
        <FolderId>-1</FolderId>
        <FolderName>(no folder)</FolderName>
      </Folder>
    </Domain>
  </DomainInfoContent>
</DomainInfoResponse>
 

设置Whois命令

如果设置Whois命令,则应包含以下参数:

设置Whois请求参数
解释
domain您要设置的域名,每个请求仅可设置100个域名,请务必用逗号将其隔开
registrant_contact域名的注册人信息
admin_contact域名管理员信息
technical_contact域名的技术信息
billing_contact域名的计费信息
XML结果标签
解释
<SetWhoisResponse></SetWhoisResponse>响应XML文档的根节点
<SetWhoisHeader></SetWhoisHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置Whois示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_whois&domain=domain4.com&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0

响应
<SetWhoisResponse>
  <SetWhoisHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetWhoisHeader>
</SetWhoisResponse>
 

设置域名服务器命令

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

设置域名服务器请求参数
解释
domain您要设置的域名,每个请求仅可设置100个域名,请务必用逗号将其隔开
ns0 - ns12您要设置并启用域名的域名服务器,您可指定多达13个域名服务器,但它们必须已经在您的账户中
XML结果标签
解释
<SetNsResponse></SetNsResponse>设置域名服务器响应标签,它是响应XML文档的根节点
<SetNsHeader></SetNsHeader>设置域名响应标题标签
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置域名服务器示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_ns&domain=domain1.com,domain2.com&ns0=ns1.hostns.com&ns1=ns2.hostns.com

响应
<SetNsResponse>
  <SetNsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetNsHeader>
</SetNsResponse>
 

设置停放命令

如设置停靠命令,则下列参数应包含在内:

设置域名停放请求参数
解释
domain您要设置的域名,每个请求仅可设置100个域名,请务必用逗号将其隔开
with_ads (可选)如果您不要第三方广告,则可将此参数设为"no"
XML结果标签
解释
<SetParkingResponse></SetParkingResponse>设置停放响应的标签,为响应XML文档的根节点
<SetParkingHeader></SetParkingHeader>设置域名停放文件夹标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置域名停放示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_parking&domain=domain1.com&with_ads=no

响应

<SetParkingResponse><SetParkingHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetParkingHeader></SetParkingResponse>

 

设置转发命令

如果发送设置转发命令,则须包含下列参数

设置转发请求参数
解释
domain您要设置的域名,每个请求仅可设置100个域名,请务必用逗号将其隔开
forward_url您希望域名跳转至的URL
is_temp (可选)您要跳转域名的跳转状态,默认值为"temporary",,若您要永久跳转,则可将此参数设为"no"
XML结果标签
解释
<SetForwardingResponse></SetForwardingResponse>响应XML文档的根节点
<SetForwardingHeader></SetForwardingHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置转发示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_forwarding&forward_url=http://www.mydomain.com&domain=domain1.com,domain2.com

响应

<SetForwardingResponse><SetForwardingHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetForwardingHeader></SetForwardingResponse>

 

设置隐身命令

如果发送设置隐身命令,则须包含下列参数:

设置隐身请求参数
解释
domain您要设置的域名,每个请求仅可设置100个域名,请务必用逗号将其隔开
stealth_url您希望域名跳转至的URL
stealth_title (可选)页面标题
XML结果标签
解释
<SetStealthResponse></SetStealthResponse>响应XML文档的根节点
<SetStealthHeader></SetStealthHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置隐身示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_stealth&domain=domain1.com&stealth_title=obama's shop&stealth_url=http://www.obamashop.com

响应

<SetStealthResponse><SetStealthHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetStealthHeader></SetStealthResponse>

 

设置托管命令

如果发送设置托管命令,则须包含下列参数:

设置托管请求参数
解释
domain您要设置的域名,每个请求仅可设置100个域名,请务必用逗号将其隔开
hosting_type您想要的托管类型,可选择"advanced"和"basic"
mobile_view_on仅当hosting_type为"advanced",时刻将此参数设为"yes"
XML结果标签
解释
<SetHostingResponse></SetHostingResponse>响应XML文档的根节点
<SetHostingHeader></SetHostingHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置托管示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_hosting&domain=domain8.com&hosting_type=advanced&mobile_view_on=yes

响应

<SetHostingResponse><SetHostingHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetHostingHeader></SetHostingResponse>

 

设置域名系统命令

如果发送设置域名系统命令,则须包含下列参数:

(此命令已过时,不建议使用,请使用设置DNS2命令)

设置域名系统请求参数
解释
domain您要设置的域名,每个请求仅可设置100个域名,请务必用逗号将其隔开
main_record_type主要记录类型
main_record为您的域名制定一个域名系统记录
main_txt1 - main_txt4 (可选)为您的域名指定一个TXT记录;如果您的main_record_type为aaaa,且指定了一个main_record2,则您可设置多达3个main_txts,否则,您可设置多达4个main_txts
main_record2主记录2,仅当"main_record_type"为"aaaa"时使用,其值必须为IPV4格式
subdomain0 - subdomain20 (可选)Subdomain records (可选)
sub_record_type0 - sub_record_type20 (可选)子域名记录类型
sub_record0 - sub_record20 (可选)IP地址或目标主机
mx_host0 - mx_host2 (可选)指定您域名的邮箱主机,distance0为最高优先级
mx_distance0 - mx_distance2 (可选)Distance0为最高优先级
ttl (可选)生存时间
XML结果标签
解释
<SetDnsResponse></SetDnsResponse>响应XML文档的根节点
<SetDnsHeader></SetDnsHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置域名系统示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_dns&domain=domain1.com&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1

响应

<SetDnsResponse><SetDnsHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetDnsHeader></SetDnsResponse>

 

设置DNS2命令

如果调用设置DNS2命令,应包含以下参数:

设置DNS2请求参数
解释
domain您要设置的域名,每个请求仅可设置100个域名,请务必用逗号将其隔开
main_record_type0 - main_record_type19主记录类型应为"a"、"aaaa"、"cname"、"forward"、"txt"、"mx"、"stealth"、"email"
main_record0 - main_record19为您的域名指定DNS记录
main_recordx0 - main_recordx19Mx距离、转发类型、隐形转发标题或电子邮件别名当sub_record_type为"forward"、"mx"、"stealth"、"email"时必须提供
subdomain0 - subdomain49 (可选)Subdomain records (可选)
sub_record_type0 - sub_record_type49子域名记录类型应为"a"、"aaaa"、"cname"、"forward"、"txt"、"srv"、"mx"、"stealth"、"email"
sub_record0 - sub_record49子域名IP地址或目标主机
sub_recordx0 - sub_recordx49Mx距离、转发类型、隐形转发标题或电子邮件别名当sub_record_type为"forward"、"mx"、"stealth"、"email"时必须提供
ttl (可选)生存时间
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置DNS2示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_dns2&domain=domain1.com&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1&main_record_type1=mx&main_record1=mail1.myisp.com&main_recordx1=0&subdomain0=www&sub_record_type0=a&sub_record0=192.168.1.1

响应

<SetDnsResponse><SetDnsHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetDnsHeader></SetDnsResponse>

 

设置免费托管命令

如果发送设置免费托管命令,则须包含以下参数:

设置免费托管请求参数
解释
domain您要设置的域名,每个请求仅可设置100个域名,请务必用逗号将其隔开
style (可选)免费页面风格
title免费页面标题
body页面主要部分,可以使用HTML,但不应包含下列标签:<html>,<title>, <body>, <meta>, <script>;,请注意,输入主体的任何HTML均未验证
XML结果标签
解释
<SetFreeHostResponse></SetFreeHostResponse>设置免费主机响应标签,它是响应XML文档的根节点
<SetFreeHostHeader></SetFreeHostHeader>设置免费主机标题
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置免费托管示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_free_hosting&domain=domain1.com,domain2.com&title=Obama's shop&body=<div>this is obama's shop</div>

响应

<SetFreeHostResponse><SetFreeHostHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetFreeHostHeader></SetFreeHostResponse>

 

设置电子邮件转发命令

如果发送设置电子邮件转发命令,则须包含下列参数:

设置电子邮件转发请求参数
解释
domain您要设置的域名,每个请求仅可设置100个域名,请务必用逗号将其隔开
forward_type转发类型,可以是"donot"::不要转发邮件;"mx":将邮件转发给另一个邮箱主机(MX记录);"forward"::将邮件转发给另一个邮箱主机
username0 - username9用户名,仅"forward_type"为"forward"时使用
exist_email0 - exist_email9现有电子邮箱地址,仅当"forward_type"为"forward"时使用
mx_host0 - mx_host2邮箱主机,仅"forward_type"为"mx"时使用
mx_distance0 - mx_distance2Distance0为最高优先级,仅当"forward_type"为"mx"时使用
XML结果标签
解释
<SetEmailForwardingResponse></SetEmailForwardingResponse>响应XML文档的根节点
<SetEmailForwardingHeader></SetEmailForwardingHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置 电子邮件转发示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_email_forward&domain=domain1.com&forward_type=forward&username0=peter&exist_email0=Alex@dynadot.com

响应

<SetEmailForwardingResponse><SetEmailForwardingHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetEmailForwardingHeader></SetEmailForwardingResponse>

 

设置清除域名设置命令

如果发送设置清除域名设置命令,则须包含下列参数:

设置清除域名设置请求参数
解释
domain您要设置的域名,每个请求仅可设置100个域名,请务必用逗号将其隔开
service您要清除的服务,可以是 "forward", "stealth", "email_forwarding", "free_hosting", "dns", 以及 "nameservers"
XML结果标签
解释
<SetClearDomainSettingResponse></SetClearDomainSettingResponse>响应XML文档的根节点
<SetClearDomainSettingHeader></SetClearDomainSettingHeaderr>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置清除域名设置示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_clear_domain_setting&domain=exp2.com&service=nameservers

响应

<SetClearDomainSettingResponse><SetClearDomainSettingHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetClearDomainSettingHeader></SetClearDomainSettingResponse>

 

设置文件夹命令

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

设置文件夹请求参数
解释
domain要更新的域名,每次请求仅可设置1个域名
folder您要将域名移动至的文件夹名称,若要将域名已从至默认文件夹,则可将文件夹名设置为"Default"。文件夹名区分大小写,例如,"Folder1"和"folder1"是两个不同的文件夹名
folder_id (可选)您要将域名移动至的文件夹ID
XML结果标签
解释
<SetFolderResponse></SetFolderResponse>设置文件夹响应标签,它是响应XML文档的根节点
<SetFolderHeader></SetFolderHeader>设置文件夹标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置文件夹示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_folder&domain=domian1.com&folder=folder1

响应

<SetFolderResponse><SetFolderHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetFolderHeader></RenewResponse>

 

设置续费选项

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

设置续费选项请求参数
解释
domain您要设置的域名,每个请求仅可设置100个域名,请务必用逗号将其隔开
renew_option可以是"donot", "auto", "reset"
XML结果标签
解释
<SetRenewOptionResponse></SetRenewOptionResponse>响应XML文档的根节点
<SetRenewOptionHeader></SetRenewOptionHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置续费选项示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_renew_option&domain=domain1.com&renew_option=auto

响应

<SetRenewOptionResponse><SetRenewOptionHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetRenewOptionHeader></SetRenewOptionResponse>

 

设置注释命令

如果发送设置注释命令,则须包含下列参数:

设置通知请求参数
解释
domain您想设置的域名,每个请求仅可设置1个域名
note您想为域名设置的注释,可以为空
XML结果标签
解释
<SetNoteResponse></SetNoteResponse>响应XML文档的根节点
<SetNoteHeader></SetNoteHeader>响应数据头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置注释示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_note&domain=domain1.com&note=Do not modify any information

响应

<SetNoteResponse><SetNoteHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetNoteHeader></SetNoteResponse>

 

设置隐私保护命令

如果发送设置隐私保护命令,则须包含下列参数:

设置隐私保护请求参数
解释
domain您要设置的域名,每个请求仅可设置100个域名,请务必用逗号将其隔开
option您想为域名设置的隐私状态,可以是"full", "partial",或者"off"
XML结果标签
解释
<SetPrivacyResponse></SetPrivacyResponse>响应XML文档的根节点
<SetPrivacyHeader></SetPrivacyHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置隐私保护示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_privacy&domain=domain1.com&option=off

响应
<SetPrivacyResponse>
  <SetPrivacyHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetPrivacyHeader>
</SetPrivacyResponse>
 

域名列表命令

该功能仅在XML格式下可用:

域名列表请求参数
解释
N/A无需额外参数
XML结果标签
解释
<ListDomainInfoResponse></ListDomainInfoResponse>响应XML文档的根节点
<ListDomainInfoHeader></ListDomainInfoHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用
<ListDomainInfoContent></ListDomainInfoContent>响应内容
<DomainInfoList></DomainInfoList>域名信息列表
<DomainInfo></DomainInfo>域名信息
<Domain></Domain>域名
<Name></Name>域名名称
<Expiration></Expiration>以Unix时间计的域名过期日期(毫秒,自1970年1月1日起)
<NameServerSettings></NameServerSettings>域名服务器设置
<Type></Type>域名服务器设置类型
<WithAds></WithAds>是否带有广告
<Whois></Whois>Whois信息
<Registrant></Registrant>注册人信息
<ContactId></ContactId>联系方式ID
<Admin></Admin>管理员信息
<Technical></Technical>技术信息
<Billing></Billing>计费信息
<Locked></Locked>是否锁定
<Disabled></Disabled>启用状态
<Hold></Hold>暂停
<Privacy></Privacy>隐私保护状态
<isForSale></isForSale>销售状态
<RenewOption></RenewOption>续费选项
<Note></Note>备注
<Folder></Folder>文件夹信息
<FolderId></FolderId>文件夹ID
<FolderName></FolderName>文件夹名称

列出域名示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=list_domain

响应
<ListDomainInfoResponse>
  <ListDomainInfoHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </ListDomainInfoHeader>
  <ListDomainInfoContent>
    <DomainInfoList>
      <DomainInfo>
        <Domain>
          <Name>domain-exp140.com</Name>
          <Expiration>1361430589062</Expiration>
          <NameServerSettings>
            <Type>Dynadot Parking</Type>
            <WithAds>yes</WithAds>
          </NameServerSettings>
          <Whois>
            <Registrant>
              <ContactId>0</ContactId>
            </Registrant>
            <Admin>
              <ContactId>0</ContactId>
            </Admin>
            <Technical>
              <ContactId>0</ContactId>
            </Technical>
            <Billing>
              <ContactId>0</ContactId>
            </Billing>
          </Whois>
          <Locked>yes</Locked>
          <Disabled>no</Disabled>
          <Hold>no</Hold>
          <Privacy>none</Privacy>
          <isForSale>no</isForSale>
          <RenewOption>no renew option</RenewOption>
          <Note></Note>
          <Folder>
            <FolderId>-1</FolderId>
            <FolderName>(no folder)</FolderName>
          </Folder>
        </Domain>
      </DomainInfo>
      <DomainInfo>
        <Domain>
          <Name>domain-exp141.com</Name>
          <Expiration>1361430589062</Expiration>
          <NameServerSettings>
            <Type>Dynadot Parking</Type>
            <WithAds>yes</WithAds>
          </NameServerSettings>
          <Whois>
            <Registrant>
              <ContactId>0</ContactId>
            </Registrant>
            <Admin>
              <ContactId>0</ContactId>
            </Admin>
            <Technical>
              <ContactId>0</ContactId>
            </Technical>
            <Billing>
              <ContactId>0</ContactId>
            </Billing>
          </Whois>
          <Locked>yes</Locked>
          <Disabled>no</Disabled>
          <Hold>no</Hold>
          <Privacy>none</Privacy>
          <isForSale>no</isForSale>
          <RenewOption>no renew option</RenewOption>
          <Note></Note>
          <Folder>
            <FolderId>-1</FolderId>
            <FolderName>(no folder)</FolderName>
          </Folder>
        </Domain>
      </DomainInfo>
    </DomainInforList>
  </ListDomainInfoContent>
</ListDomainInfoResponse>
 

创建联系方式命令

如果发送创建联系方式命令,则须包含下列参数:

创建联络人请求参数
解释
organization (可选)机构信息
name姓名
email邮箱
phonenum电话号码
phonecc国家区号
faxnum (可选)传真号码
faxcc (可选)传真国家区号
address1地址1
address2 (可选)第2行地址
city城市
state
zip邮政区代码
country国家
XML结果标签
解释
<CreateContactResponse></CreateContactResponse>响应XML文档的根节点
<CreateContactHeader></CreateContactHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用
<CreateContactContent></CreateContactContent>&lt;ContactId&gt;New Contact ID&lt;/ContactId&gt;,,仅当状态为"success"时使用

创建联系方式示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=create_contact&name=Webb&email=myemail@email.com&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=America&zip=94401&country=US

响应
<CreateContactResponse>
  <CreateContactHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </CreateContactHeader>
  <CreateContactContent>
    <ContactId>1234</ContactId>
  </CreateContactContent>
</CreateContactResponse>
 

遍及联系方式命令

如果发送遍及联系方式命令,则须包含下列参数:

编辑联络人请求参数
解释
contact_id您要编辑的联络人ID
organization (可选)机构信息
name姓名
email邮箱
phonenum电话号码
phonecc国家区号
phonecc国家区号
faxnum (可选)传真号码
faxcc (可选)传真国家区号
address1地址第1行
address2 (可选)第2行地址
city城市
state
zip邮政区代码
country国家
XML结果标签
解释
<EditContactResponse></EditContactResponse>响应XML文档的根节点
<EditContactHeader></EditContactHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用
<EditContactContent></EditContactContent>响应内容
<ContactId></ContactId>联络人ID

编辑联系方式示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=edit_contact&contact_id=0&name=Webb&email=myemail@email.com&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=U.S&zip=94401&country=US

响应
<EditContactResponse>
  <EditContactHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </EditContactHeader>
  <EditContactContent>
    <ContactId>0</ContactId>
  </EditContactContent>
</EditContactResponse>
 

删除联系方式命令

如果发送删除联系方式命令,则须包含下列参数:

删除联系方式请求参数
解释
contact_id您要删除的联络人ID,务必使用逗号隔开
XML结果标签
解释
<DeleteContactResponse></DeleteContactResponse>响应XML文档的根节点
<DeleteContactHeader></DeleteContactHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

删除联系方式示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=delete_contact&contact_id=0

响应
<DeleteContactResponse>
  <DeleteContactHeader>
    <SuccessCode>-1</SuccessCode>
    <Status>error</Status>
    <Error>cannot delete these contacts (Jack Slater). Because they are in use.</Error>
  </DeleteContactHeader>
</DeleteContactResponse>
 

联系方式列表命令

该命令尽在XML格式下可用:

联系方式列表请求参数
解释
N/A无需额外参数
XML结果标签
解释
<ContactListResponse></ContactListResponse>响应XML文档的根节点
<ContactListHeader></ContactListHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用
<ContactListContent></ContactListContent>响应内容
<ContactList></ContactList>联系方式列表
<Contact></Contact>联系方式信息
<ContactId></ContactId>联络人ID
<Organization></Organization>联系机构
<Name></Name>姓名
<Email></Email>邮箱
<PhoneCc></PhoneCc>国家区号
<PhoneNum></PhoneNum>电话号码
<FaxCc></FaxCc>传真国家区号
<FaxNum></FaxNum>传真号码
<Address1></Address1>地址第1行
<Address2></Address2>第2行地址
<City></City>城市
<State></State>
<ZipCode></ZipCode>邮政区代码
<Country></Country>国家
<GtldVerified></GtldVerified>gTLD验证状态

联系方式列表示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=contact_list

响应
<ContactListResponse>
  <ContactListHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </ContactListHeader>
  <ContactListContent>
    <ContactList>
      <Contact>
        <ContactId>0</ContactId>
        <Organization></Organization>
        <Name>Jack Slater</Name>
        <Email>test@dynadot.com</Email>
        <PhoneCc>1</PhoneCc>
        <PhoneNum>555.555.5233</PhoneNum>
        <FaxCc></FaxCc>
        <FaxNum></FaxNum>
        <Address1>1 Free Way</Address1>
        <Address2></Address2>
        <City>Los Angeles</City>
        <State>CA</State>
        <ZipCode>90068</ZipCode>
        <Country>US</Country>
      </Contact>
    </ContactList>
  </ContactListContent>
</ContactListResponse>
 

获取联络人命令

该命令尽在XML格式下可用:

获取联络人请求参数
解释
contact_id联络人ID
XML结果标签
解释
<GetContactResponse></GetContactResponse>响应XML文档的根节点
<GetContactHeader></GetContactHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用
<GetContactContent></GetContactContent>响应内容
<Contact></Contact>联系方式信息
<ContactId></ContactId>联络人ID
<Organization></Organization>联系机构
<Name></Name>姓名
<Email></Email>邮箱
<PhoneCc></PhoneCc>国家区号
<PhoneNum></PhoneNum>电话号码
<FaxCc></FaxCc>传真国家区号
<FaxNum></FaxNum>传真号码
<Address1></Address1>地址第1行
<Address2></Address2>第2行地址
<City></City>城市
<State></State>
<ZipCode></ZipCode>邮政区代码
<Country></Country>国家
<GtldVerified></GtldVerified>gTLD验证状态

获取联络人示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=get_contact&contact_id=10000

响应
<GetContactResponse>
 <GetContactHeader>
  <ResponseCode>0</ResponseCode>
  <Status>success</Status>
 </GetContactHeader>
 <GetContactContent>
  <Contact>
   <ContactId>12345</ContactId>
   <Organization>org</Organization>
   <Name>name</Name>
   <Email>example@example.com</Email>
   <PhoneCc>0</PhoneCc>
   <PhoneNum>phone number</PhoneNum>
   <FaxCc>example faxcc</FaxCc>
   <FaxNum>example faxnum</FaxNum>
   <Address1>address1</Address1>
   <Address2>address2</Address2>
   <City>city</City>
   <State>state</State>
   <ZipCode>zipcode</ZipCode>
   <Country>country</Country>
  </Contact>
 </GetContactContent></GetContactResponse>
 

添加域名服务器命令

若呼叫添加域名服务器命令,则需包含以下参数:

添加域名服务器请求参数
解释
host您想添加的域名服务器主机名称
XML结果标签
解释
<AddNsResponse></AddNsResponse>响应XML文档的根节点
<AddNsHeader></AddNsHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用
<AddNsContent></AddNsContent>响应内容
<Server></Server>您已经设置的服务器
<Host></Host>新服务器的托管名称
<ServerId></ServerId>新服务器ID

添加域名服务器示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=add_ns&host=ns1.mydomain.com

响应

<AddNsResponse><AddNsHeader><SuccessCode>0</SuccessCode><Status>success</Status></AddNsHeader><AddNsContent><Server><Host>ns1.mydomain.com</Host><ServerId>0</ServerId></Server></AddNsContent></AddNsResponse>

 

注册域名服务器命令

如果呼叫注册域名服务器命令,则应包含下列参数:

注册域名服务器请求参数
解释
host您自己域名服务器的主机名称
ip您自己的域名服务器IP地址
XML结果标签
解释
<RegisterNsResponse></RegisterNsResponse>响应XML文档的根节点
<RegisterNsHeader></RegisterNsHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用
<RegisterNsContent></RegisterNsContent>响应内容
<Server></Server>服务器标签
<Host></Host>托管名称
<ServerId></ServerId>服务器ID

注册域名服务器示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=register_ns&host=domain1.com&ip=192.168.1.1

响应

<RegisterNsResponse><RegisterNsHeader><SuccessCode>0</SuccessCode><Status>success</Status></RegisterNsHeader><RegisterNsContent><Server><Host>domain1.com</Host><ServerId>0</ServerId></Server></RegisterNsContent></RegisterNsResponse>

 

设置域名服务器IP命令

若呼叫设置域名服务器IP命令,则应包含以下参数:

设置域名服务器IP请求参数
解释
server_id您要设置的域名服务器ID
ip0 - ip9您要为域名服务器设置的IP地址,每个请求可以设置9个IP,需用逗号隔开
XML结果标签
解释
<SetNsIpResponse></SetNsIpResponse>响应XML文档的根节点
<SetNsIpHeader></SetNsIpHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置域名服务器IP示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_ns_ip&server_id=1&ip0=192.168.1.1

响应

<SetNsIpResponse><SetNsIpHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetNsIpHeader></SetNsIpResponse>

 

删除域名服务器命令

如果呼叫删除域名服务器命令,则应包含下列参数:

删除域名服务器请求参数
解释
server_id您想删除的域名服务器ID,请务必使用逗号将其隔开
XML结果标签
解释
<DeleteNsResponse></DeleteNsResponse>响应XML文档的根节点
<DeleteNsHeader></DeleteNsHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

删除域名服务器示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=delete_ns&server_id=0

响应

<DeleteNsResponse><DeleteNsHeader><SuccessCode>0</SuccessCode><Status>success</Status></DeleteNsHeader></DeleteNsResponse>

 

服务器列表命令

该命令尽在XML格式下可用:

服务器列表请求参数
解释
N/A无需额外参数
XML结果标签
解释
<ServerListResponse></ServerListResponse>响应XML文档的根节点
<ServerListHeader></ServerListHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用
<ServerListContent></ServerListContent>响应内容
<NameServerList></NameServerList>域名服务器列表
<List></List>
<Server></Server>
<ServerId></ServerId>服务器ID
<ServerName></ServerName>服务器名称
<ServerIp></ServerIp>服务器IP

服务器列表示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=server_list

响应
<ServerListResponse>
  <ServerListHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </ServerListHeader>
  <ServerListContent>
    <NameServerList>
      <List>
        <Server>
          <ServerId>0</ServerId>
          <ServerName>ns1.com</ServerName>
          <ServerIp></ServerIp>
        </Server>
        <Server>
          <ServerId>1</ServerId>
          <ServerName>domain1.com</ServerName>
          <ServerIp>192.168.1.1,,,,,,,,,</ServerIp>
        </Server>
      </List>
    </NameServerList>
  </ServerListContent>
</ServerListResponse>
 

账户信息命令

该命令尽在XML格式下可用:

账户信息请求参数
解释
N/A无需额外参数
XML结果标签
解释
<AccountInfoResponse></AccountInfoResponse>响应XML文档的根节点
<AccountInfoHeader></AccountInfoHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用
<AccountInfoContent></AccountInfoContent>响应内容
<AccountInfo></AccountInfo>账户信息
<Username></Username>用户名
<ForumName></ForumName>论坛名称
<Contact></Contact>联系方式信息
<Organization></Organization>公司
<Organization></Organization>响应标头
<Name></Name>您的名称
<Email></Email>邮箱
<PhoneCc></PhoneCc>国家区号
<PhoneNum></PhoneNum>电话号码
<Address1></Address1>地址第1行
<Address2></Address2>第2行地址
<City></City>城市
<State></State>
<ZipCode></ZipCode>邮政区代码
<Country></Country>国家
<CustomerSince></CustomerSince>客户身份始于
<AccountLock></AccountLock>账户锁定
<TotalSpending></TotalSpending>花费总计
<PriceLevel></PriceLevel>价格级别
<AccountBalance></AccountBalance>账户余额
<CustomTimeZone></CustomTimeZone>自定义时区
<DefaultSettings></DefaultSettings>默认设置
<DefaultWhois></DefaultWhois>默认Whois
<DefaultRegistrant></DefaultRegistrant>默认注册人
<ContactId></ContactId>联络人ID
<DefaultAdmin></DefaultAdmin>默认管理员
<DefaultTechnical></DefaultTechnical>默认技术类型
<DefaultBilling></DefaultBilling>默认账单
<Type></Type>域名服务器类型
<WithAds></WithAds>是否带有广告

账户信息示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=account_info

响应
<AccountInfoResponse>
  <AccountInfoHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </AccountInfoHeader>
  <AccountInfoContent>
    <AccountInfo>
      <Username>slater</Username>
      <ForumName>slaterinforum</ForumName>
      <Contact>
        <Organization></Organization>
        <Name>Jack Slater</Name>
        <Email>bishop@dynadot.local</Email>
        <PhoneCc>1</PhoneCc>
        <PhoneNum>555.555.5233</PhoneNum>
        <Address1>1 Free Way</Address1>
        <Address2></Address2>
        <City>Los Angeles</City>
        <State>CA</State>
        <ZipCode>90068</ZipCode>
        <Country>US</Country>
      </Contact>
      <CustomerSince>1364888735253</CustomerSince>
      <AccountLock>on</AccountLock>
      <TotalSpending>$0.00</TotalSpending>
      <PriceLevel>Regular Pricing</PriceLevel>
      <AccountBalance>$70.02</AccountBalance>
      <CustomTimeZone>PST</CustomTimeZone>
      <DefaultSettings>
        <DefaultWhois>
          <DefaultRegistrant>
            <ContactId>0</ContactId>
          </DefaultRegistrant>
          <DefaultAdmin>
            <ContactId>0</ContactId>
          </DefaultAdmin>
          <DefaultTechnical>
            <ContactId>0</ContactId>
          </DefaultTechnical>
          <DefaultBilling>
            <ContactId>0</ContactId>
          </DefaultBilling>
        </DefaultWhois>
        <DefaultNameServerSettings>
          <Type>Dynadot Parking</Type>
          <WithAds>yes</WithAds>
        </DefaultNameServerSettings>
      </DefaultSettings>
    </AccountInfo>
  </AccountInfoContent>
</AccountInfoResponse>
 

设置默认Whois

如果呼叫设置默认Whois命令,则应包含以下参数:

设置默认Whois请求参数
解释
registrant_contact域名的注册人信息
admin_contact域名管理员信息
technical_contact域名的技术信息
billing_contact域名的计费信息
XML结果标签
解释
<SetDefaultWhoisResponse></SetDefaultWhoisResponse>响应XML文档的根节点
<SetDefaultWhoisHeader></SetDefaultWhoisHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置默认Whois示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_default_whois&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0

响应

<SetDefaultWhoisResponse><SetDefaultWhoisHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetDefaultWhoisHeader></SetDefaultWhoisResponse>

 

设置默认域名服务器命令

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

设置默认域名服务器请求参数
解释
ns0 - ns12您要设置的域名服务器
XML结果标签
解释
<SetDefaultNsResponse></SetDefaultNsResponse>设置默认域名服务器响应标签,它是XML文档响应的根节点
<SetDefaultNsHeader></SetDefaultNsHeader>设置默认域名服务器标题标签
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用
<SetDefaultNsContent></SetDefaultNsContent>设置默认域名服务器内容标签,仅当状态为"success"时使用
<Servers></Servers>已设置的服务器信息
<Server></Server>每个服务器
<ServerName></ServerName>服务器名称
<ServerId></ServerId>服务器id

设置默认域名服务器示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_default_ns&ns0=ns1.hosts.com&ns1=ns2.host.com

响应

<SetDefaultNsResponse><SetDefaultNsHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetDefaultNsHeader><SetDefaultNsContent><Servers><Server><Servername>ns1.hosts.com</Servername><ServerId>1</ServerId></Server><Server><Servername>ns2.hosts.com</Servername><ServerId>2</ServerId></Server></Servers></SetDefaultNsContent></SetDefaultNsResponse>

 

设置默认停放命令

如果发送设置默认停放命令,则须包含下列参数:

设置默认停放请求参数
解释
with_ads (可选)如果您不想要第三方广告,则可将此参数设置为"no",,默认值为"yes"
XML结果标签
解释
<SetDefaultParkingResponse></SetDefaultParkingResponse>响应XML文档的根节点
<SetDefaultParkingHeader></SetDefaultParkingHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置默认停放示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_default_parking&folder_id=0&with_ads=no

响应

<SetDefaultParkingResponse><SetDefaultParkingHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetDefaultParkingHeader></SetDefaultParkingResponse>

 

设置默认转发命令

如果发送设置默认转发命令,则须包含下列参数:

设置默认转发请求参数
解释
forward_url您希望域名跳转至的URL
is_temp (可选)您要跳转域名的跳转状态,默认值为"temporary",,若您要永久跳转,则可将此参数设为"no"
XML结果标签
解释
<SetDefaultForwardingResponse></SetDefaultForwardingResponse>响应XML文档的根节点
<SetDefaultForwardingHeader></SetDefaultForwardingHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置默认转发示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_default_forwarding&forward_url=http://mydomain.com

响应

<SetDefaultForwardingResponse><SetDefaultForwardingHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetDefaultForwardingHeader></SetDefaultForwardingResponse>

 

设置默认隐身命令

如果要发送默认隐身命令,则须包含下列参数:

设置默认隐身请求参数
解释
stealth_url您希望域名跳转至的URL
stealth_title (可选)页面标题
XML结果标签
解释
<SetDefaultStealthResponse></SetDefaultStealthResponse>响应XML文档的根节点
<SetDefaultStealthHeader></SetDefaultStealthHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置默认隐身示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_default_stealth&stealth_title=obama's shop&stealth_url=http://www.obamashop.com

响应

<SetDefaultStealthResponse><SetDefaultStealthHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetDefaultStealthHeader></SetDefaultStealthResponse>

 

设置默认托管命令

如果发送设置默认托管命令,则须包含下列参数:

设置默认托管请求参数
解释
hosting_type您想要的默认托管类型,可以选择"advanced"和"basic"
XML结果标签
解释
<SetDefaultHostingResponse></SetDefaultHostingResponse>响应XML文档的根节点
<SetDefaultHostingHeader></SetDefaultHostingHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置默认托管示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_default_hosting&hosting_type=advanced

响应

<SetDefaultHostingResponse><SetDefaultHostingHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetDefaultHostingHeader></SetDefaultHostingResponse>

 

设置默认域名系统命令

如果发送设置默认域名系统命令,则须包含下列参数:

(该命令已过时,不建议使用,请使用Set Default DNS2命令)

设置默认域名系统请求参数
解释
main_record_type主要记录类型
main_record为您的域名制定一个域名系统记录
main_txt (可选)为您的域名指定TXT记录;若your main_record_type为aaaa,且指定了一个main_record2,则您可设置多达3个main_txts,否则,您可设置多达4个main_txts
main_record2主记录2,仅当"main_record_type"为"aaaa"时使用,其值必须为IPV4格式
subdomain0 - subdomain20 (可选)子域名记录
sub_record_type0 - sub_record_type20 (可选)子域名记录类型
sub_record0 - sub_record20 (可选)IP地址或目标主机
mx_host0 - mx_host2 (可选)指定您域名的邮箱主机,distance0为最高优先级
mx_distance0 - mx_distance2 (可选)Distance0为最高优先级
ttl (可选)生存时间
XML结果标签
解释
<SetDefaultDnsResponse></SetDefaultDnsResponse>响应XML文档的根节点
<SetDefaultDnsHeader></SetDefaultDnsHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置默认域名系统示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_default_dns&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1

响应

<SetDefaultDnsResponse><SetDefaultDnsHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetDefaultDnsHeader></SetDefaultDnsResponse>

 

设置默认DNS2命令

如果发送设置默认域名系统命令,则须包含下列参数:

设置默认DNS2请求参数
解释
main_record_type0 - main_record_type19主要记录类型
main_record0 - main_record19为您的域名指定DNS记录
main_recordx0 - main_recordx19Mx距离、转发类型、隐形转发标题或电子邮件别名当main_record_type为"a"、"aaaa"、"cname"、"forward"、"txt"、"mx"、"stealth"、"email"时必须提供
subdomain0 - subdomain49 (可选)子域名记录
sub_record_type0 - sub_record_type49 (可选)子域名记录类型
sub_record0 - sub_record49 (可选)子域名IP地址或目标主机
sub_recordx0 - subdo_recordx49Mx距离、转发类型、隐形转发标题或电子邮件别名当sub_record_type为"a"、"aaaa"、"cname"、"forward"、"txt"、"srv"、"mx"、"stealth"、"email"时必须提供
ttl (可选)生存时间
XML结果标签
解释
<SetDefaultDnsResponse></SetDefaultDnsResponse>响应XML文档的根节点
<SetDefaultDnsHeader></SetDefaultDnsHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置默认DNS2示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_default_dns2&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1

响应

<SetDefaultDnsResponse><SetDefaultDnsHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetDefaultDnsHeader></SetDefaultDnsResponse>

 

设置默认免费托管命令

如果发送设置默认免费托管命令,则须包含以下参数:

设置免费托管请求参数
解释
style (可选)免费页面风格
title免费页面标题
body页面主要部分,可以使用HTML,但不应包含下列标签:<html>,<title>, <body>, <meta>, <script>;,请注意,输入主体的任何HTML均未验证
XML结果标签
解释
<SetDefaultFreeHostResponse></SetDefaultFreeHostResponse>设置默认免费主机响应标签,它是响应XML文档的根节点
<SetDefaultFreeHostHeader></SetDefaultFreeHostHeader>设置默认免费托管标题
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置默认免费托管示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_default_free_hosting&title=Obama's shop&body=<div>this is obama's shop</div>

响应

<SetDefaultFreeHostResponse><SetDefaultFreeHostHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetDefaultFreeHostHeader></SetDefaultFreeHostResponse>

 

设置默认电子邮件转发命令

如果发送设置默认电子邮件转发命令,则须包含下列参数:

设置默认电子邮件转发请求参数
解释
forward_type转发类型,可以是"donot"::不要转发邮件;"mx":将邮件转发给另一个邮箱主机(MX记录);"forward"::将邮件转发给另一个邮箱主机
username0 - username9用户名,仅"forward_type"为"forward"时使用
exist_email0 - exist_email9现有电子邮箱地址,仅当"forward_type"为"forward"时使用
mx_host0 - mx_host2邮箱主机,仅"forward_type"为"mx"时使用
mx_distance0 - mx_distance2Distance0为最高优先级,仅当"forward_type"为"mx"时使用
XML结果标签
解释
<SetDefaultEmailForwardingResponse></SetDefaultEmailForwardingResponse>响应XML文档的根节点
<SetDefaultEmailForwardingHeader></SetDefaultEmailForwardingHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置默认电子邮件转发示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_default_email_forward&forward_type=forward&username0=peter&exist_email0=peter@dynadot.com

响应

<SetDefaultEmailForwardingResponse><SetDefaultEmailForwardingHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetDefaultEmailForwardingHeader></SetDefaultEmailForwardingResponse>

 

设置清除默认设置命令

如果呼叫设置清除默认设置命令,则需包含以下参数:

设置清除默认设置请求参数
解释
service您要清除的服务,可以是 "forward", "stealth", "email_forwarding", "free_hosting", "dns", 以及 "nameservers"
XML结果标签
解释
<SetClearDefaultSettingResponse></SetClearDefaultSettingResponse>响应XML文档的根节点
<SetClearDefaultSettingHeader></SetClearDefaultSettingHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置清除默认设置示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_clear_default_setting&service=nameservers

响应

<SetClearDefaultSettingResponse><SetClearDefaultSettingHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetClearDefaultSettingHeader></SetClearDefaultSettingResponse>

 

设置默认续费选项命令

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

设置默认续费选项请求参数
解释
renew_option可以是"donot", "auto", "reset"
XML结果标签
解释
<SetDefaultRenewOptionResponse></SetDefaultRenewOptionResponse>响应XML文档的根节点
<SetDefaultRenewOptionHeader></SetDefaultRenewOptionHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置默认续费选项示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_default_renew_option&renew_option=auto

响应

<SetDefaultRenewOptionResponse><SetDefaultRenewOptionHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetDefaultRenewOptionHeader></SetDefaultRenewOptionResponse>

 

创建文件夹命令

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

创建文件夹请求参数
解释
folder_name您想创建的文件夹名称
XML结果标签
解释
<FolderCreateResponse></FolderCreateResponse>响应XML文档的根节点
<FolderCreateHeader></FolderCreateHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用
<FolderCreateContent></FolderCreateContent>响应内容
<FolderName></FolderName>文件夹名称
<FolderId></FolderId>新文件夹ID

创建文件夹示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=create_folder&folder_name=new

响应

<FolderCreateResponse><FolderCreateHeader><SuccessCode>0</SuccessCode><Status>success</Status></FolderCreateHeader><FolderCreateContent><FolderName>new</FolderName><FolderId>2</FolderId></FolderCreateContent></FolderCreateResponse>

 

删除文件夹命令

如果设置Whois命令,则应包含以下参数:

删除文件夹请求参数
解释
folder_id您要删除的文件夹ID,确保用逗号分隔
XML结果标签
解释
<DeleteFolderResponse></DeleteFolderResponse>响应XML文档的根节点
<DeleteFolderHeader></DeleteFolderHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

删除文件夹例子

请求

https://api.dynadot.com/api3.xml?key=mykey&command=delete_folder&folder_id=0,1

响应

<DeleteFolderRespofoldere><DeleteFolderHeader><SuccessCode>0</SuccessCode><Status>success</Status></DeleteFolderHeader></DeleteFolderRespofoldere>

 

设置文件夹Whois命令

如果呼叫设置文件夹Whois命令,则应包含下列参数:

设置文件夹Whois请求参数
解释
folder_id您要设置的文件夹ID
registrant_contact域名的注册人信息
admin_contact域名管理员信息
technical_contact域名的技术信息
billing_contact域名的计费信息
enable (可选)如果您要将此Whois设置应用于今后移动至此文件夹的域名,则可将此参数设为"yes"
sync (可选)如果您要将此Whois设置同步于此文件夹下的所有域名,则应将此参数设为"yes"
XML结果标签
解释
<SetFolderWhoisResponse></SetFolderWhoisResponse>响应XML文档的根节点
<SetFolderWhoisHeader></SetFolderWhoisHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置Whois文件夹示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_whois&folder_id=0&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0

响应

<SetFolderWhoisResponse><SetFolderWhoisHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetFolderWhoisHeader></SetFolderWhoisResponse>

 

设置文件夹名称服务器命令

如果呼叫设置文件夹名称服务器命令,则应包含下列参数:

设置文件夹名称服务器请求参数
解释
fold_id您要设置的文件夹ID,每个请求可设置1个文件夹
ns0 - ns12您要设置并启用域名的域名服务器,您可指定多达13个域名服务器,但它们必须已经在您的账户中
enable (可选)如果您要将此域名服务器设置应用于今后移动至该文件夹的域名,则可将此参数设为"yes"
sync (可选)若要同步该文件夹下所有域名的域名服务器设置,则可将此参数设为"yes"
XML结果标签
解释
<SetFolderNsResponse></SetFolderNsResponse>设置域名服务器响应标签,它是响应XML文档的根节点
<SetFolderNsHeader></SetFolderNsHeader>设置文件夹名称服务器响应标题标签
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用
<SetFolderNsContent></SetFolderNsContent>设置文件夹名称服务器响应内容标签,仅当状态为"success"时使用
<Servers></Servers>已设置的服务器信息
<Server></Server>每个服务器
<ServerName></ServerName>服务器名称
<ServerId></ServerId>服务器ID

设置文件夹名称服务器示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_ns&folder_id=0&ns0=ns1.hosts.com&ns1=ns2.host.com&enable=yes&sync=yes

响应

<SetFolderNsResponse><SetFolderNsHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetFolderNsHeader><SetFolderNsContent><Servers><Server><ServerName>ns1.hosts.com</ServerName><ServerId>0</ServerId></Server><Server><ServerName>ns2.host.com</ServerName><ServerId>1</ServerId></Server><Server><ServerName></ServerName><ServerId></ServerId></Server><Server><ServerName></ServerName><ServerId></ServerId></Server><Server><ServerName></ServerName><ServerId></ServerId></Server><Server><ServerName></ServerName><ServerId></ServerId></Server><Server><ServerName></ServerName><ServerId></ServerId></Server><Server><ServerName></ServerName><ServerId></ServerId></Server><Server><ServerName></ServerName><ServerId></ServerId></Server><Server><ServerName></ServerName><ServerId></ServerId></Server><Server><ServerName></ServerName><ServerId></ServerId></Server><Server><ServerName></ServerName><ServerId></ServerId></Server><Server><ServerName></ServerName><ServerId></ServerId></Server></Servers></SetFolderNsContent></SetFolderNsResponse>

 

设置文件夹停放命令

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

设置文件夹停放请求参数
解释
folder_id您要设置的文件夹ID,每个请求可设置1个文件夹
with_ads (可选)如果您不想要第三方广告,则可将此参数设置为"no",,默认值为"yes"
enable (可选)如果您想为未来移动至此文件夹的域名应用此停放设置,则可将此参数设为"yes"
sync (可选)如果您想将此文件夹内所有域名的停放设置同步,则可将此参数设为"yes"
XML结果标签
解释
<SetFolderParkingResponse></SetFolderParkingResponse>响应XML文档的根节点
<SetFolderParkingHeader></SetFolderParkingHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置文件夹停放示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_parking&folder_id=0&with_ads=no

响应

<SetFolderParkingResponse><SetFolderParkingHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetFolderParkingHeader></SetFolderParkingResponse>

 

设置文件夹转发命令

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

设置文件夹转发请求参数
解释
folder_id您要设置的文件夹ID
forward_url您希望域名跳转至的URL
is_temp (可选)您要跳转域名的跳转状态,默认值为"temporary",,若您要永久跳转,则可将此参数设为"no"
enable (可选)如果您要将此跳转设置应用于今后移动至该文件夹的域名,则可将此参数设为"yes"
sync (可选)如果您要为此文件夹内所有域名同步跳转设置,则可将此参数设为"yes"
XML结果标签
解释
<SetFolderForwardingResponse></SetFolderForwardingResponse>响应XML文档的根节点
<SetFolderForwardingHeader></SetFolderForwardingHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置文件夹转发示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_forwarding&folder_id=0&forward_url=http://mydomain.com&sync=yes

响应

<SetFolderForwardingResponse><SetFolderForwardingHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetFolderForwardingHeader></SetFolderForwardingResponse>

 

设置文件夹隐身命令

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

设置文件夹隐身请求参数
解释
folder_id您要设置的文件夹ID
stealth_url您希望域名跳转至的URL
stealth_title (可选)页面标题
enable (可选)如果您要将此隐身设置应用于今后移动至该文件夹的域名,则可将此参数设为"yes"
sync (可选)如果您要将此隐身设置同步于今后移动至该文件夹的所有域名,则可将此参数设为"yes"
XML结果标签
解释
<SetFolderStealthResponse></SetFolderStealthResponse>响应XML文档的根节点
<SetFolderStealthHeader></SetFolderStealthHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置文件夹隐身示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_stealth&folder_id=0&stealth_title=obama's shop&stealth_url=http://www.obamashop.com&sync=yes

响应

<SetFolderStealthResponse><SetFolderStealthHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetFolderStealthHeader></SetFolderStealthResponse>

 

设置文件夹托管命令

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

设置文件夹托管请求参数
解释
folder_id您要设置的文件夹ID
hosting_type您想要的托管类型,可选择"advanced"和"basic"
enable (可选)如果您要将此托管设置应用于今后移动至该文件夹的域名,则可将此参数设为"yes"
even (可选)如果您想为在此文件夹下所有的域名同步托管设置,则可将次参数设为"yes"
XML结果标签
解释
<SetFolderHostingResponse></SetFolderHostingResponse>响应XML文档的根节点
<SetFolderHostingHeader></SetFolderHostingHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置文件夹托管示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_hosting&folder_id=0&hosting_type=advanced&sync=yes

响应

<SetFolderHostingResponse><SetFolderHostingHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetFolderHostingHeader></SetFolderHostingResponse>

 

设置文件夹域名系统命令

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

(该命令已过时,不建议使用。请使用Set Folder DNS2命令)

设置文件夹DNS请求参数
解释
folder_id您要设置的文件夹ID
main_record_type主要记录类型
main_record为您的域名制定一个域名系统记录
main_record为您的域名制定一个域名系统记录
with_ads (可选)为您的域名指定TXT记录;若your main_record_type为aaaa,且指定了一个main_record2,则您可设置多达3个main_txts,否则,您可设置多达4个main_txts
main_record2主记录2,仅当"main_record_type"为"aaaa"时使用,其值必须为IPV4格式
subdomain0 - subdomain20 (可选)Subdomain records (可选)
sub_record_type0 - sub_record_type20 (可选)子域名记录类型
sub_record0 - sub_record20 (可选)IP地址或目标主机
mx_host0 - mx_host2 (可选)指定您域名的邮箱主机,distance0为最高优先级
mx_distance0 - mx_distance2 (可选)Distance0为最高优先级
ttl (可选)生存时间
enable (可选)如果您要将此DNS设置应用于今后您移动至此文件夹的域名,则可将此参数设为"yes"
sync (可选)如果您要将此DNS服务器设置同步于此文件夹中的所有域名,则可将此参数设为"yes"
XML结果标签
解释
<SetFolderDnsResponse></SetFolderDnsResponse>响应XML文档的根节点
<SetFolderDnsHeader></SetFolderDnsHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置文件夹域名系统示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_dns&folder_id=0&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1

响应

<SetDnsResponse><SetDnsHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetDnsHeader></SetDnsResponse>

 

设置文件夹DNS2命令

如果调用设置文件夹DNS2命令,应包含以下参数:

设置文件夹DNS2请求参数
解释
folder_id您要设置的文件夹ID
main_record_type0 - main_record_type19主记录类型应为"a"、"aaaa"、"cname"、"forward"、"txt"、"mx"、"stealth"、"email"
main_record0 - main_record19为您的域名指定DNS记录
main_recordx0 - main_recordx19Mx距离、转发类型、隐形转发标题或电子邮件别名当sub_record_type为"forward"、"mx"、"stealth"、"email"时必须提供
subdomain0 - subdomain49 (可选)Subdomain records (可选)
sub_record_type0 - sub_record_type49 (可选)子域名记录类型应为"a"、"aaaa"、"cname"、"forward"、"txt"、"srv"、"mx"、"stealth"、"email"
sub_record0 - sub_record49 (可选)IP地址或目标主机
sub_recordx0 - sub_recordx49 (可选)Mx距离、转发类型、隐形转发标题或电子邮件别名当sub_record_type为"forward"、"mx"、"stealth"、"email"时必须提供
ttl (可选)生存时间
enable (可选)如果您要将此DNS设置应用于今后您移动至此文件夹的域名,则可将此参数设为"yes"
sync (可选)如果您要将此DNS服务器设置同步于此文件夹中的所有域名,则可将此参数设为"yes"
XML结果标签
解释
<SetFolderDnsResponse></SetFolderDnsResponse>响应XML文档的根节点
<SetFolderDnsHeader></SetFolderDnsHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置文件夹DNS2示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_dns2&folder_id=0&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1

响应

<SetDnsResponse><SetDnsHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetDnsHeader></SetDnsResponse>

 

设置文件夹免费托管

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

设置文件夹免费托管请求参数
解释
folder_id您要设置的文件夹ID
enable (可选)如果您要将此免费托管设置应用于今后移动至该文件夹的域名,则可将此参数设为"yes"
sync (可选)如果您要将此免费托管设置同步于此文件夹中的所有域名,则可将此参数设为"yes"
style (可选)免费页面风格
title免费页面标题
body页面主要部分,可以使用HTML,但不应包含下列标签:<html>,<title>, <body>, <meta>, <script>;,请注意,输入主体的任何HTML均未验证
XML结果标签
解释
<SetFolderFreeHostingResponse></SetFolderFreeHostingResponse>设置文件夹免费托管响应标签,它是XML文档响应的根节点
<SetFolderFreeHostingHeader></SetFolderFreeHostingHeader>设置文件夹免费托管文件夹标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置文件夹免费主机示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_free_hosting&folder_id=0&title=obama's shop&body=Welcome to obama's shop&enable=yes&sync=yes

响应

<SetFolderFreeHostResponse><SetFolderFreeHostHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetFolderFreeHostHeader></SetFolderFreeHostResponse>

 

设置文件夹电子邮件转发命令

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

设置文件夹电子邮件转发请求参数
解释
domain您要设置的域名,每个请求仅可设置100个域名,请务必用逗号将其隔开
folder_id您想设置的文件夹ID
forward_type转发类型,可以是"donot"::不要转发邮件;"mx":将邮件转发给另一个邮箱主机(MX记录);"forward"::将邮件转发给另一个邮箱主机
username0 - username9用户名,仅"forward_type"为"forward"时使用
exist_email0 - exist_email9现有电子邮箱地址,仅当"forward_type"为"forward"时使用
mx_host0 - mx_host2邮箱主机,仅"forward_type"为"mx"时使用
mx_distance0 - mx_distance2Distance0为最高优先级,仅当"forward_type"为"mx"时使用
enable (可选)如果您要将此设置应用于今后移动至该文件夹的域名,则可将此参数设为"yes"
sync (可选)如果您要将此设置同步于此文件夹中的所有域名,则可将此参数设为"yes"
XML结果标签
解释
<SetFolderEmailForwardingResponse></SetFolderEmailForwardingResponse>响应XML文档的根节点
<SetFolderEmailForwardingHeader></SetFolderEmailForwardingHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置文件夹电子邮件转发示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_email_forward&folder_id=0&forward_type=forward&username0=peter&exist_email0=peter@dynadot.com

响应

<SetFolderEmailForwardingResponse><SetFolderEmailForwardingHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetFolderEmailForwardingHeader></SetFolderEmailForwardingResponse>

 

设置清除文件夹设置命令

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

设置清除文件夹设置请求参数
解释
folder_id您要设置的文件夹ID
service您要清除的服务,可以是 "forward", "stealth", "email_forwarding", "free_hosting", "dns", 以及 "nameservers"
XML结果标签
解释
<SetClearFolderSettingResponse></SetClearFolderSettingResponse>响应XML文档的根节点
<SetClearFolderSettingHeader></SetClearFolderSettingHeaderr>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置清除文件夹设置示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_clear_folder_setting&folder_id=0&service=nameservers

响应

<SetClearFolderSettingResponse><SetClearFolderSettingHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetClearFolderSettingHeader></SetClearFolderSettingResponse>

 

设置文件夹名称命令

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

设置文件夹名称请求参数
解释
folder_id您要设置文件夹的ID
folder_name新文件夹名称
XML结果标签
解释
<SetFolderNameResponse></SetFolderNameResponse>响应XML文档的根节点
<SetFolderNameHeader></SetFolderNameHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

设置文件夹名称示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_name&folder_id=0&folder_name=new

响应

<SetFolderNameResponse><SetFolderNameHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetFolderNameHeader></SetFolderNameResponse>

 

设置文件夹续费选项命令

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

设置文件夹续费选项请求参数
解释
folder_id您要设置的文件夹ID,每个请求可设置1个文件夹
renew_option您要为文件夹设置的续费选项;可以是 "donot","auto" 或 "reset"
enable (可选)如果您要将此续费设置应用于今后您移动至此文件夹的域名,则可将此参数设为"yes"
sync (可选)如果您要将此续费设置同步于该文件夹中的所有域名,则可将此参数设为"yes"
XML结果标签
解释
<Response></Response>响应XML文档的根节点
<ResponseHeader></ResponseHeader>响应标头
<ResponseCode></ResponseCode>响应码,"0"为成功,"-1"为失败
<Error></Error>错误信息,仅当响应码为"-1"时使用

设置文件夹续费选项示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_renew_option&folder_id=0

响应

<Response><ResponseHeader><ResponseCode>0</ResponseCode></ResponseHeader></Response>

 

文件夹列表命令

该命令尽在XML格式下可用:

文件夹列表请求参数
解释
N/A无需额外参数
<FolderListResponse></FolderListResponse>响应XML文档的根节点
<FolderListHeader></FolderListHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用
<FolderListContent></FolderListContent>响应内容
<FolderList></FolderList>文件夹列表
<List></List>
<Folder></Folder>
<FolderId></FolderId>文件夹ID
<FolderName></FolderName>文件夹名称
<DefaultWhois></DefaultWhois>默认Whois
<DefaultWhoisEnableStatus></DefaultWhoisEnableStatus>默认Whois启用状态
<DefaultRegistrant></DefaultRegistrant>默认注册人
<ContactId></ContactId>联络人ID
<DefaultAdmin></DefaultAdmin>默认管理员
<DefaultTechnical></DefaultTechnical>默认技术信息
<DefaultBilling></DefaultBilling>默认账单信息
<DefaultNameServerEnableStatus></DefaultNameServerEnableStatus>默认域名服务器启用状态
<NameServerSettings></NameServerSettings>域名服务器设置
<Type></Type>域名服务器类型
<WithAds></WithAds>是否带有广告
<DefaultRenewOption></DefaultRenewOption>默认续费选项
<DefaultRenewOptionEnableStatus></DefaultRenewOptionEnableStatus>默认续费启用状态
<RenewOption></RenewOption>续费选项
<DefaultTransferLock></DefaultTransferLock>默认转移锁定
<DefaultTransferLockEnableStatus></DefaultTransferLockEnableStatus>默认转移锁定启用状态
<LockStatus></LockStatus>锁定状态

文件夹列表示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=folder_list

响应
<FolderListResponse>
  <FolderListHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </FolderListHeader>
  <FolderListContent>
    <FolderList>
      <List>
        <Folder>
          <FolderId>0</FolderId>
          <FolderName>new</FolderName>
          <DefaultWhois>
            <DefaultWhoisEnableStatus>disable</DefaultWhoisEnableStatus>
            <DefaultRegistrant>
              <ContactId>0</ContactId>
            </DefaultRegistrant>
            <DefaultAdmin>
              <ContactId>0</ContactId>
            </DefaultAdmin>
            <DefaultTechnical>
              <ContactId>0</ContactId>
            </DefaultTechnical>
            <DefaultBilling>
              <ContactId>0</ContactId>
            </DefaultBilling>
          </DefaultWhois>
          <DefaultNameServers>
            <DefaultNameServerEnableStatus>disable</DefaultNameServerEnableStatus>
            <NameServerSettings>
              <Type>Dynadot Parking</Type>
              <WithAds>yes</WithAds>
            </NameServerSettings>
          </DefaultNameServers>
          <DefaultRenewOption>
            <DefaultRenewOptionEnableStatus>disable</DefaultRenewOptionEnableStatus>
            <RenewOption>no renew option</RenewOption>
          </DefaultRenewOption>
          <DefaultTransferLock>
            <DefaultTransferLockEnableStatus>disable</DefaultTransferLockEnableStatus>
            <LockStatus>locked</LockStatus>
          </DefaultTransferLock>
        </Folder>
      </List>
    </FolderList>
  </FolderListContent>
</FolderListResponse>
 

添加域名抢购请求命令

如添加域名抢购请求命令,则须包括下列参数:

添加域名抢购请求请求参数
解释
domain若Dynadot成功接取,您愿意添加并付款的一个或多个域名,每条请求可添加100个域名,请用逗号隔开
XML结果标签
解释
<AddBackorderRequestResponse></AddBackorderRequestResponse>响应XML文档的根节点
<AddBackorderRequestHeader></AddBackorderRequestHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

添加域名抢购请求示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=add_backorder_request&domain=droppingdomain.com,domaindropping.net,domaindrop.org

响应
<AddBackorderRequestResponse>
  <AddBackorderRequestHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </AddBackorderRequestHeader>
</AddBackorderRequestResponse>
 

删除域名抢购请求命令

如设置删除域名抢购请求命令,则需包含下列参数:

删除域名抢购请求请求参数
解释
domain您要从过期域名抢注请求清单中移除的(一个或多个域名),每个请求可移除100个域名,域名之间应使用逗号隔开
XML结果标签
解释
<DeleteBackorderRequestResponse></DeleteBackorderRequestResponse>响应XML文档的根节点
<DeleteBackorderRequestHeader></DeleteBackorderRequestHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

删除域名抢购请求示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=delete_backorder_request&domain=domaindropp.com

响应
<DeleteBackorderRequestResponse>
  <DeleteBackorderRequestHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </DeleteBackorderRequestHeader>
</DeleteBackorderRequestResponse>
 

域名抢购请求列表命令

呼叫域名过期抢注请求清单命令将返回一个指定账户域名过期抢注请求清单;如果呼叫该命令,则需包含以下参数:

域名抢购请求列表请求参数
解释
startDate您要请求拍卖的过期抢注起始日期,如yyyy-mm-dd,如2015-05-05
endDate您要请求拍卖的过期抢注截止日期,yyyy-mm-dd,如2015-05-05
XML结果标签
解释
<BackorderRequestListResponse></BackorderRequestListResponse>响应XML文档的根节点
<BackorderRequestListHeader></BackorderRequestListHeader>响应标头
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用
<BackorderRequestListContent></BackorderRequestListContent>响应内容
<BackorderRequestList></BackorderRequestList>域名抢购请求列表
<BackorderRequest></BackorderRequest>域名抢购请求
<Domain></Domain>您列表上的域名
<CutoffTime></CutoffTime>以Unix时间计的删除请求交割日期(毫秒,自UTC1970年1月1日午夜起)
<BackorderRequestStatus></BackorderRequestStatus>过期抢购进程状态

域名抢购请求列表示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=backorder_request_list&month=1&day=31&year=2014

响应
<BackorderRequestListResponse>
  <BackorderRequestListHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </BackorderRequestListHeader>
  <BackorderRequestListContent>
    <BackorderRequestList>
      <BackorderRequest>
        <DomainName>testdrop.com</DomainName>
        <CutoffTime>1403914140000</CutoffTime>
        <BackorderRequestStatus>Active</BackorderRequestStatus>
      </BackorderRequest>
      <BackorderRequest>
        <DomainName>testdrop3.com</DomainName>
        <CutoffTime>1403914140000</CutoffTime>
        <BackorderRequestStatus>Active</BackorderRequestStatus>
      </BackorderRequest>
      <BackorderRequest>
        <DomainName>testdrop4.com</DomainName>
        <CutoffTime>1403914140000</CutoffTime>
        <BackorderRequestStatus>Active</BackorderRequestStatus>
      </BackorderRequest>
      <BackorderRequest>
        <DomainName>testdrop5.com</DomainName>
        <CutoffTime>1403914140000</CutoffTime>
        <BackorderRequestStatus>Active</BackorderRequestStatus>
      </BackorderRequest>
    </BackorderRequestList>
  </BackorderRequestListContent>
</BackorderRequestListResponse>
请求(csv格式)

http://api.dynadot.com/api3.html?key=1&command=backorder_request_list&startDate=2015-01-01&endDate=2015-5-20

响应

ok,
success,
Domain,CutoffTime,BackorderRequestStatus
domain.com,1431661200000,Active
domain2.com,1431661200000,Success
domain3.com,1431661200000,Success
.
.
.

 

获取公开拍卖命令

呼叫获取公开拍卖命令将返回一个正在处理中的拍卖的清单;如果呼叫此命令,则应包含以下参数:

获取公开拍卖请求参数
解释
currency (可选)返回货币结果,应为"usd", "eur", 或 "cny",,默认货币为美元
XML结果标签
解释
<GetOpenAuctionsResponse></GetOpenAuctionsResponse>获取公开拍卖响应标签,它是响应XML文档的根节点
<GetOpenAuctionsHeader></GetOpenAuctionsHeader>获取公开拍卖标题
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用
<GetOpenAuctionsContent></GetOpenAuctionsContent>公开拍卖内容标签,仅当状态为"success"时使用
<Auction></Auction>拍卖项目标签,仅状态为"success"时使用
<AuctionId></AuctionId>拍卖ID
<Domain></Domain>拍卖的域名
<BidPrice></BidPrice>拍卖目前竞标价格
<BidPriceCurrency></BidPriceCurrency>竞拍价格货币
<Bids></Bids>竞拍出价次数
<EndTime></EndTime>拍卖结束时间
<EndTimestamp></EndTimestamp>拍卖终止日期,以Unix时间计(毫秒,自UTC1970年一月1日午夜起)
<Revenue></Revenue>拍卖收入
<RevenueCurrency></RevenueCurrency>收入货币
<Visitors></Visitors>域名访客
<Links></Links>到达域名链接
<Age></Age>域名年龄

获取公开拍卖示例

请求(XML格式)

https://api.dynadot.com/api3.xml?key=mykey&command=get_open_auctions&currency=usd

响应
<GetOpenAuctionsResponse>
  <GetOpenAuctionsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetOpenAuctionsHeader>
  <GetOpenAuctionsContent>
    <Auction>
           <AuctionId>0</AuctionId>
            <Domain>domain.com</Domain>
            <BidPrice>63.99</BidPrice>
            <BidPriceCurrency>USD</BidPriceCurrency>
            <Bids>0</Bids>
            <EndTime>2015/04/28 05:46 UTC</EndTime>
            <EndTimestamp>1430199960354</EndTimestamp>
            <Revenue>72</Revenue>
            <RevenueCurrency>USD</RevenueCurrency>
            <Visitors>-1</Visitors>
            <Links>-1</Links>
            <Age>1</Age>
    </Auction>
    <Auction>
           <AuctionId>0</AuctionId>
            <Domain>domain.com</Domain>
            <BidPrice>63.99</BidPrice>
            <BidPriceCurrency>USD</BidPriceCurrency>
            <Bids>0</Bids>
            <EndTime>2015/04/28 05:46 UTC</EndTime>
            <EndTimestamp>1430199960354</EndTimestamp>
            <Revenue>72</Revenue>
            <RevenueCurrency>USD</RevenueCurrency>
            <Visitors>-1</Visitors>
            <Links>-1</Links>
            <Age>1</Age>
    </Auction>
    .
    .
    .
  </GetOpenAuctionsContent>
</GetOpenAuctionsResponse>
请求(csv格式)

https://api.dynadot.com/api3.html?key=mykey&command=get_open_auctions&currency=usd

响应

ok,
success,
AuctionId,Domain,BidPrice,BidPriceCurrency,Bids,EndTime,EndTimestamp,Revenue,RevenueCurrency,Visitors,Links,Age
10001,domain.com,92.99,USD,0,2015/04/28 18:04 UTC,1430244248274,0.64,USD,-1,-1,1
10002,xn--wkccg.com,77.99,USD,0,2015/05/01 06:04 UTC,1430460248338,86,USD,435,-1,1
10003,domain2.com,11.25,USD,0,2015/05/05 06:04 UTC,1430805846946,91,USD,358,-1,1
.
.
.

 

获取拍卖详情命令

呼叫获取拍卖详情命令将返回指定拍卖的详情;该命令仅有XML格式;若呼叫此命令,则应包含以下函数:

获取拍卖详情请求参数
解释
domain拍卖的域名、国际化域名应使用punycode,如“xn--wkccg.com”
currency (可选)返回货币结果,应为"usd", "eur", 或 "cny",,默认货币为美元
XML结果标签
解释
<GetAuctionDetailsResponse></GetAuctionDetailsResponse>获取拍卖详情响应标签,它是XML文档响应的根节点
<GetAuctionDetailsHeader></GetAuctionDetailsHeader>获取过期域名竞拍详情标题
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用
<GetAuctionDetailsContent></GetAuctionDetailsContent>获取拍卖细节内容标签,仅当状态为"success"时可用
<AuctionStatusId></AuctionStatusId>竞拍状态id,“0”表示进行种,“1”表示已由管理员关闭,“2”表示已超时关闭,“3”表示问题
<AuctionStatus></AuctionStatus>拍卖状态
<UserIsHighBid></UserIsHighBid>如果用户为出价最高者
<YourCurrentBid></YourCurrentBid>指定拍卖中您目前的竞拍出价;若尚未出价,则应为'-1'
<YourProxyBid></YourProxyBid>指定拍卖的代理竞拍;如果您尚未出价,应为'-1'
<AuctionId></AuctionId>拍卖ID
<Domain></Domain>拍卖的域名
<BidPrice></BidPrice>拍卖目前竞标价格
<BidPriceCurrency></BidPriceCurrency>竞拍价格货币
<Bids></Bids>竞拍出价次数
<EndTime></EndTime>拍卖结束时间
<EndTimestamp></EndTimestamp>拍卖终止日期,以Unix时间计(毫秒,自UTC1970年一月1日午夜起)

获取拍卖详情示例

请求

https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_auction_details&domain=domain0.com&currency=usd

响应
<GetAuctionDetailsResponse>
 <GetAuctionDetailsHeader>
   <SuccessCode>0</SuccessCode>
   <Status>success</Status>
 </GetAuctionDetailsHeader>
 <GetAuctionDetailsContent>
   <AuctionStatusId>0</AuctionStatusId>
   <AuctionStatus>In Progress</AuctionStatus>
   <UserIsHighBid>No</UserIsHighBid>
   <YourCurrentBid>-1</YourCurrentBid>
   <YourProxyBid>-1</YourProxyBid>
   <Auction>
     <AuctionId>0</AuctionId>
     <Domain>domain0.com</Domain>
     <BidPrice>6.35</BidPrice>
     <BidPriceCurrency>CNY</BidPriceCurrency>
     <Bids>0</Bids>
     <EndTime>2017/09/03 17:12 UTC</EndTime>
     <EndTimestamp>1504458737058</EndTimestamp>
   </Auction>
 </GetAuctionDetailsContent>
</GetAuctionDetailsResponse>
 

竞拍出价命令

呼叫出价竞标命令将会为指定拍卖出价;若呼叫此命令,则应包含以下参数:

竞拍出价请求参数
解释
domain拍卖的域名、国际化域名应使用punycode,如"xn--wkccg.com"
bid_amount您的竞拍出价,默认货币为美元,您也可以指定货币类型
currency (可选)您竞拍的货币,应为"usd", "eur", 或 "cny",,默认货币为美元
XML结果标签
解释
<PlaceAuctionBidResponse></PlaceAuctionBidResponse>竞拍出价响应标签,它是响应XML文档的根节点
<PlaceAuctionBidHeader></PlaceAuctionBidHeader>竞拍出价标题
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

域名例子

请求(XML格式)

https://api.dynadot.com/api3.xml?key=mykey&command=place_auction_bid&domain=example.com&bid_amount=99.9&currency=usd

响应
<PlaceAuctionBidResponse>
  <PlaceAuctionBidHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </PlaceAuctionBidHeader>
</PlaceAuctionBidResponse>
请求(csv格式)

https://api.dynadot.com/api3.html?key=mykey&command=place_auction_bid&domain=example.com&bid_amount=99.9&currency=usd

响应

ok,success

 

获取已关闭拍卖命令

调用获取已关闭竞拍命令将返回指定账户的已关闭竞拍列表。如果调用该命令,应包含以下参数:

获取已关闭拍卖请求参数
解释
startDate拍卖起始日期,yyyy-mm-dd,如2015-05-05
endDate拍卖结束日期,yyyy-mm-dd,如2015-05-05
currency (可选)您竞拍的货币,应为"usd", "eur", 或 "cny",,默认货币为美元
XML结果标签
解释
<GetClosedAuctionsResponse></GetClosedAuctionsResponse>获取已关闭拍卖响应标签,它是响应XML文档的根节点
<GetClosedAuctionsHeader></GetClosedAuctionsHeader>获取已关闭拍卖标题
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用
<GetClosedAuctionsContent></GetClosedAuctionsContent>获取已关闭拍卖内容标签,仅当状态为"success"时使用
<Auction></Auction>拍卖项目标签,仅状态为"success"时使用
<AuctionId></AuctionId>拍卖ID
<Domain></Domain>拍卖的域名
<AuctionStatusId></AuctionStatusId>拍卖状态ID,“0”为进行中,“1”为被用户关闭,“2”为被管理员关闭,“3”为因续费关闭,“4”为由于超时关闭,“5”为因迁出关闭
<AuctionStatus></AuctionStatus>拍卖状态
<BidPrice></BidPrice>拍卖目前竞标价格
<BidPriceCurrency></BidPriceCurrency>竞拍价格货币
<Bids></Bids>竞拍出价次数
<AuctionWonStatus></AuctionWonStatus>如果用户在拍卖中胜出
<YourHighBid></YourHighBid>您对该竞拍的高出价
<YourProxyBid></YourProxyBid>对此拍卖的代理竞拍出价

域名例子

请求(XML格式)

https://api.dynadot.com/api3.xml?key=1&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15

响应
<GetClosedAuctionsResponse>
  <GetClosedAuctionsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetClosedAuctionsHeader>
  <GetClosedAuctionsContent>
    <Auction>
      <AuctionId>2</AuctionId>
      <Domain>domain-exp143.ooo</Domain>
      <AuctionStatusId>4</AuctionStatusId>
      <AuctionStatus>Closed by Timeout</AuctionStatus>
      <BidPrice>89.99</BidPrice>
      <BidPriceCurrency>USD</BidPriceCurrency>
      <Bids>1</Bids>
      <AuctionWonStatus>won</AuctionWonStatus>
      <YourHighBid>89.99</YourHighBid>
      <YourProxyBid>1000.0</YourProxyBid>
    </Auction>
    <Auction>
      <AuctionId>3</AuctionId>
      <Domain>domain-exp144.vc</Domain>
      <AuctionStatusId>4</AuctionStatusId>
      <AuctionStatus>Closed by Timeout</AuctionStatus>
      <BidPrice>28.99</BidPrice>
      <BidPriceCurrency>USD</BidPriceCurrency>
      <Bids>1</Bids>
      <AuctionWonStatus>won</AuctionWonStatus>
      <YourHighBid>28.99</YourHighBid>
      <YourProxyBid>1000.0</YourProxyBid>
    </Auction>
  </GetClosedAuctionsContent>
</GetClosedAuctionsResponse>
请求(csv格式)

http://api.dynadot.com/api3.html?key=1&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15

响应

ok,
success,
AuctionId,Domain,AuctionStatusId,AuctionStatus,BidPrice,BidPriceCurrency,Bids,AuctionWonStatus,YourHighBid,YourProxyBid
2,domain.com,4,Closed by Timeout,89.99,USD,1,won,89.99,200
3,domain.com,4,Closed by Timeout,28.99,USD,1,won,28.99,300
.
.
.

 

获取开放过期域名竞拍命令

调用获取开放过期域名竞拍命令将返回正在进行中的过期域名竞拍列表。如果调用此命令,应包含以下参数:

获取开放过期域名竞拍请求参数
解释
currency (可选)返回货币结果,应为"usd", "eur", 或 "cny",,默认货币为美元
XML结果标签
解释
<GetOpenBackorderAuctionsResponse></GetOpenBackorderAuctionsResponse>获取开放过期域名竞拍响应标签,将作为响应XML文件的根节点
<GetOpenBackorderAuctionsHeader></GetOpenBackorderAuctionsHeader>获取开放过期域名竞拍标题
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用
<GetOpenBackorderAuctionsContent></GetOpenBackorderAuctionsContent>获取开放过期域名竞拍内容标签,只在状态为"success"时使用
<Auction></Auction>拍卖项目标签,仅状态为"success"时使用
<AuctionId></AuctionId>拍卖ID
<Domain></Domain>拍卖的域名
<BidPrice></BidPrice>拍卖目前竞标价格
<BidPriceCurrency></BidPriceCurrency>竞拍价格货币
<Bids></Bids>竞拍出价次数
<EndTime></EndTime>拍卖结束时间
<EndTimestamp></EndTimestamp>拍卖终止日期,以Unix时间计(毫秒,自UTC1970年一月1日午夜起)

获取开放过期竞拍域名例子

请求(XML格式)

https://api.dynadot.com/api3.xml?key=mykey&command=get_open_backorder_auctions&currency=usd

响应
<GetOpenBackorderAuctionsResponse>
  <GetOpenBackorderAuctionsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetOpenBackorderAuctionsHeader>
  <GetOpenBackorderAuctionsContent>
    <Auction>
           <AuctionId>0</AuctionId>
            <Domain>domain.com</Domain>
            <BidPrice>63.99</BidPrice>
            <BidPriceCurrency>USD</BidPriceCurrency>
            <Bids>0</Bids>
            <EndTime>2015/04/28 05:46 UTC</EndTime>
            <EndTimestamp>1430199960354</EndTimestamp>
    </Auction>
    <Auction>
           <AuctionId>0</AuctionId>
            <Domain>domain.com</Domain>
            <BidPrice>63.99</BidPrice>
            <BidPriceCurrency>USD</BidPriceCurrency>
            <Bids>0</Bids>
            <EndTime>2015/04/28 05:46 UTC</EndTime>
            <EndTimestamp>1430199960354</EndTimestamp>
    </Auction>
    .
    .
    .
  </GetOpenBackorderAuctionsContent>
</GetOpenBackorderAuctionsResponse>
请求(csv格式)

https://api.dynadot.com/api3.html?key=mykey&command=get_open_backorder_auctions&currency=usd

响应

ok,
success,
AuctionId,Domain,BidPrice,BidPriceCurrency,Bids,EndTime,EndTimestamp
10000,backorder0.com,6.35,USD,0,2017/08/29 17:53 UTC,1504029194453
10001,backorder1.com,1.0,USD,0,2017/08/29 17:53 UTC,1504029194453
10002,backorder2.com,1.0,USD,0,2017/08/29 17:53 UTC,1504029194453
.
.
.

 

获取过期域名竞拍详情命令

调用获取过期域名竞拍详情命令将返回指定的竞拍详情。该命令只以XML格式提供。如果调用该命令,应包含以下参数:

获取拍卖详情请求参数
解释
domain过期域名竞拍中的域名,IDN(国际域名)应使用域名代码(punycode),例如“xn--wkccg.com”
currency (可选)返回货币结果,应为"usd", "eur", 或 "cny",,默认货币为美元
XML结果标签
解释
<GetBackorderAuctionDetailsResponse></GetBackorderAuctionDetailsResponse>获取拍卖详情响应标签,它是XML文档响应的根节点
<GetAuctionDetailsHeader></GetAuctionDetailsHeader>获取拍卖详情标题
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用
<GetAuctionDetailsContent></GetAuctionDetailsContent>获取拍卖细节内容标签,仅当状态为"success"时可用
<AuctionStatusId></AuctionStatusId>拍卖状态ID,“0”为进行中,“1”为被用户关闭,“2”为被管理员关闭,“3”为因续费关闭,“4”为由于超时关闭,“5”为因迁出关闭
<AuctionStatus></AuctionStatus>拍卖状态
<AuctionId></AuctionId>拍卖ID
<Domain></Domain>拍卖的域名
<BidPrice></BidPrice>拍卖目前竞标价格
<BidPriceCurrency></BidPriceCurrency>竞拍价格货币
<Bids></Bids>竞拍出价次数
<EndTime></EndTime>拍卖结束时间
<EndTimestamp></EndTimestamp>拍卖终止日期,以Unix时间计(毫秒,自UTC1970年一月1日午夜起)
<Revenue></Revenue>拍卖收入
<RevenueCurrency></RevenueCurrency>收入货币
<Visitors></Visitors>域名访客
<Links></Links>到达域名链接
<Age></Age>域名年龄
<UserIsHighBid></UserIsHighBid>如果用户为出价最高者
<YourCurrentBid></YourCurrentBid>指定拍卖中您目前的竞拍出价;若尚未出价,则应为'-1'
<YourProxyBid></YourProxyBid>指定拍卖的代理竞拍;如果您尚未出价,应为'-1'

获取过期域名详情例子

请求

https://api.dynadot.com/api3.xml?key=mykey&command=get_backorder_auction_details&domain=example.com&currency=usd

响应
<GetBackorderAuctionDetailsResponse>
  <GetAuctionDetailsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetAuctionDetailsHeader>
  <GetAuctionDetailsContent>
    <Auction>
      <AuctionStatusId>0</AuctionStatusId>
      <AuctionStatus>IN_PROGRESS</AuctionStatus>
      <AuctionId>10001</AuctionId>
      <Domain>example.com</Domain>
      <BidPrice>89.99</BidPrice>
      <BidPriceCurrency>USD</BidPriceCurrency>
      <Bids>0</Bids>
      <EndTime>2015/04/28 18:16 UTC</EndTime>
      <EndTimestamp>1430244969779</EndTimestamp>
      <Revenue>114</Revenue>
      <RevenueCurrency>USD</RevenueCurrency>
      <Visitors>-1</Visitors>
      <Links>-1</Links>
      <Age>1</Age>
      <UserIsHighBid>false</UserIsHighBid>
      <YourCurrentBid>-1</YourCurrentBid>
      <YourProxyBid>-1</YourProxyBid>
    </Auction>
  </GetAuctionDetailsContent></GetBackorderAuctionDetailsResponse>
 

过期域名竞拍出价命令

调用过期域名竞拍出价命令将对指定的过期域名竞拍进行报价。如果调用该命令,应包含以下参数:

过期域名竞拍出价请求参数
解释
domain拍卖的域名、国际化域名应使用punycode,如"xn--wkccg.com"
bid_amount您的竞拍出价,默认货币为美元,您也可以指定货币类型
currency (可选)您竞拍的货币,应为"usd", "eur", 或 "cny",,默认货币为美元
XML结果标签
解释
<PlaceBakcorderAuctionBidResponse></PlaceBakcorderAuctionBidResponse>竞拍出价响应标签,它是响应XML文档的根节点
<PlaceBackorderAuctionBidHeader></PlaceBackorderAuctionBidHeader>竞拍出价标题
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用

进行过期域名拍卖出价例子

请求(XML格式)

https://api.dynadot.com/api3.xml?key=mykey&command=place_backorder_auction_bid&domain=example.com&bid_amount=99.9&currency=usd

响应
<PlaceBakcorderAuctionBidResponse>
 <PlaceBackorderAuctionBidHeader>
   <SuccessCode>0</SuccessCode>
   <Status>success</Status>
 </PlaceBackorderAuctionBidHeader>
</PlaceBakcorderAuctionBidResponse>
请求(csv格式)

https://api.dynadot.com/api3.html?key=mykey&command=place_backorder_auction_bid&domain=example.com&bid_amount=99.9&currency=usd

响应

ok,success

 

获取已关闭过期域名竞拍命令

调用获取已关闭过期域名命令将返回指定账户的已关闭过期域名竞拍列表。如果调用该命令,应包含以下参数:

获取已关闭的过期域名竞拍请求参数
解释
startDate拍卖起始日期,yyyy-mm-dd,如2015-05-05
endDate拍卖结束日期,yyyy-mm-dd,如2015-05-05
currency (可选)您竞拍的货币,应为"usd", "eur", 或 "cny",,默认货币为美元
XML结果标签
解释
<GetClosedBackorderAuctionsResponse></GetClosedBackorderAuctionsResponse>获取已关闭拍卖响应标签,它是响应XML文档的根节点
<GetClosedBackorderAuctionsHeader></GetClosedBackorderAuctionsHeader>获取已关闭拍卖标题
<SuccessCode></SuccessCode>如果操作成功,"0"为成功,"-1"为失败
<Status></Status>请求状态
<Error></Error>请求错误信息,仅状态为"error"时使用
<GetClosedBackorderAuctionsContent></GetClosedBackorderAuctionsContent>获取已关闭拍卖内容标签,仅当状态为"success"时使用
<Auction></Auction>拍卖项目标签,仅状态为"success"时使用
<YourHighBid></YourHighBid>您对该竞拍的高出价
<YourProxyBid></YourProxyBid>对此拍卖的代理竞拍出价
<AuctionId></AuctionId>拍卖ID
<Domain></Domain>拍卖的域名
<AuctionStatusId></AuctionStatusId>拍卖状态ID,“0”为进行中,“1”为被用户关闭,“2”为被管理员关闭,“3”为因续费关闭,“4”为由于超时关闭,“5”为因迁出关闭
<AuctionStatus></AuctionStatus>拍卖状态
<BidPrice></BidPrice>拍卖目前竞标价格
<BidPriceCurrency></BidPriceCurrency>竞拍价格货币
<Bids></Bids>竞拍出价次数

获取已关闭拍卖示例

请求(XML格式)

https://api.dynadot.com/api3.xml?key=1&command=get_closed_backorder_auctions&startDate=2000-01-02&endDate=2015-5-15

响应
<GetClosedBackorderAuctionsResponse>
  <GetClosedBackorderAuctionsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetClosedAuctionsHeader>
  <GetClosedBackorderAuctionsContent>
    <Auction>
      <AuctionWonStatus>won</AuctionWonStatus>
      <YourHighBid>89.99</YourHighBid>
      <YourProxyBid>1000.0</YourProxyBid>
      <AuctionId>2</AuctionId>
      <Domain>domain-exp143.ooo</Domain>
      <AuctionStatusId>4</AuctionStatusId>
      <AuctionStatus>Closed by Timeout</AuctionStatus>
      <BidPrice>89.99</BidPrice>
      <BidPriceCurrency>USD</BidPriceCurrency>
      <Bids>1</Bids>
    </Auction>
    <Auction>
      <AuctionWonStatus>won</AuctionWonStatus>
      <YourHighBid>28.99</YourHighBid>
      <YourProxyBid>1000.0</YourProxyBid>
      <AuctionId>3</AuctionId>
      <Domain>domain-exp144.vc</Domain>
      <AuctionStatusId>4</AuctionStatusId>
      <AuctionStatus>Closed by Timeout</AuctionStatus>
      <BidPrice>28.99</BidPrice>
      <BidPriceCurrency>USD</BidPriceCurrency>
      <Bids>1</Bids>
    </Auction>
  </GetClosedAuctionsContent>
</GetClosedAuctionsResponse>
请求(csv格式)

http://api.dynadot.com/api3.html?key=1&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15

响应

ok,
success,
AuctionId,Domain,AuctionStatusId,AuctionStatus,BidPrice,BidPriceCurrency,Bids,AuctionWonStatus,YourHighBid,YourProxyBid
2,domain.com,4,Closed by Timeout,89.99,USD,1,won,89.99,200
3,domain.com,4,Closed by Timeout,28.99,USD,1,won,28.99,300
.
.
.

 

Is Processing命令

呼叫is_processing可让您知晓提交一个新请求是否安全

Is_Processing请求参数
解释
不需额外参数
XML结果标签
解释
<Response></Response>is_processing响应标签
<RespnseHeader></RespnseHeader>is_processing标题标签
<ResponseMsg></ResponseMsg>is_processing响应信息标签,标签应显示为“yes”(系统中有正在处理的请求,您不应发送另一个请求)或“no”(您的账户中已没有处理中的请求,可以安全地提交新请求)

Is_Processing示例

请求

https://api.dynadot.com/api3.xml?key=mykey&command=is_processing

响应
<Response>
  <ResponseHeader>
    <ResponseCode>0</ResponseCode>
    <ResponseMsg>yes</ResponseMsg>
  </ResponseHeader>
</Response>
请求(csv格式)

http://api.dynadot.com/api3.html?key=mykey&command=is_processing

响应

ok,yes