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