站点操作API

说明:

  1. cdnbest 用户 API 仅限于个人用户使用,使用户能更方便、更灵活的管理自己的域名和记录。
  2. 不允许任何第三方使用本 API 获取、操作用户数据,如有类似需求,欢迎联系合作:https://www.cdnbest.com

API开发规范

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

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

  2. 禁止登录:

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

  3. 关于封禁:

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

  4. 关于请求:
    • 请求的地址为 https://www.cdnbest.com/api2/ 开头的地址,基于SSL安全传输。为了安全必须用https开头的地址,否则将有可能被封禁。
    • 请用UTF-8编码进行数据传输,返回的数据也是UTF-8编码的。
  5. 技术支持:
    • 帮助中心:https://support.cdnbest.com/

本API文档变量说明:

  • api的域名以及目录,如官网为https://www.cdnbest.com/api2/site/index.php/,后续的子api会为api_dir代替

    例如: 子api写的路由为{api_dir}/site/info,那么该api的请求地址为https://www.cdnbest.com/api2/site/index.php/site/info

API调用顺序:
  • 必需先调用/token路由功能,拿到token(一段字符串),后续的其他具体操作都要将拿到的token传递,

API调用公共参数(post):

  • uid int 用户uid
  • token string 调用/token得到的token
  • vhost string 要操作的站点账号

API返回数据格式:

  • API数据返回格式全部为json格式。
怎么判断api请求成功:
  • 只要json解析返回数据后判断status.code == 1即可

上一个主题

CdnBest API文档

下一个主题

站点API

本页