这是本文档旧的修订版!
通过小辣椒API,您可以很容易开发出动态域名客户端,或者将动态域名功能集成到自己的设备中。
任何小辣椒的账户,都可以使用动态域名API,如果您还没有注册小辣椒,请点此注册。
事件驱动,客户端侦听系统的IP请求变化事件,一旦改变了IP,立即发起更新请求,推荐这种方式,更新没有延时。
定时更新,每隔一定时间,发起更新请求,注意两次间隔时间不能短于1分钟(收费用户不能短于15秒),如果连续3次以上频繁请求,该域名会被系统自动封堵,返回 abuse 代码。
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 me@null.net
该参数必选, 用户名和密码用来进行身份认证,必须使用 base64进行编码
该参数必选, 需要更新的域名
该参数可选, 域名对应的IP。如果不指定,则服务器将选择最佳的IP(一些Proxy会传递客户端的IP, 这会被服务器检测到)。如果传递的地址格式错误,则忽略这个参数,而用服务器检测 到的IP。
该参数可选, 该参数可选,是否支持泛域名(通配符),缺省为OFF。ON意为着 *.host.3322.org等同于host.3322.org
该参数可选, 指明Mail eXchanger。必须能够解析到一个IP,否则被忽略。如果不提供该参数或者 不能解析到一个IP,mx记录会被删除。
该参数可选, 指明前面的mx参数会被设置成备份邮件服务器,即邮件会首先发送到你的机器上,如果 不成功,才会发送到备份邮件服务器上。
该参数可选, 使域名暂时失效。
成功,IP地址已经成功更新,good 后面会跟着所更新的IP地址
成功,IP地址和上次请求没有变化, nochg 后面会跟着所请求的IP地址
身份认证出错,请检查用户名和密码, 或者编码方式出错。
该域名不是动态域名,可能是其他类型的域名(智能域名、静态域名、域名转向、子域名)。
由于发送大量垃圾数据,客户端名称被系统封杀。
没有提供域名参数,必须提供一个在小辣椒注册的动态域名域名。
域名不存在,请检查域名是否填写正确。
必须是收费用户,才能使用 offline 离线功能。
该域名存在,但是不是该用户所有。
该域名被系统关闭,请联系小辣椒客服人员。
该域名由于段时间大量发送更新请求,被系统禁止,请联系小辣椒客服人员。
DNS 服务器更新失败
客户端可以通过该接口获取自己的IP,用于客户端检测IP的变化。
注意访问 http://ip.3322.net 的两次间隔时间不能短于1分钟,如果连续3次以上频繁请求,该IP会被系统自动封堵
API URL
http://ip.3322.net
无
客户端的IP地址
小辣椒动态域名更新API简单易用,方便了开发者和集成商开发自己的客户端,给设备增加动态域名功能。
但是如果对客户端的理解不深入,会产生一些错误或者更新失败,导致动态域名更新失败,用户无法通过域名访问设备。
小辣椒为了规范域名的更新流程,保障设备的正常工作,对市场上使用小辣椒动态域名更新API的设备进行认证:
设备认证的具体方法,请参见设备认证