api
差別
這里會顯示出您選擇的修訂版和當前版本之間的差別。
| 兩側同時換到之前的修訂記錄 前一修訂版 后一修訂版 | 前一修訂版 | ||
|
api [2011/08/04 18:33] refactor |
— (當前版本) | ||
|---|---|---|---|
| 行 1: | 行 1: | ||
| - | ====== 小辣椒動態域名更新API ====== | ||
| - | |||
| - | 通過小辣椒API，您可以很容易開發出動態域名客戶端，或者將動態域名功能集成到自己的設備中。 | ||
| - | |||
| - | 任何小辣椒的賬戶，都可以使用動態域名API，如果您還沒有注冊小辣椒，請[[http:// | ||
| - | |||
| - | |||
| - | ===== 介紹 ===== | ||
| - | |||
| - | * Client的請求應該使用HTTP/ | ||
| - | |||
| - | * Client 和 Server, | ||
| - | |||
| - | * 需要事務處理，Client發送完整的請求，并且解析服務器端的相應，保證域名更新的成功。 | ||
| - | |||
| - | * 如果請求失敗，則需要延時一段時間（推薦1分鐘）進行重試，直到域名更新成功。 | ||
| - | |||
| - | * 更新請求的觸發，有兩種方式： | ||
| - | |||
| - | 事件驅動，客戶端偵聽系統的IP請求變化事件，一旦改變了IP，立即發起更新請求，推薦這種方式，更新沒有延時。 | ||
| - | |||
| - | 定時更新，每隔一定時間，發起更新請求，注意兩次間隔時間不能短于1分鐘（收費用戶不能短于15秒），如果連續3次以上頻繁請求，該域名會被系統自動封堵，返回 abuse 代碼。 | ||
| - | |||
| - | * IP的變化檢測，可以采用 web 方式進行檢測，客戶端可以訪問 http:// | ||
| - | |||
| - | * 使用[[http:// | ||
| - | |||
| - | * User-Agent, 代表客戶端名稱、版本，需要根據設備類型、名稱、特征進行自定義，不要使用示范中的名稱，否則可能被封堵 | ||
| - | |||
| - | |||
| - | ===== 動態域名更新協議 ===== | ||
| - | |||
| - | ==== HTTP請求 ==== | ||
| - | |||
| - | < | ||
| - | GET / | ||
| - | Host: members.3322.org | ||
| - | Authorization: | ||
| - | User-Agent: myclient/ | ||
| - | </ | ||
| - | |||
| - | ==== 參數說明 ==== | ||
| - | |||
| - | * username: | ||
| - | 該參數必選, | ||
| - | |||
| - | * hostname=host.3322.org | ||
| - | 該參數必選, | ||
| - | |||
| - | * myip=ipaddr | ||
| - | 該參數可選, | ||
| - | 這會被服務器檢測到)。如果傳遞的地址格式錯誤，則忽略這個參數，而用服務器檢測 | ||
| - | 到的IP。 | ||
| - | |||
| - | * wildcard=ON|OFF | ||
| - | 該參數可選, | ||
| - | |||
| - | * mx=mailexchanger | ||
| - | 該參數可選, | ||
| - | 不能解析到一個IP，mx記錄會被刪除。 | ||
| - | |||
| - | * backmx=YES|NO | ||
| - | 該參數可選, | ||
| - | 不成功，才會發送到備份郵件服務器上。 | ||
| - | |||
| - | * offline=YES|NO Optional: Yes | ||
| - | 該參數可選, | ||
| - | |||
| - | |||
| - | ==== 返回值 ==== | ||
| - | |||
| - | === 更新成功 === | ||
| - | |||
| - | * good | ||
| - | 成功，IP地址已經成功更新，good 后面會跟著所更新的IP地址 | ||
| - | |||
| - | * nochg | ||
| - | 成功，IP地址和上次請求沒有變化, | ||
| - | |||
| - | |||
| - | === 更新出錯 === | ||
| - | |||
| - | * badauth | ||
| - | 身份認證出錯，請檢查用戶名和密碼, | ||
| - | |||
| - | * badsys | ||
| - | 該域名不是動態域名，可能是其他類型的域名（智能域名、靜態域名、域名轉向、子域名）。 | ||
| - | |||
| - | * badagent | ||
| - | 由于發送大量垃圾數據，客戶端名稱被系統封殺。 | ||
| - | |||
| - | === 參數出錯 === | ||
| - | |||
| - | * notfqdn | ||
| - | 沒有提供域名參數，必須提供一個在小辣椒注冊的動態域名域名。 | ||
| - | |||
| - | * nohost | ||
| - | 域名不存在，請檢查域名是否填寫正確。 | ||
| - | |||
| - | * !donator | ||
| - | 必須是收費用戶，才能使用 offline 離線功能。 | ||
| - | |||
| - | * !yours | ||
| - | 該域名存在，但是不是該用戶所有。 | ||
| - | |||
| - | * !active | ||
| - | 該域名被系統關閉，請聯系小辣椒客服人員。 | ||
| - | |||
| - | * abuse | ||
| - | 該域名由于段時間大量發送更新請求，被系統禁止，請聯系小辣椒客服人員。 | ||
| - | |||
| - | * dnserr | ||
| - | DNS 服務器更新失敗 | ||
api.1312454022.txt.gz · 最后更改: 2011/08/04 18:33 由 refactor
除額外注明的地方外，本維基上的內容按下列許可協議發布： CC Attribution-Noncommercial 4.0 International
