這里會顯示出您選擇的修訂版和當前版本之間的差別。
后一修訂版 | 前一修訂版 | ||
api [2011/08/04 17:08] refactor 創建 |
— (當前版本) | ||
---|---|---|---|
行 1: | 行 1: | ||
- | 小辣椒動態域名更新API | ||
- | |||
- | Client的請求應該使用HTTP/ | ||
- | |||
- | 需要事務處理,Client發送完整的請求,并且解析服務器端的相應,保證域名更新的成功 | ||
- | |||
- | 1. 通過URL認證 (所有的在一行) | ||
- | http:// | ||
- | |||
- | 2. HTTP GET 或 HTTP POST 請求 | ||
- | |||
- | 1) dyndns, statdns | ||
- | GET / | ||
- | Host: members.3322.org | ||
- | Authorization: | ||
- | User-Agent: myclient/ | ||
- | |||
- | 2) webhop | ||
- | GET / | ||
- | Host: members.3322.org | ||
- | Authorization: | ||
- | User-Agent: myclient/ | ||
- | |||
- | 3) subdom | ||
- | GET / | ||
- | Host: members.3322.org | ||
- | Authorization: | ||
- | User-Agent: myclient/ | ||
- | |||
- | 一些參數的注意: | ||
- | * username: | ||
- | 用戶名和密碼用來進行身份認證,必須使用 base64進行編碼 | ||
- | |||
- | * User-Agent | ||
- | 客戶端名稱、版本,需要根據設備類型、名稱、特征進行自定義,不要使用示范中的名稱,否則可能被封堵 | ||
- | |||
- | |||
- | * system=dyndns|statdns|webhop|subdom System: | ||
- | 只能使用四者之一,否則出錯。如果沒有這個參數,缺省是dyndns | ||
- | |||
- | * hostname=host.3322.org System:All Optional: No | ||
- | 需要更新的域名 | ||
- | |||
- | * myip=ipaddr System: | ||
- | 域名對應的IP。如果不指定,則服務器將選擇最佳的IP(一些Proxy會傳遞客戶端的IP, | ||
- | 這會被服務器檢測到)。如果傳遞的地址格式錯誤,則忽略這個參數,而用服務器檢測 | ||
- | 到的IP。 | ||
- | |||
- | * wildcard=ON|OFF System: | ||
- | 是否支持泛域名(通配符),缺省為OFF。ON意為著 *.host.3322.org等同于host.3322.org | ||
- | |||
- | * mx=mailexchanger System: | ||
- | 指明Mail eXchanger。必須能夠解析到一個IP,否則被忽略。如果不提供該參數或者 | ||
- | 不能解析到一個IP,mx記錄會被刪除。 | ||
- | |||
- | backmx=YES|NO | ||
- | 指明前面的mx參數會被設置成備份郵件服務器,即郵件會首先發送到你的機器上,如果 | ||
- | 不成功,才會發送到備份郵件服務器上。 | ||
- | |||
- | offline=YES|NO System: | ||
- | 使域名暫時失效。 | ||
- | |||
- | url=dest_url System: | ||
- | webhop指向的URL地址 | ||
- | |||
- | cloak=YES|NO System: | ||
- | 指明webhop時是否使用frame,將轉向的url包裝起來。缺省是YES | ||
- | |||
- | title=cloak_title System: | ||
- | cloak時,frame的標題。缺省是 " | ||
- | |||
- | ip1=address1 System: | ||
- | 第一個域名服務器的IP地址,必須是正確的IP。如果不指定,則服務器將選擇最佳的IP | ||
- | (一些Proxy會傳遞客戶端的IP, | ||
- | 則忽略這個參數,而用服務器檢測到的IP。 | ||
- | |||
- | ip2=address2 System: | ||
- | 第二個域名服務器的IP地址,必須是正確的IP | ||
- | |||
- | |||