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

第 1 页 共 17 页

上海有孚

域名API接口说明文档

作 者: sundns

发行日期：2010/05/10

IDC商城友情提供 注册网址

Document No.: 001 第 2 页 共 17页 VER: 1.0

前言

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

IDC商城友情提供 注册网址

Document No.: 001 第 3 页 共 17页 VER: 1.0

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

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

序号 名称 说明 类型(长度) 备注

1 Userid 阳光互联数字ID 常量(6位数字) 阳光互联数字ID

2 Userstr md5(

数字ID

用户密码

email

vtime

) 常量(32位字符) md5，API认证函数

数字ID(阳光互联数字ID)

用户密码(ID密码)

邮箱(ID下邮箱)

vtime为12位字符

例如当前时间是：

2006年8月30日8点15分

vtime=200608300815

四项值依顺序连接,通过md5函数处理后，userstr值为32位的字符串。 IDC商城友情提供 注册网址

Document No.: 001 第 4 页 共 17页 VER: 1.0

3 Category domain

常量 产品类别为域名

host 产品类别为主机

mail 产品类别为邮箱

all 业务操作类，不具体产品类别

4 Action 操作行为 常量 根据不同功能，提供不同的数值，下面有详细说明。

5 Vtime vtime为12位字符

例如当前时间是：

2006年8月30日8点15分

vtime=200608300815

注:服务器时间与北京时间相同

6 Sourceid 业务请求序号 字符(16位) 业务请求序号，用于标识每次业务请求的序号，此值必须唯一。

2．2行为参数（action）

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

2.2.1域名类

2.2.1.1域名注册

action=activate

详细参数列表：

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

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