公云(3322)动态域名更新API
公云(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=NOHTTP/1.1
Host: members.3322.net
Authorization: Basic username:password
User-Agent: myclient/1.0 me@null.net
参数说明
§ 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参数会被设置成备份邮件服务器,即邮件会首先发送到你的机器上,如果 不成功,才会发送到备份邮件服务器上。
§ offline=YES|NO Optional: Yes
该参数可选, 使域名暂时失效。
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的设备进行认证:
§ 由公云的工程师,对设备进行认真,全面的测试,保证设备能够在各种网络条件、各种异常条件下正常更新域名
§ 提供认证的设备清单,推荐公云的广大用户选用
设备认证的具体方法,请参见设备认证
公云(3322)动态域名更新API相关推荐
- Debian下安装3322动态域名更新程序
Ez-ipupdate 是一个动态域名更新程序,可以更新希网的动态域名. 1.对于动态域名(DYNDNS),service-type参数应该选择 qdns 2.对于静态域名(STATDNS),serv ...
- 3322 动态域名更新 IP 程序补丁
因为使用的是动态 IP,远程访问比较麻烦,所以一般会申请一个 3322 的动态域名,然后通过更新域名对应的 IP 来实现域名访问远程主机的目的. 在 linux 下,3322 的网站提供了用 lynx ...
- DNS云学堂 | 替代传统Windows DNS功能,不得不说的动态域名更新
为满足应用的双活改造和灵活切换的场景,很多企业依靠DNS系统实现应用与IP的解耦.搭建专业的DNS系统,替代传统Windows的DNS功能,成为了企业信息化发展健全的一个必要过程. 与域控结合,组建更 ...
- dnspod每步nat123及3322动态域名同类端口映射域名解析软件对比
首先说明下这三个名词:端口映射.域名解析.动态域名解析. 端口映射 80端口映射或自定义端口映射.可以解决80端口被屏蔽,可以在内网使用直接发布网站应用,可以在内网使用实现外网访问内网应用. 域名解析 ...
- dnspod每步nat123及3322动态域名同类网络辅助软件对比
直接正题,就使用体会对比域名解析/动态域名/动态域名解析/端口映射相关免费软件或平台. dnspod dnspod域名解析.不需要转入域名.URL隐性转发另收费. dnspod动态域名解析.不需要转入 ...
- 使用EJS脚本实现花生壳动态域名更新服务(二)
此博客为9925.org的镜像,登录9925.org可以查看到最新博文. 原文出处:http://ily.so/AV3yQv 在<使用EJS脚本实现花生壳动态域名更新服务(一)>中,我们粗 ...
- 使用EJS脚本实现花生壳动态域名更新服务(一)
此博客为9925.org的镜像,登录9925.org可以查看到最新博文. 原文出处:http://ily.so/FrQBne 花生壳提供了动态域名服务,动态域名可实现几乎实时生效的DNS解析服务,并且 ...
- 3322linux自动更新ip,ubuntu开机自动运行动态域名更新
想在Ubuntu开机自动运行时启动动态域名的更新,于是在网上找设置的方法.开始找到了使用sysn-rc-conf命令来设置自动运行程序.原本以为用它能实现,可是运行后发现它只能对现有的启动项进行设置( ...
- 阿里云ddns,动态域名更新Python脚本,基于Python3,适用于linux
阿里云ddns更新脚本,基于Python3 前提:已经在阿里云注册了一个域名,获得AccessKey ID AccessKey Secret,先添加了一个子域名解析,解析值随便 然后获取这个子域名的r ...
- openwrt折腾记1-DDNS动态域名更新与WIFI定时开关脚本
本来无事,因为刚得知ipv6可以直接访问内部家庭宽带,于是开始试用.移动的第三方公司,运维人员给的答复是IP公网的需要安装专线,ipv6够呛. 0x01使用ipv6拨号 首先通过他的超极用户进入光猫, ...
最新文章
- linux i2c核心,总线与设备驱动,Linux2.6.37 I2C驱动框架分析(一)
- Nat. Commun. | 深度学习探索可编程RNA开关
- lvm创建逻辑卷简单过程
- 贵州发布大数据发展十方面成果
- C#之 VS2008 之 Extension Methods
- python3精要(10)-while,for
- 我用ABAP做过的那些无聊的事情
- 牛顿插值法及其C++实现
- 首个视觉-语言预训练综述来了!
- php将图片导入,php中图片文件的导入,上传与下载
- Linux 基础知识(2)---Linux内核空间内存申请函数kmalloc、kzalloc、vmalloc的区别
- 关于webpack4的14个知识点,童叟无欺
- easyui自定义图标
- 前端特效 - 前置- - 01. 百叶窗
- 可以刻录在cd中的linux,在Linux下刻录CD/DVD
- Team Queue -uva
- flowable-ui(v6.7.2)简单的请假流程审批操作(二)
- python爬取音乐源码_手把手教你使用Python抓取QQ音乐数据(第一弹)
- 洗地机那个牌子好?洗地机品牌排行榜
- CLEARCO Silicone Fluids Grease Compounds
热门文章
- xfs文件系统修复问题
- 信庭嵌入式工作室-ARM应用技术之体系结构应用(下)
- 玩苹果为什么要越狱?
- 在安装Maven检查版本时出现Please set the JAVA_HOME variable in your environment to match the locat
- python正则匹配内网IP
- java 多文字水印_Java如何给Word文档添加多行文字水印
- 《精益创业》读书笔记
- 职友集(www.jobui.com) Lucene Similarity 的排序规则更改了...
- pk 打包文件_【旅行】同样是旅行,为啥中国人喜欢拉行李箱,老外喜欢背大包?附干货:行李打包锦囊...
- NPOI导出Excel2007-xlsx格式文件,用于web时需要注意的问题-XSSFWorkbook处理问题