阳光互联域名和主机API接口

上海有孚

域名A P I接口说明文档

作者: sundns

发行日期：2010/05/10

前言

本文档描述了上海有孚域名注册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)

1．API接口地址

接口采用HTTP，POST协议：

正式URL：/sundnsapi.aspx

管理域名的URL: /domainlogin.php

调用说明：

接口使用阳光互联分销商级别的数字ID（以下本文档简称为数字ID），即可调用。测试URL：/sundnsapi.aspx 注意：使用测试URL时请使用如下参数：

数字ID，即userid：1

用户密码：111111

email：test@

2．参数说明

2．1公共参数

注：所有各参数字符集为gb2312

以下参数是在访问接口时必须提供的，否则服务器直接返回错误信息。

2．2行为参数（action）

根据不同功能，选择不同的行为数值，每次调用只能选择一种行为。

2.2.1域名类

2.2.1.1域名注册

action=activate

详细参数列表：

注：所有参数名称中英文字母都是小写

另注:国内域名请按下列红字提醒添加购买后提示!“您的域名刚提交成功，只有通过域名注册管理机构CNNIC的审核才表时您的域名正式注册成功。请您确保域名正式注册成功后再提交续费，否则因为CNNIC审核不通过而删除域名，将不退还续费的费用。我们建议您在新域名成功15日后再提交续费。给您带来不便之处，敬请谅解。”

(此操作是收费的)

文字说明：

a.其中联系人包括以下四种，

注册人、管理人、缴费人、技术人

注册人的信息是必须的，其他联系人，可以和前面相同，也可以单独提供。例如单独提供管理人信息，在注册人相应参数前面加“a_”。

如：

a_ address_zh=上海市浦东新区金茂大厦3层

a_name=韦小宝

…等。

如果和注册人相同，设置admin_same_as参数的值为2。

如：

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

(此操作是免费的)

注：

中文类域名上述信息为中文内容，包括：CN英文域名(国内英文域名)

国内中文域名

英文类域名上述信息为英文内容，包括：国际英文域名

国际中文域名

Name域名

.mobi域名

.biz域名

2.2.1.3域名续费

action= renew

(此操作是收费的)

详细参数列表：

2.2.1.4注册主机(创建域名服务器) action= regdns

(此操作是收费的)

2.2.1.5修改解析服务器(域名DNS修改) action=chgdns

(此操作是免费的)

详细参数列表：

2.2.1.6修改域名密码

action=chgpwd

(此操作是免费的)

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

(此操作是免费的)