API说明

  1. dnsdun 用户 API 仅限于个人用户使用,使用户能更方便、更灵活的管理自己的域名和记录。
  2. 域名注册商等代理用户请使用代理 API,申请成为代理用户请点击:https://www.dnsdun.cn/Service#/account/agent
  3. 不允许任何第三方使用本 API 获取、操作用户数据,如有类似需求,欢迎联系合作:https://www.dnsdun.cn/About/Aboutus

API开发规范

  1. 关于滥用:
    包括但不限于以下情形都被视为滥用:
    • 短时间内大量添加、删除、修改、刷新域名或者记录,或者设置记录状态。
    • 记录内容没有任何改变的刷新,比如动态DNS中IP没变也请求修改记录。
    • 程序逻辑不严谨、程序死循环等等,可能造成大量无效、重复的请求。
    • 其它没有提到的,但会给系统带来压力的请求行为。

    为了保障您和广大开发者的利益,请您合理使用API,对于任何滥用API的行为,dnsdun有权对此进行封禁,并保留最终解释权。

  2. 禁止登录:

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

  3. 关于封禁:

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

  4. 关于请求:
    • 请求的地址为 https://api.dnsdun.com/ 开头的地址,基于SSL安全传输。为了安全必须用https开头的地址,否则将有可能被封禁。
    • 只支持POST方法请求数据,用其它方法会提示错误。
    • 请用UTF-8编码进行数据传输,返回的数据也是UTF-8编码的。
  5. 技术支持:

接口公共参数

所有的接口都需要这些参数,在此统一说明,下面的接口将不再列出。这些参数必须和接口参数一起提交。
  • format {json,xml} 返回的数据格式,可选,默认为json,建议用json
  • lang {en,cn} 返回的错误语言,可选,默认为en,建议用cn
  • uid 在账户管理点开api设置即可看到自已的uid
  • api_key 在账户管理点开api设置即可设置

共通返回

这些返回在所有的接口都有可能返回,它们是所有接口共通的,在此统一说明,下面的接口将不再列出。另外,文档中的参考返回只列出JSON格式的,XML格式类似,就不再列出了。
  • -1 登陆失败
  • -2 API使用超出限制
  • -3 不是合法代理 (仅用于代理接口)
  • -4 不在代理名下 (仅用于代理接口)
  • -7 无权使用此接口
  • -8 登录失败次数过多,账号被暂时封禁
  • -99 此功能暂停开放,请稍候重试
  • 1 操作成功
  • 2 只允许POST方法
  • 3 未知错误
  • 6 用户ID错误 (仅用于代理接口)
  • 7 用户不在您名下 (仅用于代理接口)

获取API版本号

接口地址:
HTTP请求方式:
  • POST
请求参数:
  • 公共参数
响应代码:
  • 共通返回

示例:

curl -X POST 'https://api.dnsdun.com/?c=info&a=version' -d 'format=json'

返回参考:

  • JSON:

    {
        "status": {
            "code": "1",
            "message": "1.0",
        }
    }
    

內容目录

上一个主题

DNSDun API文档

下一个主题

ɾ??????

本页