花生壳http更新协议
2016-03-14 09:44
399 查看
Oray DDNS提供CheckIP的服务,可通过下面地址检测:
http://ddns.oray.com/checkip
所有的更新都基本于标准的HTTP请求发送。
服务器会传回一个返回代码,客户端需要解析。
HTTP端口:80
HTTPS 端口:443
请求支持HTTP和基于SSL的HTTPS协议(HTTPS需要付费用户才能使用)
所有客户端必须发送一个完整的User-Agent文件头,用于区分不同的设备,空值或非法参数将导致请求失败。
适用于浏览器或应用程序(fetch, curl, lwp-request),可以在URL中包含验证信息。
2.原始[b]HTTP GET请求
[/b]
实际的HTTP请求,类似下面的代码。
其中 base-64-authorization 请使用 Base64 加密 username:password 后的字符替换。
请注意必须使用GET请求,POST是不被允许的。
检测IP变化
要确定客户端是否应该更新,它必须有一个可靠的方式来确定当前的IP地址是什么,以便比较最后一次更新的地址。以下有两种方式。直接连接
客户端自行判断并获取其连接到互联网的公网IP地址。网站IP检测
通过网站IP检测的方式,获取当前机器公网IP地址。Oray DDNS提供CheckIP的服务,可通过下面地址检测:
http://ddns.oray.com/checkip
更新协议
当客户端发现IP地址变化或是用户修改设置时,客户端应该进行更新。所有的更新都基本于标准的HTTP请求发送。
服务器会传回一个返回代码,客户端需要解析。
HTTP请求
主机名:ddns.oray.comHTTP端口:80
HTTPS 端口:443
请求支持HTTP和基于SSL的HTTPS协议(HTTPS需要付费用户才能使用)
所有客户端必须发送一个完整的User-Agent文件头,用于区分不同的设备,空值或非法参数将导致请求失败。
例子
1.使用URL验证适用于浏览器或应用程序(fetch, curl, lwp-request),可以在URL中包含验证信息。
http://username:password@ddns.oray.com/ph/update?hostname=yourhostname&myip=ipaddress
2.原始[b]HTTP GET请求
[/b]
实际的HTTP请求,类似下面的代码。
其中 base-64-authorization 请使用 Base64 加密 username:password 后的字符替换。
GET /ph/update?hostname=yourhostname&myip=ipaddress HTTP/1.0 Host: ddns.oray.com Authorization: Basic base-64-authorization User-Agent: Oray
请注意必须使用GET请求,POST是不被允许的。
更新参数
目前仅允许提交以下参数参数 | 说明 |
hostname | 需要更新的域名,此域名必须是开通花生壳服务。多个域名使用,分隔,默认为空,则更新护照下所有激活的域名。例:hostname=test.oray.com,customtest.oray.com |
myip | 需要更新的IP地址,可以不填。如果不指定,则由服务器获取到的IP地址为准。 |
返回代码
代码列表
参数 | 说明 |
good | 更新成功,域名的IP地址已经更新,同时会返回本次更新成功的IP,用空格隔开,如:good 1.2.3.4 |
nochg | 更新成功,但没有改变IP。一般这种情况为本次提交的IP跟上一次的一样 |
notfqdn | 未有激活花生壳的域名 |
nohost | 域名不存在或未激活花生壳 |
nochg | 更新成功,但没有改变IP。一般这种情况为本次提交的IP跟上一次的一样 |
abuse | 请求失败,频繁请求或验证失败时会出现 |
!donator | 表示此功能需要付费用户才能使用,如https |
911 | 系统错误 |
相关文章推荐
- http请求方式有哪些
- jiVMware的网络配置Linux
- 网络应用程序架构
- Android使用Google推荐的联网框架Volley,让连接网络更加简单
- Android利用Fiddler进行网络数据抓包
- TCP四次握手(关闭连接)
- TCP三次握手(建立连接)
- 网络协议复习
- 启用全站HTTPS后不仅更安全而且更快 看淘宝是如何做到的
- HttpClient 向tomcat服务器发送文件
- 厦门巨游网络科技有限公司(HOTPOWER)承接游戏UI外包
- VIEWGOOD(远古)网络电视台视频直播系统
- 15.Linux之网络管理
- 用无线网卡做wifi热点共享网络的方法
- HTTP协议详解
- 网络攻防学习心得一(20159320)学习小结
- iOS的网络配置info.plist
- 网络图片下载设置
- HTTP详解
- 网络攻防学习心得一(20159320)工具学习