耐思尼克
域名注册、虚拟主机、企业邮局API接口说明文档
https://www.doczj.com/doc/607863004.html,
更新时间：2008-5-6
版本变更说明：
前言
本文档描述了耐思尼克域名注册API接口协议。本文档描述了基本的数据交换标准，其中包括数据格式，数据定义，以及一些相关约定。
目录
版本变更说明： (2)
1．API接口地址 (5)
2．参数说明 (5)
2．1公共参数 (5)
2．2行为参数（action） (6)
2.2.1域名类 (6)
2.2.1.1域名注册 (6)
2.2.1.2修改联系人 (8)
2.2.1.3域名续费 (9)
2.2.1.5修改解析服务器(域名DNS修改) (9)
2.2.1.6修改域名密码 (10)
2.2.1.7 显示域名信息 (10)
2.2.1.8域名解析 (11)
2.2.1.8.1 显示域名当前解析记录 (11)
2.2.1.8.2 增加域名解析记录 (12)
2.2.1.8.3 删除域名解析记录 (13)
2.2.1.8.4 修改域名解析记录 (13)
2.2.1.8.5 重启DNS服务器 (14)
2.2.2虚拟主机类 (15)
2.2.2.1 虚拟主机购买 (15)
2.2.2.2 虚拟主机续费 (17)
2.2.2.3 虚拟主机升级 (18)
2.2.2. 4自定制主机增加空间 (19)
2.2.2.5 虚拟主机管理 (20)
2.2.2.4.1修改主机管理密码(FTP密码) (20)
2.2.2.4.2修改主机域名 (20)
2.2.2.4.3查询FTP用户名是否可用 (20)
2.2.2.4.4显示主机信息 (21)
2.2.2.4.5显示主机已使用容量 (21)
2.2.3企业邮局类 (22)
2.2.3.1 企业邮局购买 (22)
2.2.3.2 企业邮局续费 (23)
2.2.3.3企业邮局升级 (24)
2.2.3.4 增加企业邮局容量 (24)
2.2.3.5 企业邮局管理 (25)
2.2.3.5.1修改邮局管理员密码 (25)
2.2.3.5.2修改邮局域名 (25)
2.2.3.3.5显示邮局信息 (25)
2.2.4数据库类 (26)
2.2.4.1数据库购买 (26)
2.2.4.2数据库续费 (26)
2.2.4.3数据库升级 (27)
2.2.4.4 增加容量 (27)
2.2.4.5 数据库更改密码 (27)
2.2.4.6 显示数据库信息 (27)
2.2.5 NiceCall网络秘书类 (28)
2.2.5.1 NiceCall购买 (28)
2.2.5.2 NiceCall续费 (29)
2.2.5.3 修改管理员密码 (29)
2.2.5.4显示NiceCall信息 (29)
2.2.5.5查询Nicecall的唯一标识 (30)
2.2.6业务操作类 (31)
2.2.6.1 业务重提 (31)
2.2.6.2 账户余额显示 (31)
3.应答代码 (32)
3.1. 成功返回 (32)
3.2. 处理中返回，等待成功 (32)
3.3. 失败返回，不可能成功 (33)
4.应用示例 (33)
4．1 CN英文域名注册 (33)
4．2国际英文域名注册 (34)
4．5国际英文域名续费 (36)
5．错误代码 (37)
1．API接口地址
接口采用HTTP，POST协议：
正式URL：https://www.doczj.com/doc/607863004.html,/
调用说明：
接口使用耐思尼克的用户，即可调用。
测试URL：https://www.doczj.com/doc/607863004.html,/
注意：使用测试URL时请使用如下参数：
用户名：testapi
用户密码：123456
email：test@https://www.doczj.com/doc/607863004.html,
2．参数说明
2．1公共参数
注：所有各参数字符集为gb2312
以下参数是在访问接口时必须提供的，否则服务器直接返回错误信息。
2．2行为参数（action）
根据不同功能，选择不同的行为数值，每次调用只能选择一种行为。
2.2.1域名类
2.2.1.1域名注册
action=activate
详细参数列表：
注：所有参数名称中英文字母都是小写
(此操作是收费的)
文字说明：
a.其中联系人包括以下四种，
注册人、管理人、缴费人、技术人
注册人的信息是必须的，其他联系人，可以和前面相同，也可以单独提供。例如单独提供管理人信息，在注册人相应参数前面加“a_”。
如：
a_ address_zh=广东珠海香洲
a_name=耐思尼克
…等。
如果和注册人相同，设置admin_same_as参数的值为2。
如：
admin_same_as=2
b如果admin_same_as,tech_same_as,bill_same_as赋值，则无需提供各自对应的联系人信息的每个参数的值。
2.2.1.2修改联系人
action= chgcontact
(此操作是免费的)
详细参数列表：
2.2.1.3域名续费
action= renew
(此操作是收费的)
详细参数列表：
2.2.1.5修改解析服务器(域名DNS修改) action=chgdns
(此操作是免费的)
详细参数列表：
2.2.1.6修改域名密码
action=chgpwd
(此操作是免费的)
2.2.1.7 显示域名信息
action = getdomaininfo
域名显示结果说明：
2.2.1.8域名解析
域名解析包括：显示域名的当前解析记录，新增解析记录，修改，删除。
只读的记录类型有：SOA记录，id=0的NS记录，此两类记录不能进行删改操作可供增删改操作的记录类型有：A记录、MX记录、CNAME记录、URL转发记
录
2.2.1.8.1 显示域名当前解析记录
action= query_rr
(此操作是免费的)
2.2.1.8.2 增加域名解析记录
显示域名解析记录返回代码说明：
注：上面返回xml节点当中
< record >
……
record为遍历的每条解析记录，各节点名称及值如下：
type值表示不同的记录类型：
SOA表示SOA记录
A表示A记录
MX表示MX记录,即邮件交换记录
CNAME表示CNAME记录
URL表示URL转发
URL_HIDDEN表示URL隐含转发记录
id 值表示：记录ID
name值表示：RR值，并域名，例如：https://www.doczj.com/doc/607863004.html,，https://www.doczj.com/doc/607863004.html,等values表示：对应资源地址，如IP，域名等。
ttl表示：DNS服务器上缓存时间
prio表示：优先级
2.2.1.8.3 删除域名解析记录
action =del_rr
(此操作是免费的)
2.2.1.8.4 修改域名解析记录
action = modify_rr
(此操作是免费的)
2.2.1.8.5 重启DNS服务器
action = restart_rr
注: 以上的DNS增,删,改操作都并未实时生效, 必须重启DNS服务器, 以上操作才生效
2.2.2虚拟主机类
2.2.2.1 虚拟主机购买
action = activate
action = activate_diy (自定制主机) (此操作是收费的)
主机购买成功显示结果说明：
注：根据国家法律规定，建设网站都需要登记备案，请您务必尽快催促您的主机客户办理备案，我们将不定期进行检查，一经发现未备案网站，我们将随时关闭，由此造成的一切后果由您自负。请您参看备案方法：
方法一：请您登录到https://www.doczj.com/doc/607863004.html,用户控制中心-->主机管理-->登录名-->主机备案-->填写备案信息提交即可。
方法二：请您登录信息产业部网站https://www.doczj.com/doc/607863004.html,自行提交备案申请（查看：信息产业部ICP备案流程）。
2.2.2.2 虚拟主机续费
action = renew
(此操作是收费的)
主机续费成功显示结果说明：
2.2.2.3 虚拟主机升级
action = uprenew
(此操作是收费的)
注：低一级的空间，可升级比之高级的任一空间，高级空间不能降级。
1.主机升级系统不能自动迁移SqlServer和Mysql数据库，需客户自行操作。
2.自定制的空间不能升级，只能增加容量
3.升级主机费用的计算公式为:
(新产品每年价格－旧产品每年价格)ⅹ(当前产品剩余使用天数) / 365
主机升级成功显示结果说明：
2.2.2. 4自定制主机增加空间
action = increase
(此操作是收费的)
注：只有是自定制的空间才可以增加空量
增加空间容量的计算公式为:
同样容量的自定制空间每年价格x 所剩天数/365
2.2.2.5 虚拟主机管理
虚拟主机管理包括：更改主机管理密码，修改主要域名，显示主机信息，查询FTP用户是否被注册。
2.2.2.4.1修改主机管理密码(FTP密码)
action = changepwd
(此操作是免费的)
注：不适用独享服务器主机。
2.2.2.4.2修改主机域名
action = changedomain
2.2.2.4.3查询FTP用户名是否可用
action = checkftpname
(此操作是免费的)