跳至内容
公云(PubYun)wiki
用户工具
注册
登录
站点工具
搜索
工具
显示页面
修订记录
反向链接
最近更改
媒体管理器
网站地图
注册
登录
>
最近更改
媒体管理器
网站地图
您的足迹:
帮助:api
本页面只读。您可以查看源文件,但不能更改它。如果您觉得这是系统错误,请联系管理员。
====== 小辣椒动态域名更新API ====== 通过小辣椒API,您可以很容易开发出动态域名客户端,或者将动态域名功能集成到自己的设备中。 任何小辣椒的账户,都可以使用动态域名API,如果您还没有注册小辣椒,请[[http://www.3322.net/accounts/signup/|点此]]注册。 ===== 介绍 ===== * 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次以上频繁请求,该域名会被系统自动封堵 * 使用[[http://www.ietf.org/rfc/rfc2617.txt|HTTP]]验证作为API的用户身份验证方式。 * User-Agent, 代表客户端名称、版本,需要根据设备类型、名称、特征进行自定义,不要使用示范中的名称,否则可能被封堵 ===== 动态域名更新协议 ===== ==== HTTP请求 ==== <code> 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.org Authorization: Basic username:password User-Agent: myclient/1.0 me@null.net </code> ==== 参数说明 ==== * 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 该参数可选, 使域名暂时失效。 ==== 返回值 ==== === 更新成功 === * good 成功,IP地址已经成功更新,good 后面会跟着所更新的IP地址 * nochg 成功,IP地址和上次请求没有变化, nochg 后面会跟着所请求的IP地址 === 更新出错 === * badauth 身份认证出错,请检查用户名和密码, 或者编码方式出错。 * badsys 该域名不是动态域名,可能是其他类型的域名(智能域名、静态域名、域名转向、子域名)。 * badagent 由于发送大量垃圾数据,客户端名称被系统封杀。 === 参数出错 === * notfqdn 没有提供域名参数,必须提供一个在小辣椒注册的动态域名域名。 * nohost 域名不存在,请检查域名是否填写正确。 * !donator 必须是收费用户,才能使用 offline 离线功能。 * !yours 该域名存在,但是不是该用户所有。 * !active 该域名被系统关闭,请联系小辣椒客服人员。 * abuse 该域名由于段时间大量发送更新请求,被系统禁止,请联系小辣椒客服人员。 * dnserr DNS 服务器更新失败
帮助/api.1312465024.txt.gz
· 最后更改: 2011/08/04 21:37 由
refactor
页面工具
显示页面
修订记录
反向链接
回到顶部