必威体育Betway必威体育官网
当前位置:首页 > IT技术

3322.org

时间:2019-10-06 00:43:20来源:IT技术作者:seo实验室小编阅读:73次「手机版」
 

3322

公云(3322)动态域名更新API

通过公云API,您可以很容易开发出动态域名客户端,或者将动态域名功能集成到自己的设备中。

任何公云的账户,都可以使用动态域名API,如果您还没有注册公云,请点此注册。

介绍

  • Client的请求应该使用HTTP/1.0以上协议,Server的响应一定为HTTP/1.0

  • Client 和 Server,通过 HTTP GET 或 HTTP POST 请求进行交互。

  • 需要事务处理,Client发送完整的请求,并且解析服务器端的相应,保证域名更新的成功。

  • 如果请求失败,则需要延时一段时间(推荐1分钟)进行重试,直到域名更新成功。

  • 更新请求的触发,有两种方式:

事件驱动,客户端侦听系统的IP请求变化事件,一旦改变了IP,立即发起更新请求,推荐这种方式,更新没有延时。

定时更新,每隔一定时间,发起更新请求,注意两次间隔时间不能短于1分钟(收费用户不能短于15秒),如果连续3次以上频繁请求,该域名会被系统自动封堵,返回 abuse 代码

  • IP的变化检测,可以采用 web 方式进行检测,客户端可以访问 http://ip.3322.net 获取自己的IP,两次请求返回的IP变化了,就发起更新请求。注意访问 http://ip.3322.net 的两次间隔时间不能短于1分钟,如果连续3次以上频繁请求,该IP会被系统自动封堵

  • 使用HTTP验证作为API的用户身份验证方式。

  • User-Agent, 代表客户端名称、版本,需要根据设备类型、名称、特征进行自定义,一般包括设备的厂家、型号、firmware版本号。请不要使用示范中的名称,否则可能被封堵。

动态域名更新接口

接口地址

API URL

http://members.3322.net/dyndns/update 

HTTP请求

GET /dyndns/update?hostname=yourhost.ourdomain.ext&myip=Ipaddress&wildcard=OFF&mx=mail.exchanger.ext&backmx=NO&offline=NO HTTP/1.1
Host: members.3322.net
authorization: Basic username:password
User-Agent: myclient/1.0 [email protected]

参数说明

  • username:password

该参数必选, 用户名和密码用来进行身份认证,必须使用 base64进行编码

  • hostname=host.3322.org

该参数必选, 需要更新的域名

  • myip=ipaddr

该参数可选, 域名对应的IP。如果不指定,则服务器将选择最佳的IP(一些Proxy会传递客户端的IP,这会被服务器检测到)。如果传递的地址格式错误,则忽略这个参数,而用服务器检测到的IP。

  • wildcard=ON|OFF

该参数可选, 该参数可选,是否支持泛域名(通配符),缺省为OFF。ON意为着 *.host.3322.org等同于host.3322.org

  • mx=mailexchanger

该参数可选, 指明Mail eXchanger。必须能够解析到一个IP,否则被忽略。如果不提供该参数或者不能解析到一个IP,mx记录会被删除。

  • backmx=YES|NO

该参数可选, 指明前面的mx参数会被设置成备份邮件服务器,即邮件会首先发送到你的机器上,如果不成功,才会发送到备份邮件服务器上。

该参数可选, 使域名暂时失效。

HTTP状态返回码

HTTP状态返回码为200、4XX、5XX,其中4XX表示认证错误,500表示服务器内部出错,200表示正常请求。但是动态域名客户端请忽略HTTP返回码,而是对下面的返回值进行解析。比如返回值“intERROR”表示内部出错,这时对应的HTTP状态返回码是500。

返回值

更新成功

  • good

成功,IP地址已经成功更新,good 后面会跟着所更新的IP地址

  • nochg

成功,IP地址和上次请求没有变化, nochg 后面会跟着所请求的IP地址

更新出错

  • badauth

身份认证出错,请检查用户名和密码, 或者编码方式出错。

  • badsys

该域名不是动态域名,可能是其他类型的域名(智能域名、静态域名、域名转向子域名)。

  • badagent

由于发送大量垃圾数据,客户端名称被系统封杀。

参数出错

  • notfqdn

没有提供域名参数,必须提供一个在公云注册的动态域名域名。

  • nohost

域名不存在,请检查域名是否填写正确。

  • !donator

必须是收费用户,才能使用 offline 离线功能。

  • !yours

该域名存在,但是不是该用户所有。

  • !active

该域名被系统关闭,请联系公云客服人员。

  • abuse

该域名由于段时间大量发送更新请求,被系统禁止,请联系公云客服人员。

服务器出错

  • dnserr

DNS 服务器更新失败。

  • interror

服务器内部严重错误,比如数据库出错或者DNS服务器出错。

获取IP接口

客户端可以通过该接口获取自己的IP,用于客户端检测IP的变化。

注意访问 http://ip.3322.net 的两次间隔时间不能短于1分钟,如果连续3次以上频繁请求,该IP会被系统自动封堵

接口地址

API URL

http://ip.3322.net 

参数说明

返回值

客户端的IP地址

常见问题

  • 没有对请求做事务处理,没有检查服务器的返回值,没有判断域名更新是否成功

  • 更新失败以后,没有记录日志,没有进行延时、重试的过程

  • 请求过于频繁,导致域名被服务器封杀

  • 客户端使用实例的名字,没有根据自己设备的类型、名称、特征进行自定义

设备认证

公云(3322)动态域名更新API简单易用,方便了开发者和集成商开发自己的客户端,给设备增加动态域名功能。

但是如果对客户端的理解不深入,会产生一些错误或者更新失败,导致动态域名更新失败,用户无法通过域名访问设备。

公云为了规范域名的更新流程,保障设备的正常工作,对市场上使用公云动态域名更新API的设备进行认证:

  • 由公云的工程师,对设备进行认真,全面的测试,保证设备能够在各种网络条件、各种异常条件下正常更新域名

  • 提供认证的设备清单,推荐公云的广大用户选用

设备认证的具体方法,请参见设备认证

相关阅读

org.apache.jasper.JasperException: 无法编译JSP 集

很是气愤怎么之前写的简单的Javabean的例子老是显示无法编译,而且配置啥的都没问题就是简单的几行代码 就是找不到错。错误显示:org

org.apache.jasper.JasperException: org.apache.jasp

<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>   标签飘红 直接切入主题,网上说了很多解决办法,什么缺少j

互联网域名注册:2018年,.ORG 域名无法备案了

自1月29日最新备案域名列表,没看见org域名啊,难道org域名不能备案了吗?其实从2018年1月起.org域名后缀因管局政策原因已无法进行备

jedis : NoSuchMethodError: org.springframework.uti

org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'connectionFactory' defined in c

org域名是哪里的域名

自1月29日最新备案域名列表,没看见org域名啊,难道org域名不能备案了吗?其实从2018年1月起.org域名后缀因管局政策原因已无法进行备

分享到:

栏目导航

推荐阅读

热门阅读