php API 接口规范


更新内容:2009-05-12 Whois 查询增加注册信息显示
2009-04-24 增加域名修改信息接口
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

返回信息:

返回信息说明:
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 多个域名使用逗号间隔
正常返回信息:

abc.com
200
可以注册

123.com
201
不可注册

domain.cc
433
查询失败

domain.aaa
500
错误的域名

异常返回信息:

返回参数说明:
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
正常返回信息:

异常返回信息:

返回参数说明:
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
正常返回信息:

异常返回信息:

返回参数说明:
return_code 返回状态代码,成功 = 200
return_msg 返回详细提示信息

4、获取域名信息接口
GET/POST地址:
http://www.domain-api.com/api-product-domain-view.html
参数:
domain 域名,如: abc.com
正常返回信息:

异常返回信息:

返回参数说明:
return_code 返回状态代码,成功 = 200
return_msg 返回详细提示信息

domain 域名
password 域名密码
buydate 注册日期
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
正常返回信息:

异常返回信息:

返回参数说明:
return_code 返回状态代码,成功 = 200
return_msg 返回详细提示信息

6、获取域名 Whois 信息接口
GET/POST地址:
http://www.domain-api.com/api-product-domain-whois.html
参数:
domain 域名,如: abc.com
正常返回信息:

 

异常返回信息:

返回参数说明:
return_code 返回状态代码,成功 = 200
return_msg 返回详细提示信息

whois Whois 信息

7、域名修改信息接口
GET/POST地址:
http://www.domain-api.com/api-product-domain-info.html
参数:
domain 域名,如: abc.com

fn_cn 姓(中文) 小
ln_cn 名(中文) 明
country_cn 国家代码(中文) 中国
provinces_cn 省份(中文) 四川
city_cn 城市(中文) 成都
address_cn 地址(中文) 成都市XXX

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
正常返回信息:

异常返回信息:

返回参数说明:
return_code 返回状态代码,成功 = 200
return_msg 返回详细提示信息

原文链接:http://www.domain-api.com/

发表评论

您的电子邮箱地址不会被公开。

此站点使用Akismet来减少垃圾评论。了解我们如何处理您的评论数据