dnspod域名解析api说明

DNSPod用户API文档

版本：V4.6

日期：2012-08-24

API开发规范

目前DNSPod的API是完全免费开放给大家使用的，但是不同等级的域名和账号会有不同的请求次数限制，具体情况请看官方网站产品线说明。

1、关于滥用：

以下这些，但并不限于以下这些行为都被视为滥用：

a.短时间内大量添加、删除、修改、刷新域名或者记录，或者设置记录状态。

b.记录内容没有任何改变的刷新，比如动态DNS中IP没变也请求修改记录。

c.其它没有提到的，但会给系统带来压力的请求行为。

2、禁止登录：

如果账号尝试登录错误次数在5分钟内超过30次则会被禁止登录一个小时，写程序的时候特别是动态客户端的时候必须判断是否登录成功，如果不成功必须马上停止尝试。如果使用动态客户端，在网页上修改了密码后务必到客户端修改，否则将不可用。

3、关于封禁：

由于滥用API将会导致账号在API中封禁，但并不影响在官方网站上的使用，封禁一定的时间后会自动解除，一般需要一个小时后才会解封，所以请小心操作，不要拿API进行大量测试。4、请求地址：

请求的地址为 https:/// 开头的地址，基于SSL安全传输。为了安全必须用https开头的地址，否则将有可能被封禁。

5、请求方法：

只支持POST方法请求数据，用其它方法会提示相关错误。

6、关于编码：

请用UTF-8编码进行数据传输，返回的数据也是UTF-8编码的。

7、关于UserAgent:

请求的时候必须设置UserAgent，如果不设置或者设置为不合法的（比如设置为浏览器的）也会导致账号被封禁API。

UserAgent的格式必须为：程序英文名称/版本 (联系邮箱)

比如：MJJ DDNS Client/1.0.0 (shallwedance@)

8、关于安全：

用户需要输入用户邮箱和密码才能进行下一步的操作，如果需要在客户端上或数据库中保存用户的信息，必须加密后保存，不得明文保存在文件中。

9、技术支持：

请登录论坛 提问。

最近更新

2012-08-24

删除Monitor.Getstatis接口

删除Monitor.Getstatus接口

2012-07-27

　　增加D令牌验证相关的说明

2012-05-07

获取记录列表接口增加按子域名(sub_domain)获取记录

增加接口

增加接口

2012-03-22

　　增加设置域名搜索引擎推送接口

　　增加设置域名启用国内URL转发接口

2012-03-14

　　User.Detail接口增加了nick 返回，意为用户称呼

　　User.Modify接口增加了 nick 参数，意为用户称呼

2012-03-09

　　添加和修改宕机监控接口增加了 less_notice 参数

　　获取警告信息接口增加了 switch_log 返回

2012-02-24

　　增加了宕机监控相关的API

公共参数

所有的接口都需要这些参数，在此统一说明，下面的接口将不再列出。这些参数必须和接口参数一起提交。 login_email 用户帐号，必选

login_password 用户密码，必选

format {json,xml} 返回的数据格式，可选，默认为xml，建议用json

lang {en,cn} 返回的错误语言，可选，默认为en，建议用cn

error_on_empty {yes,no} 没有数据时是否返回错误，可选，默认为yes，建议用no user_id 用户的ID，可选，仅代理接口需要， 用户接口不需要提交此参数

D令牌验证相关

对于已经开启D令牌的用户，在请求API时需要增加如下两个参数：

login_code D令牌生成的随机验证码，必选

login_remember {yes,no} 是否记住验证码，可选，默认为yes

说明：由于D令牌的随机码每30秒变换一次，所以建议用户在第一次请求API的时候选择记住验证码。选择记住验证码后，除了返回所请求的数据以外，还会发一个名为't' + user_id 的cookie，形如：t123456，该cookie的有效期为1个月，以后再请求API可以带上这个cookie，而无须再提交login_code和login_remember参数。

D令牌相关的响应代码：

50 您开启了D令牌，需要验证码51 没有开启D令牌52 验证码不正确53 您已经开启了D令牌54 域名所有者开启了D令牌，您也需要开启D令牌才能管理该域名

共通返回

这些返回在所有的接口都有可能返回，它们是所有接口共通的，在此统一说明，下面的接口将不再列出。 -1 登陆失败

-2 API使用超出限制

-3 不是合法代理 (仅用于代理接口)

-4 不在代理名下 (仅用于代理接口)

-7 无权使用此接口

-8 登录失败次数过多，账号被暂时封禁

-99 此功能暂停开放，请稍候重试

1 操作成功

2 只允许POST方法

3 未知错误

6 用户ID错误 (仅用于代理接口)

7 用户不在您名下 (仅用于代理接口)

获取API版本号

接口地址:

https:///Info.Version

提交方法:

POST

提交参数：

只需要公共参数，请参考 公共参数 说明

响应代码：

请参考 共通返回 说明

返回参考

XML

<?xml version="1.0" encoding="UTF-8"?>

<dnspod>

<status>

<code>1</code>

<message>3.5</message>

<created_at>2011-10-13 11:13:16</created_at>

</status>

</dnspod>

JSON

{

"status":{

"code":"1",

"message":"3.5",

"created_at":"2011-10-13 11:13:16"

}}

账户相关

获取账户信息

接口地址:

https:///User.Detail

提交方法:

POST

提交参数：

公共参数

响应代码：

共通返回

返回参考

XML

<?xml version="1.0" encoding="UTF-8"?>

<dnspod>

<status>

<code>1</code>

<message><![CDATA[操作已经成功完成]]></message>

<created_at>2012-03-14 17:05:06</created_at>

</status>

<info>

<user>

<id>423255</id>

<email>mjj@</email>

<status>enabled</status>

<email_verified>yes</email_verified>

<telephone_verified>yes</telephone_verified>

<agent_pending></agent_pending>

<real_name><![CDATA[李院长]]></real_name>

<user_type>personal</user_type>

<telephone>15913810101</telephone>

<im>87026417</im>

<nick><![CDATA[李 先生]]></nick>

<balance>423255</balance>

<smsbalance>0</smsbalance>

</user>

<agent>

<user_id>423255</user_id>

<discount>50</discount>

<points>2792</points>

<users>1</ …… 此处隐藏：2231字，全部文档内容请下载后查看。喜欢就下载吧 ……