包括但不限于以下情形都被视为滥用:
* 短时间内大量添加、删除、修改、刷新域名或者记录,或者设置记录状态。 * 记录内容没有任何改变的刷新,比如动态DNS中IP没变也请求修改记录。 * 程序逻辑不严谨、程序死循环等等,可能造成大量无效、重复的请求。 * 其它没有提到的,但会给系统带来压力的请求行为。
为了保障您和广大开发者的利益,请您合理使用API,对于任何滥用API的行为,DNSPod有权对此进行封禁,并保留最终解释权。
如果帐号尝试登录错误次数在5分钟内超过30次则会被禁止登录一个小时,写程序的时候特别是动态客户端的时候必须判断是否登录成功,如果不成功必须马上停止尝试。如果使用动态客户端,在网页上修改了密码后务必到客户端修改,否则将不可用。
由于滥用API将会导致帐号在API中封禁,但并不影响在官方网站上的使用,封禁一定的时间后会自动解除,一般需要一个小时后才会解封,所以请小心操作,不要拿API进行大量测试。
关于请求:
关于UserAgent:
请求的时候必须设置UserAgent,如果不设置或者设置为不合法的(比如设置为浏览器的)也会导致帐号被封禁API。
用户需要输入用户邮箱和密码才能进行下一步的操作,如果需要在客户端上或数据库中保存用户的信息,必须加密后保存,不得明文保存在文件中。
技术支持:
所有的接口都需要这些参数,在此统一说明,下面的接口将不再列出。这些参数必须和接口参数一起提交。
增加 Token 的验证机制,https://support.dnspod.cn/Kb/showarticle/tsid/227/ ,后续新用户将全部使用 Token 来鉴权,具体时间会提前通知,也建议开发者们都采用 Token 来鉴权,不要再使用 “用户名 + 密码” 的方式。
这些返回在所有的接口都有可能返回,它们是所有接口共通的,在此统一说明,下面的接口将不再列出。另外,文档中的参考返回只列出JSON格式的,XML格式类似,就不再列出了。
对于已经开启D令牌的用户,在请求API时需要增加如下两个参数:
说明:由于D令牌的随机码每30秒变换一次,所以建议用户在第一次请求API的时候选择记住验证码。选择记住验证码后,除了返回所请求的数据以外,还会发一个名为’t’ + user_id 的cookie,形如:t123456,该cookie的有效期为1个月,以后再请求API可以带上这个cookie,而无须再提交login_code和login_remember参数。
对于开启了D令牌的用户,某些重要操作可能会返回以下错误码,在此统一说明,下面的接口将不再列出。
接口地址:
https://dnsapi.cn/Info.Version
HTTP请求方式:
POST
请求参数:
公共参数
响应代码:
共通返回
示例:
curl -X POST https://dnsapi.cn/Info.Version -d 'login_email=api@dnspod.com&login_password=password&format=json'
返回参考:
JSON:
{
"status": {
"code": "1",
"message": "4.6",
"created_at": "2012-09-10 11:20:39"
}
}