這是本文檔舊的修訂版！

---

小辣椒動態域名更新API

Client的請求應該使用HTTP/1.0以上協議，Server的響應一定為HTTP/1.0

需要事務處理，Client發送完整的請求，并且解析服務器端的相應，保證域名更新的成功

1. 通過URL認證 (所有的在一行) http://username:password@members.3322.org/dyndns/update?system=dyndns&hostname=yourhost.ourdomain.ext&myip=ipaddress&wildcard=OFF&mx=mail.exchanger.ext&backmx=NO&offline=NO

2. HTTP GET 或 HTTP POST 請求

1) dyndns, statdns GET /dyndns/update?system=statdns&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

2) webhop GET /dyndns/update?system=webhop&hostname=yourhost.ourdomain.ext&url=dest_url&title=cloak_title&cloak=cloak HTTP/1.1 Host: members.3322.org Authorization: Basic username:password User-Agent: myclient/1.0 me@null.net

3) subdom GET /dyndns/update?system=subdom&hostname=yourhost.ourdomain.ext&ip1=address1&ip2=address2 HTTP/1.1 Host: members.3322.org Authorization: Basic username:password User-Agent: myclient/1.0 me@null.net

一些參數的注意：

• username:password System:All Optional: No

用戶名和密碼用來進行身份認證，必須使用 base64進行編碼

• User-Agent System:All Optional: No

客戶端名稱、版本，需要根據設備類型、名稱、特征進行自定義，不要使用示范中的名稱，否則可能被封堵

• system=dyndns|statdns|webhop|subdom System:All Optional: Yes

只能使用四者之一，否則出錯。如果沒有這個參數，缺省是dyndns

• hostname=host.3322.org System:All Optional: No

需要更新的域名

• myip=ipaddr System:DynDNS, StatDNS Optional: Yes

域名對應的IP。如果不指定，則服務器將選擇最佳的IP(一些Proxy會傳遞客戶端的IP, 這會被服務器檢測到)。如果傳遞的地址格式錯誤，則忽略這個參數，而用服務器檢測 到的IP。

• wildcard=ON|OFF System:DynDNS, StatDNS Optional: Yes

是否支持泛域名(通配符)，缺省為OFF。ON意為著 *.host.3322.org等同于host.3322.org

• mx=mailexchanger System:DynDNS, StatDNS Optional: Yes

指明Mail eXchanger。必須能夠解析到一個IP，否則被忽略。如果不提供該參數或者 不能解析到一個IP，mx記錄會被刪除。

backmx=YES|NO System:DynDNS, StatDNS Optional: Yes 指明前面的mx參數會被設置成備份郵件服務器，即郵件會首先發送到你的機器上，如果 不成功，才會發送到備份郵件服務器上。

offline=YES|NO System:DynDNS, StatDNS Optional: Yes 使域名暫時失效。

url=dest_url System:WebHop Optional: No webhop指向的URL地址

cloak=YES|NO System:WebHop Optional: Yes 指明webhop時是否使用frame，將轉向的url包裝起來。缺省是YES

title=cloak_title System:WebHop Optional: Yes cloak時，frame的標題。缺省是 “Bentium DynDns System”

ip1=address1 System:SubDom Optional: YES 第一個域名服務器的IP地址，必須是正確的IP。如果不指定，則服務器將選擇最佳的IP (一些Proxy會傳遞客戶端的IP, 這會被服務器檢測到)。如果傳遞的地址格式錯誤， 則忽略這個參數，而用服務器檢測到的IP。

ip2=address2 System:SubDom Optional: YES 第二個域名服務器的IP地址，必須是正確的IP