DNSDIY接口说明.docx
《DNSDIY接口说明.docx》由会员分享，可在线阅读，更多相关《DNSDIY接口说明.docx（14页珍藏版）》请在冰豆网上搜索。
DNSDIY接口说明
DNS-DIY接口说明
Ver2.0
Template产品组2004.01.12
1引言2
2目的2
3对象2
4功能说明2
5接口介绍2
6接口详解2
6.1sayhello:
握手，建立连接2
6.2logout:
注销3
6.3login3
6.4添加新域名3
6.5GETZONE4
6.6ZONEDETAIL4
6.6.1Append：
添加域名解析记录5
6.6.2Update：
更改域名解析记录5
6.6.3Delete：
删除域名解析记录5
6.7URLFORWARD域名指向6
6.7.1Append：
添加域名指向记录6
6.7.2Update：
更改域名指向记录7
6.7.3Delete：
删除域名指向记录7
6.8mailforward邮件转发7
6.8.1Append：
添加邮件转发记录8
6.8.2Update：
更改邮件转发记录8
6.8.3Delete：
删除邮件转发记录8
6.9关闭连接9
7修订历史10
1
引言
DNS-DIY是我公司推出的域名自助解析（指向）的服务和功能。
除了可以直接登录www.dns-进行操作外，我们也开放了接口。
只要是我公司的会员，就可以使用www.dns-或此套接口。
2目的
本文是为了帮助要在Template或其网站中嵌入DNS-DIY功能的用户，提供一个开发的说明和实例。
3对象
本文的阅读对象为Template或DNS-DIY功能的技术开发员。
4功能说明
利用Microsoft.XMLHTTP控件实现对DNS-DIY.COM在客户端的各种业务功能。
5接口介绍
DNS-DIY主要实现以下功能：
●添加域名
将您的域名添加到您的会员号下，域名可以是通过我司注册的，也可以是别的注册商处注册的域名。
●域名解析
添加域名、更改或删除域名的解析记录
●域名指向
添加域名、更改或删除域名的指向记录
●邮件转发
添加域名、更改或删除域名的邮件转发记录
每个功能必须经过如下几个步骤：
<1>HELLO发送握手，建立连接
<2>LOGIN登录，用会员号和密码登录
<3>GETZONE指定要解析的域名，必须确保该域名属于该代理会员号，如果成功服务端返回该域名的zone_id。
（注：
指在所对应的域名唯一id,以后的操作便以这个zone_id来进行）
<4>ADD\ZONEDETAIL\URLFORWARD\MAILFORMARD等功能的实现，具体的实现在接口详解说明。
<5>LOGOUT退出，操作完后退出。
注：
在进行LOGIN时，建议先进行LOGOUT，确保尚未登录DNS-DIY.COM
6接口详解
以下接口详解以ASP代码来说明。
6.1sayhello:
握手，建立连接
<%
dimhttp
#Createanxmlhttpobject:
创建对象
Sethttp=CreateObject（"Microsoft.XMLHTTP"）
#HELLO,建立与服务端的连接
http.Open"GET","http:
//www.dns-False
http.Send
response.writehttp.responseText&"
"
%>
成功返回：
DNS-DIY_VERSION=2.0API_VERSION=1.0SESSION_ID=8275AD2EE5B740241B795C1C7869F83C
6.2logout:
注销
<%
#为确保该会员尚未登录DNS-DIY，可先执行logout
#ok,youcanlogoutfirstanditwillnotreceivetheerrormsg
http.Open"GET","http:
//www.dns-False
http.Send
response.writehttp.responseText&"
"
%>
成功返回:
DNS-DIY_VERSION=2.0API_VERSION=1.0ACTION_RESULT=SUCCESS
6.3login：
登录
<%
data="username=youragentid&password=youragentpwd"
http.Open"POST","http:
//www.dns-False
http.Send
response.writehttp.responseText&"
"
%>
成功返回:
DNS-DIY_VERSION=2.0API_VERSION=1.0ACTION_RESULT=SUCCESS
否则返回：
DNS-DIY_VERSION=2.0API_VERSION=1.0ACTION_RESULT=FAILTURE
6.4添加新域名
添加域名的功能，将不属于您会员号下的域名添加到你的会员号下进行解析。
操作如下：
您必须得先进行sayhello,memberlogin这两个步骤，即上述的3.1和3.2,然后进行添加域名的操作。
<%
#addnewdomain
data="origin="&newdomain
‘其中newdomain为新增的域名
http.Open"POST","http:
//www.dns-False
http.Send’发送
http.responseText‘返回信息
%>
若返回成功，则为DNS-DIY_VERSION=2.0API_VERSION=1.0ACTION_RESULT=SUCCESS
否则返回DNS-DIY_VERSION=2.0API_VERSION=1.0ACTION_RESULT=FAILTURE
6.5GETZONE
注：
发送要操作的域名，取得返回值
<%
#必须确保该域名属于该会员
options="pattern=yourdomain"
http.Open"GET","http:
//www.dns-False
http.Send
response.writehttp.responseText&"
"
%>
成功返回：
DNS-DIY_VERSION=2.0API_VERSION=1.0SESSION_ID=7643808C1D66D794DFE2F73E827F42FAZONE_ORIGIN=yourdomain;ZONE_ID=5767TOTAL=1FROM=1;TO=1
对于所取得的返回值，可以经过分析得到ZONE_ID,这样在以后的操作中就可利用该ID号进行业务操作。
6.6ZONEDETAIL
进行域名解析的操作
<%
zone_id=5767（取得域名所对应的ID号，上一步分析得出）
‘进入域名解析操作
http.Open"GET","http:
//www.dns-&zone_id,False
http.Send
response.writehttp.responseText&"
"
%>
成功返回：
ZONE_ID=5767LAST_MODIFIED=2003-09-1807:
30:
23GMTCREATION_DATE=2003-08-0701:
01:
11GMTMAX_RR=50MIN_TTL=5DEFAULT_TTL=3600RR_ID=45326;RR_HOST=;RR_TYPE=NS;RR_DATA=218.107.207.120;RR_AUX=0;RR_TTL=3600;RR_FLAG=0RR_ID=45268;RR_HOST=;RR_TYPE=A;RR_DATA=218.107.207.120;RR_AUX=0;RR_TTL=3600;RR_FLAG=1
说明：
zone_id:
域名ID
lastmodified:
最后修改时间
creationdate:
创建时间
max_rr:
最多允许记录数
min_ttl：
允许最小的秒
defaultttl:
默认秒数
另外两个信息指系统中已经存在的记录。
Rr_id:
指系统返回的id
rr_host:
指主机名
rr_type:
指类型，有四种类型可选择A，NS，MX，CNAME
rr_data:
指ip地址或主机名
rr_aux:
指优先级
rr_ttl:
指秒数
经分析可得出每个解析对应的rr_id，以后的操作必须以这个ID号进行删除和修改
其中“优先级”仅对MX记录有意义，其他类型的记录将忽略“优先级”。
下面是几种域名解析业务操作的接口。
6.6.1Append：
添加域名解析记录
<%
#append
#以下的几个参数如同上面所述，注意zone_id
http.Open"GET","http:
//www.dns-False
http.Send
response.writehttp.responseText&"
"
%>
成功返回：
DNS-DIY_VERSION=2.0API_VERSION=1.0ACTION_RESULT=SUCCESS
否则返回：
DNS-DIY_VERSION=2.0API_VERSION=1.0EXCEPTION=AUTHORIZATION
6.6.2Update：
更改域名解析记录
<%
#update
http.Open"GET","http:
//www.dns-False
http.Send
response.writehttp.responseText&"
"
%>
注：
这里的参数id指在创建zonedetail返回的rr_id
成功返回:
DNS-DIY_VERSION=2.0API_VERSION=1.0ACTION_RESULT=SUCCESS
否则返回：
DNS-DIY_VERSION=2.0API_VERSION=1.0EXCEPTION=AUTHORIZATION
6.6.3Delete：
删除域名解析记录
<%
#delete
#45428代表rr_id
http.Open"GET","http:
//www.dns-False
http.Send
response.writehttp.responseText&"
"
%>
成功返回：
DNS-DIY_VERSION=2.0API_VERSION=1.0ACTION_RESULT=SUCCESS
否则返回：
DNS-DIY_VERSION=2.0API_VERSION=1.0SESSION_ID=282371B56A313DDD61E641BC1AD7F3B0
6.7URLFORWARD域名指向
<%
'URLFORWARD
'域名指向
zone_id=5767
http.Open"GET","http:
//www.dns-&zone_id,False
http.Send
response.writehttp.responseText&"
"
成功返回:
FORWARD_ID=11400;FORWARD_NAME=;FORWARD_URL=http:
//yangrc-;FORWARD_TITLE=tt;FORWARD_TYPE=LOCATION
FORWARD_ID=11400;FORWARD_NAME=;FORWARD_URL=;FORWARD_TITLE=tt;FORWARD_TYPE=LOCATIONFORWARD_ID=11556;FORWARD_NAME=;FORWARD_URL=;FORWARD_TITLE=asdfsa;FORWARD_TYPE=LOCATION
注：
forward_id为其返回的对应的ID号，以后的删除，更新操作均以这个ID号为操作代码。
否则返回：
DNS-DIY_VERSION=2.0API_VERSION=1.0EXCEPTION=AUTHORIZATION
6.7.1Append：
添加域名指向记录
<%
#append
http.Open"GET","http:
//www.dns-False
http.Send
response.writehttp.responseText&"
"
%>
参数说明：
①zone_id指服务器返回的;
②forward_name主机名；
③forward_url指向的目标地址；
④forward_type指向类型,主要有以下几种
非隐藏指向
隐藏指向
建设中
出售
⑤forward_title标题
成功返回：
DNS-DIY_VERSION=2.0API_VERSION=1.0ACTION_RESULT=SUCCESS
否则返回：
DNS-DIY_VERSION=2.0API_VERSION=1.0ACTION_RESULT=FAILURE
6.7.2Update：
更改域名指向记录
<%
#update
http.Open"GET","http:
//www.dns-
http.Send
response.writehttp.responseText&"
"
注：
其中参数id就是建立域名解析业务操作的时侯返回的对应域名的forward_id
成功返回：
DNS-DIY_VERSION=2.0API_VERSION=1.0ACTION_RESULT=SUCCESS
否则返回:
DNS-DIY_VERSION=2.0API_VERSION=1.0EXCEPTION=AUTHORIZATION
%>
6.7.3Delete：
删除域名指向记录
<%
#delete
http.Open"GET","http:
//www.dns-
http.Send
response.writehttp.responseText&"
"
%>
成功返回：
DNS-DIY_VERSION=2.0API_VERSION=1.0ACTION_RESULT=SUCCESS
否则返回：
DNS-DIY_VERSION=2.0API_VERSION=1.0SESSION_ID=F684A4A9287CCB995D98975D429C0F36
6.8mailforward邮件转发
<%
'MAILFORWARD
'邮件转发
zone_id=5767
http.Open"GET","http:
//www.dns-&zone_id,False
http.Send
response.writehttp.responseText&"
"
%>
成功返回:
DNS-DIY_VERSION=2.0API_VERSION=1.0ZONE_ORIGIN=FORWARD_ID=1656;FORWARD_ADDRESS=kkk@;FORWARD_GOTO=yangrc@china-
注：
返回值forward_id为以后update和detele操作时的id
forward_address为要转发的email，forward_goto为转发目标的email
6.8.1Append：
添加邮件转发记录
<%
#append
http.Open"GET","http:
//www.dns-False
http.Send
response.writehttp.responseText&"
"
%>
成功返回：
DNS-DIY_VERSION=2.0API_VERSION=1.0ACTION_RESULT=SUCCESS
否则返回：
DNS-DIY_VERSION=2.0API_VERSION=1.0EXCEPTION=AUTHORIZATION
或DNS-DIY_VERSION=2.0API_VERSION=1.0ACTION_RESULT=FAILURE
6.8.2Update：
更改邮件转发记录
<%
#udpate
http.Open"GET","http:
//www.dns-False
http.Send
response.writehttp.responseText&"
"
%>
成功返回：
DNS-DIY_VERSION=2.0API_VERSION=1.0ACTION_RESULT=SUCCESS
失败返回：
DNS-DIY_VERSION=2.0API_VERSION=1.0ACTION_RESULT=FAILURE
注：
id为所对应域名的forward_id值
6.8.3Delete：
删除邮件转发记录
<%
#delete
http.Open"GET","http:
//www.dns-False
http.Send
response.writehttp.responseText&"
"
%>
成功返回：
DNS-DIY_VERSION=2.0API_VERSION=1.0ACTION_RESULT=SUCCESS
6.9关闭连接
<%
Sethttp=Nothing
%>
7
修订历史
版本
时间
原因
内容
作者[角色]
1.0
2003.09.15
创建
Template产品组
2.0
2004.01.12
修改
增加“增加域名”
Template产品组
升级会员 