API 接口规范文档
更新内容:2008-11-24 增加域名 Whois 信息查询
2008-11-24 正式启用API接口
说明: API支持GET/POST方式,建议使用 POST 方式。
所有POST数据必须使用 UTF-8 编码对数据进行 URLEncode
除获取服务器时间外的其他接口,每次请求都需要进行身份验证。
建议使用获取服务器时间接口来获得 vtime 值。
1、获取服务器时间接口
URL地址:
http://www.domain-api.com/api-get-time.html
返回信息:
<?xml version="1.0" encoding="utf-8" ?>
<interface>
<time>20080723153933</time>
</interface>
返回信息说明:
time 值:14位时间值,用于身份验证的14位时间戳
2、身份验证方法
URL地址:
参见下列接口 URL 地址
参数:
username 用户名
vtime 14位时间戳
checksum 验证字串 = MD5(username + MD5(用户密码) + vtime)
2、域名查询接口
GET/POST地址:
http://www.domain-api.com/api-product-domain-query.html
参数:
domain 域名,如: abc.com,123.com,domain.cc 多个域名使用逗号间隔
正常返回信息:
<?xml version="1.0" encoding="utf-8" ?>
<interface>
<return_code><![CDATA[ 200 ]]></return_code>
<return_msg><![CDATA[ 验证通过 ]]></return_msg>
<check>
<domain>abc.com</domain>
<status>200</status>
<msg>可以注册</msg>
</check>
<check>
<domain>123.com</domain>
<status>201</status>
<msg>不可注册</msg>
</check>
<check>
<domain>domain.cc</domain>
<status>433</status>
<msg>查询失败</msg>
</check>
<check>
<domain>domain.aaa</domain>
<status>500</status>
<msg>错误的域名</msg>
</check>
</interface>
异常返回信息:
<?xml version="1.0" encoding="utf-8" ?>
<interface>
<return_code><![CDATA[ 433 ]]></return_code>
<return_msg><![CDATA[ 异常详细信息 ]]></return_msg>
</interface>
返回参数说明:
return_code 返回状态代码,成功 = 200
return_msg 返回详细提示信息
domain = 域名
status = 域名查询状态代码
200 = 可以注册
201 = 不可注册
433 = 查询失败
500 = 错误的域名
msg = 详细说明
2、域名注册接口
GET/POST地址:
http://www.domain-api.com/api-product-domain-buy.html
参数:
domain 域名,如: abc.com
year 注册年限(1-5)年
dns1 主要DNS服务器 ns.dnsfamily.com
dns2 备用DNS服务器 ns.cdnhost.cn
dom_cn 域名所有者(中文) 成都世纪东方网络通信有限公司
fn_cn 姓(中文) 小
ln_cn 名(中文) 明
country_cn 国家代码(中文) 中国
provinces_cn 省份(中文) 四川
city_cn 城市(中文) 成都
address_cn 地址(中文) 成都市XXX
dom_en 域名所有者(英文) Oriental Century
fn_en 姓(英文) Xiao
ln_en 名(英文) Ming
country_en 国家代码(英文) CN
provinces_en 省份(英文) Sichuan
city_en 城市(英文) Chengdu
address_en 地址(英文) Chengdu City
postcode 邮政编码 610041
tel 电话号码 +86.02882001809
fax 传真号码 +86.02882001809
email 电子邮件 service@51web.com
正常返回信息:
<?xml version="1.0" encoding="utf-8" ?>
<interface>
<return_code><![CDATA[ 200 ]]></return_code>
<return_msg><![CDATA[ 注册成功 ]]></return_msg>
</interface>
异常返回信息:
<?xml version="1.0" encoding="utf-8" ?>
<interface>
<return_code><![CDATA[ 433 ]]></return_code>
<return_msg><![CDATA[ 异常详细信息 ]]></return_msg>
</interface>
返回参数说明:
return_code 返回状态代码,成功 = 200
return_msg 返回详细提示信息
3、域名续费接口
GET/POST地址:
http://www.domain-api.com/api-product-domain-renew.html
参数:
domain 域名,如: abc.com
year 续费年限(1-5)年
expiredate 域名当前过期日期,如:2008-01-01
正常返回信息:
<?xml version="1.0" encoding="utf-8" ?>
<interface>
<return_code><![CDATA[ 200 ]]></return_code>
<return_msg><![CDATA[ 续费成功 ]]></return_msg>
</interface>
异常返回信息:
<?xml version="1.0" encoding="utf-8" ?>
<interface>
<return_code><![CDATA[ 433 ]]></return_code>
<return_msg><![CDATA[ 异常详细信息 ]]></return_msg>
</interface>
返回参数说明:
return_code 返回状态代码,成功 = 200
return_msg 返回详细提示信息
4、获取域名信息接口
GET/POST地址:
http://www.domain-api.com/api-product-domain-view.html
参数:
domain 域名,如: abc.com
正常返回信息:
<?xml version="1.0" encoding="utf-8" ?>
<interface>
<return_code><![CDATA[ 200 ]]></return_code>
<return_msg><![CDATA[ 验证通过 ]]></return_msg>
<domain><![CDATA[ abc.com ]]></domain>
<password><![CDATA[ 123456 ]]></password>
<regdate><![CDATA[ 2008-01-01 ]]></regdate>
<expiredate><![CDATA[ 2009-01-01 ]]></expiredate>
<dns1><![CDATA[ ns1.abc.com ]]></dns1>
<dns2><![CDATA[ ns2.abc.com ]]></dns2>
<dom_en><![CDATA[ XX Company ]]></dom_en>
<fn_en><![CDATA[ FirstName ]]></fn_en>
<ln_en><![CDATA[ LastName ]]></ln_en>
<country_en><![CDATA[ CN ]]></country_en>
<provinces_en><![CDATA[ Beijing ]]></provinces_en>
<city_en><![CDATA[ Beijing ]]></city_en>
<address_en><![CDATA[ Beijing City ]]></address_en>
<dom_cn><![CDATA[ 某某公司 ]]></dom_cn>
<fn_cn><![CDATA[ 小 ]]></fn_cn>
<ln_cn><![CDATA[ 李 ]]></ln_cn>
<country_cn><![CDATA[ 中国 ]]></country_cn>
<provinces_cn><![CDATA[ 北京 ]]></provinces_cn>
<city_cn><![CDATA[ 北京 ]]></city_cn>
<address_cn><![CDATA[ 北京 ]]></address_cn>
<postcode><![CDATA[ 100000 ]]></postcode>
<tel><![CDATA[ +86.01012345678 ]]></tel>
<fax><![CDATA[ +86.01012345678 ]]></fax>
<email><![CDATA[ support@abc.com ]]></email>
</interface>
异常返回信息:
<?xml version="1.0" encoding="utf-8" ?>
<interface>
<return_code><![CDATA[ 433 ]]></return_code>
<return_msg><![CDATA[ 异常详细信息 ]]></return_msg>
</interface>
返回参数说明:
return_code 返回状态代码,成功 = 200
return_msg 返回详细提示信息
domain 域名
password 域名密码
regdate 注册日期
expiredate 过期日期
dns1 主要DNS服务器
dns2 备用DNS服务器
dom_cn 域名所有者(中文) 成都世纪东方网络通信有限公司
fn_cn 姓(中文) 小
ln_cn 名(中文) 明
country_cn 国家代码(中文) 中国
provinces_cn 省份(中文) 四川
city_cn 城市(中文) 成都
address_cn 地址(中文) 成都市XXX
dom_en 域名所有者(英文) Oriental Century
fn_en 姓(英文) Xiao
ln_en 名(英文) Ming
country_en 国家代码(英文) CN
provinces_en 省份(英文) Sichuan
city_en 城市(英文) Chengdu
address_en 地址(英文) Chengdu City
postcode 邮政编码 610041
tel 电话号码 +86.02882001809
fax 传真号码 +86.02882001809
email 电子邮件 service@51web.com
5、域名修改DNS接口
GET/POST地址:
http://www.domain-api.com/api-product-domain-dns.html
参数:
domain 域名,如: abc.com
dns1 主要DNS服务器地址,如:ns.dnsfamily.com
dns2 备用DNS服务器地址,如:ns.cdnhost.cn
正常返回信息:
<?xml version="1.0" encoding="utf-8" ?>
<interface>
<return_code><![CDATA[ 200 ]]></return_code>
<return_msg><![CDATA[ 修改成功 ]]></return_msg>
</interface>
异常返回信息:
<?xml version="1.0" encoding="utf-8" ?>
<interface>
<return_code><![CDATA[ 433 ]]></return_code>
<return_msg><![CDATA[ 异常详细信息 ]]></return_msg>
</interface>
返回参数说明:
return_code 返回状态代码,成功 = 200
return_msg 返回详细提示信息
6、获取域名 Whois 信息接口
GET/POST地址:
http://www.domain-api.com/api-product-domain-whois.html
参数:
domain 域名,如: abc.com
正常返回信息:
<?xml version="1.0" encoding="utf-8" ?>
<interface>
<return_code><![CDATA[ 200 ]]></return_code>
<return_msg><![CDATA[ 验证通过 ]]></return_msg>
<whois><![CDATA[ Whois 信息 ]]></whois>
</interface>
异常返回信息:
<?xml version="1.0" encoding="utf-8" ?>
<interface>
<return_code><![CDATA[ 433 ]]></return_code>
<return_msg><![CDATA[ 异常详细信息 ]]></return_msg>
</interface>
返回参数说明:
return_code 返回状态代码,成功 = 200
return_msg 返回详细提示信息
whois Whois 信息
分享到:
相关推荐
早期的whois查询多以命令列接口存在,但是现在出现了一些网页接口简化的线上查询工具,可以一次向不同的数据库查询。网页接口的查询工具仍然依赖whois协议向服务器发送查询请求,命令列接口的工具仍然被系统管理员...
# # Sends ICMP packets to google.com to check connectivityping google.comifconfig 显示所有接口的IP地址ifconfigiwconfig 显示接口的无线属性,例如ESSID,加密密钥。 iwconifg主持人对域名执行IP查找,反之
2.3.1 Whois和Finger 14 2.3.2 文件传输协议 14 2.3.3 Telnet 14 2.3.4 Email 14 2.3.5 WWW 14 2.3.6 USENET News 15 2.4 Intranet和Extranet概览 15 2.4.1 Intranet 15 2.4.2 将Intranet对外开放 16 2.5 Internet的...
25.4 相关RFC文档 285 25.5 小结 285 第26章 文件传输协议 286 26.1 FTP和TFTP在网络世界中的作用 286 26.2 使用FTP传输文件 286 26.2.1 FTP连接 287 26.2.2 使用FTP客户端建立连接 288 26.2.3 FTP安全 296 26.2.4 ...
2.3.1 Whois和Finger 14 2.3.2 文件传输协议 14 2.3.3 Telnet 14 2.3.4 Email 14 2.3.5 WWW 14 2.3.6 USENET News 15 2.4 Intranet和Extranet概览 15 2.4.1 Intranet 15 2.4.2 将Intranet对外开放 16 2.5 Internet的...
2.3.1 Whois和Finger 14 2.3.2 文件传输协议 14 2.3.3 Telnet 14 2.3.4 Email 14 2.3.5 WWW 14 2.3.6 USENET News 15 2.4 Intranet和Extranet概览 15 2.4.1 Intranet 15 2.4.2 将Intranet对外开放 16 2.5 Internet的...
2.3.1 Whois和Finger 14 2.3.2 文件传输协议 14 2.3.3 Telnet 14 2.3.4 Email 14 2.3.5 WWW 14 2.3.6 USENET News 15 2.4 Intranet和Extranet概览 15 2.4.1 Intranet 15 2.4.2 将Intranet对外开放 16 2.5 Internet的...
据报文 179 17.3.1 串行线路接口协议(SLIP) 179 17.3.2 压缩的SLIP(CSLIP) 180 17.3.3 点到点协议(PPP) 180 17.4 隧道远程访问 184 17.4.1 点到点隧道协议(PPTP) 185 17.4.2 两层隧道协议(L2TP) ...
从区域 173 12.5.3 修改/etc/named.conf文件以配置一个 缓冲区域 173 12.5.4 DNS记录类型 174 12.6 组装各部分 177 12.7 DNS工具箱 182 12.7.1 nslookup 182 12.7.2 dig 183 12.7.3 whois ...