前言
Dynadot是通过ICANN认证的域名注册商,自2002年成立以来,服务于全球108个国家和地区的客户,为数以万计的客户提供简洁,优惠,安全的域名注册以及管理服务。
Dynadot平台操作教程索引(包括域名邮箱,解析,建站,优惠长期更新)
Dynadot.com提供的API是专为效率而构建的高级域名管理和获取工具包。在Dynadot平台上,我们提供了多个命令来设置,管理,注册和竞标域名。
在具体的功能API代码前,请阅读关于Dynadot的API使用须知。
过期清仓域名是指没有在过期域名拍卖中收到任何竞标的域名。这些域名将拥有一个固定的标价,每天下降,直到清仓域名的期限结束。
使用DynadotAPI,可以查看当前正在进行清仓的域名列表。
命令参数
如果要发送查看清仓过期域名列表的命令时,所需命令参数如下。
|---------------------------|-------------------------------------|
| 获取过期的清仓域名请求参数 | 解释 |
| currency(optional) | 返回结果的货币应为"usd","eur"或"cny",默认货币为美元。 |
| domain(optional) | 如果要查询清算域,请添加此参数 |
| count_per_page (optional) | 每页显示多少个实体 |
| page_index (optional) | 你想查看哪个页面的实体? |
在成功发送查看当前清仓过期域名列表的命令之后,返回的结果将以XML或是JSON格式的标签返回,其中XML的结果标签所代表含义由下图所示:
|-----------------------------------------------------------------------------|------------------------------------------------|
| XML结果标签 | 解释 |
| <GetExpiredCloseoutDomainsResponse></GetExpiredCloseoutDomainsResponse> | Get Expired Closeout Domains的标签响应,是响应XML文档的根节点 |
| <GetExpiredCloseoutDomainsHeader></GetExpiredCloseoutDomainsHeader> | 获取过期清仓域名标题 |
| <ResponseCode></ResponseCode> | 如果操作成功,则为成功的"0",失败的"-1" |
| <Status></Status> | 请求状态 |
| <Error></Error> | 请求的错误信息仅在状态为"错误"时使用 |
| <GetExpiredCloseoutDomainsContent></GetExpiredCloseoutDomainsContent> | 内容标记,仅在状态为'成功'时使用 |
| <CloseoutItem></CloseoutItem> | 清仓商品 |
| <DomainName></DomainName> | 域名 |
| <DomainNameUtf></DomainNameUtf> | 域名采用UTF格式 |
| <CurrentPrice></CurrentPrice> | 当前价格 |
| <isIdn></isIdn> | 是否为idn域名 |
| <EndTimeStamp></EndTimeStamp> | 拍卖结束日期的Unix时间(自1970年1月1日UTC午夜以来的毫秒数) |
| <RenewalPrice></RenewalPrice> | 续费价格 |
| <ExpiredRevenue></ExpiredRevenue> | 清仓收入 |
| <DynaAppraisal></DynaAppraisal> | DynaAppraisal |
| <InboundLinks></InboundLinks> | 到达域名链接 |
| <MonthlyVisitors></MonthlyVisitors> | 域名访客 |
| <Currency></Currency> | 货币 |
示例
此处,使用API发送命令。
将高级域API请求发送到以下URL:https://api.dynadot.com/api3.xml。
Request (XML format)
https://api.dynadot.com/api3.xml?key=MY_API_KEY\&command=get_expired_closeout_domains¤cy=usd
Response (XML format)
XML
<?xml version="1.0" encoding="UTF-8"?>
<GetExpiredCloseoutDomainsResponse>
<GetExpiredCloseoutDomainsHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</GetExpiredCloseoutDomainsHeader>
<GetExpiredCloseoutDomainsContent>
<CloseoutItem>
<DomainName>test.biz</DomainName>
<DomainNameUtf>test.biz</DomainNameUtf>
<CurrentPrice>9.91</CurrentPrice>
<IsIDN>false</IsIDN>
<EndTimeStamp>0</EndTimeStamp>
<RenewalPrice>9.99</RenewalPrice>
<ExpiredRevenue>9.90</ExpiredRevenue>
<EstibotAppraisal>1223</EstibotAppraisal>
<InboundLinks>-1</InboundLinks>
<MonthlyVisitors>-1</MonthlyVisitors>
<Currency>usd</Currency>
</CloseoutItem>
</GetExpiredCloseoutDomainsContent>
</GetExpiredCloseoutDomainsResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=MY_API_KEY\&command=get_expired_closeout_domains¤cy=usd
Response (JSON format)
{
"GetExpiredCloseoutDomainsResponse": {
"ResponseCode": 0,
"Status": "success",
"Size": 1,
"CloseoutDomains": [
{
"closeoutItem": {
"domainName": "test.biz",
"domainNameUtf": "test.biz",
"currentPrice": "9.91",
"isIdn": false,
"endTimeStamp": 0,
"renewalPrice": "9.99",
"expiredRevenue": "9.90",
"estibotAppraisal": "1223",
"inboundLinks": -1,
"monthlyVisitors": -1,
"currency": "usd"
}
}
]
}
}
XML格式(实际操作)
JSON格式