阳光互联域名和主机API接口
上海有孚域名A P I 接口说明文档作 者: sundns发行日期:2010/05/10第 1 页 共 17 页 ,IDC 商城友情提供 注册网址http://www
上海有孚
域名A P I 接口说明文档
作 者: sundns
发行日期:2010/05/10
第 1 页 共 17 页
,IDC 商城友情提供 注册网址http://www.idcdaigou.com
前言
本文档描述了上海有孚域名注册API 接口协议。本文档描述了基本的数据交换标准,其中包括数据格式,数据定义,以及一些相关约定。
目录
1.API 接口地址 . ............................................................................................................................ 3
2.参数说明..................................................................................................................................... 3
2.1公共参数 . ................................................................................................................................ 3
2.2行为参数(ACTION ) ............................................................................................................ 4
2.2.1域名类 . ................................................................................................................................ 4
2.2.1.1域名注册 . ..................................................................................................................... 4
2.2.1.2修改联系人 . ................................................................................................................. 7
2.2.1.3域名续费 . ..................................................................................................................... 8
2.2.1.4注册主机(创建域名服务器) ....................................................................................... 9
2.2.1.5修改解析服务器(域名DNS 修改) ............................................................................. 9
2.2.1.6修改域名密码 . ............................................................................................................. 9
2.2.1.7修改主机IP(修改域名服务器IP) ............................................................................ 10
2.2.1.8域名转入 . ................................................................................................................... 10
2.2.1.9域名解析 . ................................................................................................................... 10
2.2.1.9.1 显示域名当前解析记录 . ................................................................................... 10
2.2.1.9.2 增加域名解析记录 . ........................................................................................... 11
2.2.1.9.3 删除域名解析记录 . ........................................................................................... 12
2.2.1.9.4 修改域名解析记录 . ........................................................................................... 13
2.2.1.9.5 购买解析记录条数 . ........................................................................................... 13
2.2.1.10 显示域名信息 . ........................................................................................................ 13
2.2.1.11 参数限制 . ................................................................................................................ 15
2.2.1.11.1 Cn域名以及国内中文域名 ............................................................................. 15
2.2.2 虚拟主机类 . ..................................................................................................................... 15
2.2.2.1 虚拟主机购买 . .......................................................................................................... 15
2.2.2.2 虚拟主机续费 . .......................................................................................................... 16
2.2.2.4.3修改主机管理密码(FTP密码) .......................................................................... 17
Document No.: 001 第 2 页 共 17页 VER: 1.0
,IDC 商城友情提供 注册网址http://www.idcdaigou.com
1.API 接口地址
接口采用HTTP ,POST 协议:
正式URL :http://api.sundns.com/sundnsapi.aspx
管理域名的URL: http://www.ufhost.com/domainlogin.php
调用说明:
接口使用阳光互联分销商级别的数字ID (以下本文档简称为数字ID ),即可调用。
测试URL :http://apidemo.sundns.com/sundnsapi.aspx 注意:使用测试URL 时请使用如下参数: 数字ID ,即userid :1 用户密码:111111 email :test@sundns.com
2.参数说明
2.1公共参数
注:所有各参数字符集为gb2312
以下参数是在访问接口时必须提供的,否则服务器直接返回错误信息。

Document No.: 001 第 3 页 共 17页 VER: 1.0
,IDC 商城友情提供 注册网址http://www.idcdaigou.com

2.2行为参数(action )
根据不同功能,选择不同的行为数值,每次调用只能选择一种行为。
2.2.1域名类
2.2.1.1域名注册 action=activate
详细参数列表:
注:所有参数名称中英文字母都是小写
另注:国内域名请按下列红字提醒添加购买后提示! “您的域名刚提交成功,只有通过域名注册
管理机构CNNIC 的审核才表时您的域名正式注册成功。请您确保域名正式注册成功后再提交续费,否则因为CNNIC 审核不通过而删除域名,将不退还续费的费用。我们建议您在新域名成功15日后再提交续费。给您带来不便之处,敬请谅解。”
(此操作是收费的) Document No.: 001 第 4 页 共 17页 VER: 1.0

IDC 商城友情提供 注册网址http://www.idcdaigou.com
Document No.: 001 第 5 页 共 17页 VER: 1.0

IDC 商城友情提供 注册网址http://www.idcdaigou.com
文字说明:
a. 其中联系人包括以下四种,
注册人、管理人、缴费人、技术人
注册人的信息是必须的,其他联系人,可以和前面相同,也可以单独提供。例如单独提供管理人信息,在注册人相应参数前面加“a_”。
如:
a_ address_zh=上海市浦东新区金茂大厦3层 a_name=韦小宝 „等。
如果和注册人相同,设置admin_same_as参数的值为2。
Document No.: 001 第 6 页 共 17页 VER: 1.0

IDC 商城友情提供 注册网址http://www.idcdaigou.com
如:
admin_same_as=2
b 如果admin_same_as,tech_same_as,bill_same_as赋值,则无需提供各自对应的联系人信息的每个参数的值。
c. 注册asia 域名, 技术人信息是必须的, 而且只能为阳光互联信息, 不能单独提供, 使用与阳光互联相同的技术人共享模式, 设置参数tech_same_as的值为1. 如:
tech_same_as=1 „
2.2.1.2修改联系人 action= chgcontact
(此操作是免费的)

Document No.: 001 第 7 页 共 17页 VER: 1.0
,IDC 商城友情提供 注册网址http://www.idcdaigou.com

注:
中文类域名上述信息为中文内容,包括: CN 英文域名(国内英文域名) 国内中文域名
英文类域名上述信息为英文内容,包括: 国际英文域名 国际中文域名 Name 域名 .mobi 域名 .biz 域名
2.2.1.3域名续费 action= renew
(此操作是收费的)
详细参数列表: Document No.: 001 第 8 页 共 17页 VER: 1.0

IDC 商城友情提供 注册网址http://www.idcdaigou.com
2.2.1.4注册主机(创建域名服务器) action= regdns
(此操作是收费的)



2.2.1.5修改解析服务器(域名DNS 修改) action=chgdns
(此操作是免费的)
详细参数列表:
2.2.1.6修改域名密码 action=chgpwd
(此操作是免费的)
Document No.: 001 第 9 页 共 17页 VER: 1.0

IDC 商城友情提供 注册网址http://www.idcdaigou.com
2.2.1.7修改主机IP(修改域名服务器IP) action=chgdnshost
(此操作是免费的, 一天只能提交一次)

2.2.1.8域名转入 action=transfer
(此操作是收费的)
详细参数列表:


2.2.1.9域名解析
域名解析包括:显示域名的当前解析记录,新增解析记录,修改,删除。
只读的记录类型有:SOA 记录,id=0的NS 记录,此两类记录不能进行删改操作
可供增删改操作的记录类型有:A 记录、NS 记录、MX 记录、CNAME 记录、 URL 转发记录
2.2.1.9.1 显示域名当前解析记录
action= query_rr
(此操作是免费的) Document No.: 001 第 10 页 共 17页 VER: 1.0
