通過(guò)小辣椒API，您可以很容易開(kāi)發(fā)出動(dòng)態(tài)域名客戶端，或者將動(dòng)態(tài)域名功能集成到自己的設(shè)備中。

任何小辣椒的賬戶，都可以使用動(dòng)態(tài)域名API，如果您還沒(méi)有注冊(cè)小辣椒，請(qǐng)點(diǎn)此注冊(cè)。

• Client的請(qǐng)求應(yīng)該使用HTTP/1.0以上協(xié)議，Server的響應(yīng)一定為HTTP/1.0

• Client 和 Server,通過(guò) HTTP GET 或 HTTP POST 請(qǐng)求進(jìn)行交互。

• 需要事務(wù)處理，Client發(fā)送完整的請(qǐng)求，并且解析服務(wù)器端的相應(yīng)，保證域名更新的成功。

• 如果請(qǐng)求失敗，則需要延時(shí)一段時(shí)間（推薦1分鐘）進(jìn)行重試，直到域名更新成功。

• 更新請(qǐng)求的觸發(fā)，有兩種方式：

事件驅(qū)動(dòng)，客戶端偵聽(tīng)系統(tǒng)的IP請(qǐng)求變化事件，一旦改變了IP，立即發(fā)起更新請(qǐng)求，推薦這種方式，更新沒(méi)有延時(shí)。

定時(shí)更新，每隔一定時(shí)間，發(fā)起更新請(qǐng)求，注意兩次間隔時(shí)間不能短于1分鐘（收費(fèi)用戶不能短于15秒），如果連續(xù)3次以上頻繁請(qǐng)求，該域名會(huì)被系統(tǒng)自動(dòng)封堵，返回 abuse 代碼。

• IP的變化檢測(cè)，可以采用 web 方式進(jìn)行檢測(cè)，客戶端可以訪問(wèn) http://ip.3322.net 獲取自己的IP，兩次請(qǐng)求返回的IP變化了，就發(fā)起更新請(qǐng)求。注意訪問(wèn) http://ip.3322.net 的兩次間隔時(shí)間不能短于1分鐘，如果連續(xù)3次以上頻繁請(qǐng)求，該域名會(huì)被系統(tǒng)自動(dòng)封堵

• 使用HTTP驗(yàn)證作為API的用戶身份驗(yàn)證方式。

• User-Agent, 代表客戶端名稱、版本，需要根據(jù)設(shè)備類型、名稱、特征進(jìn)行自定義，不要使用示范中的名稱，否則可能被封堵

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.org
Authorization: Basic username:password
User-Agent: myclient/1.0 me@null.net

• username:password

該參數(shù)必選, 用戶名和密碼用來(lái)進(jìn)行身份認(rèn)證，必須使用 base64進(jìn)行編碼

• hostname=host.3322.org

該參數(shù)必選, 需要更新的域名

• myip=ipaddr

該參數(shù)可選, 域名對(duì)應(yīng)的IP。如果不指定，則服務(wù)器將選擇最佳的IP(一些Proxy會(huì)傳遞客戶端的IP, 這會(huì)被服務(wù)器檢測(cè)到)。如果傳遞的地址格式錯(cuò)誤，則忽略這個(gè)參數(shù)，而用服務(wù)器檢測(cè) 到的IP。

• wildcard=ON|OFF

該參數(shù)可選, 該參數(shù)可選，是否支持泛域名(通配符)，缺省為OFF。ON意為著 *.host.3322.org等同于host.3322.org

• mx=mailexchanger

該參數(shù)可選, 指明Mail eXchanger。必須能夠解析到一個(gè)IP，否則被忽略。如果不提供該參數(shù)或者 不能解析到一個(gè)IP，mx記錄會(huì)被刪除。

• backmx=YES|NO

該參數(shù)可選, 指明前面的mx參數(shù)會(huì)被設(shè)置成備份郵件服務(wù)器，即郵件會(huì)首先發(fā)送到你的機(jī)器上，如果 不成功，才會(huì)發(fā)送到備份郵件服務(wù)器上。

• offline=YES|NO Optional: Yes

該參數(shù)可選, 使域名暫時(shí)失效。

• good

成功，IP地址已經(jīng)成功更新，good 后面會(huì)跟著所更新的IP地址

• nochg

成功，IP地址和上次請(qǐng)求沒(méi)有變化, nochg 后面會(huì)跟著所請(qǐng)求的IP地址

• badauth

身份認(rèn)證出錯(cuò)，請(qǐng)檢查用戶名和密碼, 或者編碼方式出錯(cuò)。

• badsys

該域名不是動(dòng)態(tài)域名，可能是其他類型的域名（智能域名、靜態(tài)域名、域名轉(zhuǎn)向、子域名）。

• badagent

由于發(fā)送大量垃圾數(shù)據(jù)，客戶端名稱被系統(tǒng)封殺。

• notfqdn

沒(méi)有提供域名參數(shù)，必須提供一個(gè)在小辣椒注冊(cè)的動(dòng)態(tài)域名域名。

• nohost

域名不存在，請(qǐng)檢查域名是否填寫(xiě)正確。

• !donator

必須是收費(fèi)用戶，才能使用 offline 離線功能。

• !yours

該域名存在，但是不是該用戶所有。

• !active

該域名被系統(tǒng)關(guān)閉，請(qǐng)聯(lián)系小辣椒客服人員。

• abuse

該域名由于段時(shí)間大量發(fā)送更新請(qǐng)求，被系統(tǒng)禁止，請(qǐng)聯(lián)系小辣椒客服人員。

• dnserr

DNS 服務(wù)器更新失敗