這里會顯示出您選擇的修訂版和當前版本之間的差別。
兩側同時換到之前的修訂記錄 前一修訂版 后一修訂版 | 前一修訂版 | ||
幫助:api [2011/10/23 13:42] 756489530 [介紹] |
幫助:api [2013/03/04 13:22] (當前版本) refactor [設備認證] |
||
---|---|---|---|
行 1: | 行 1: | ||
- | 大家好是傳奇小子? | + | ====== 公云(3322)動態域名更新API ======? |
- | 認為俄警方三大困境的快樂感豆腐干地方大風過后島谷科技豆腐干空間的風華高科都是符合公司的拉法基惡魔看了他的發揮viodfmtgiogb看vbg才vbgcbh煩得很讓他富豪彼此vhbfthg斯蒂芬韓國法規匯編 | + | ? |
+ | 通過公云API,您可以很容易開發出動態域名客戶端,或者將動態域名功能集成到自己的設備中。? | ||
+ | ? | ||
+ | 任何公云的賬戶,都可以使用動態域名API,如果您還沒有注冊公云,請[[http:// | ||
+ | ? | ||
+ | ===== 介紹 =====? | ||
+ | ? | ||
+ | * Client的請求應該使用HTTP/ | ||
+ | ? | ||
+ | * Client 和 Server, | ||
+ | ? | ||
+ | * 需要事務處理,Client發送完整的請求,并且解析服務器端的相應,保證域名更新的成功。? | ||
+ | ? | ||
+ | * 如果請求失敗,則需要延時一段時間(推薦1分鐘)進行重試,直到域名更新成功。? | ||
+ | ? | ||
+ | * 更新請求的觸發,有兩種方式:? | ||
+ | ? | ||
+ | 事件驅動,客戶端偵聽系統的IP請求變化事件,一旦改變了IP,立即發起更新請求,推薦這種方式,更新沒有延時。? | ||
+ | ? | ||
+ | 定時更新,每隔一定時間,發起更新請求,注意兩次間隔時間不能短于1分鐘(收費用戶不能短于15秒),如果連續3次以上頻繁請求,該域名會被系統自動封堵,返回 abuse 代碼。? | ||
+ | ? | ||
+ | * IP的變化檢測,可以采用 web 方式進行檢測,客戶端可以訪問 http:// | ||
+ | ? | ||
+ | * 使用[[http:// | ||
+ | ? | ||
+ | * User-Agent, 代表客戶端名稱、版本,需要根據設備類型、名稱、特征進行自定義,一般包括設備的廠家、型號、firmware版本號。請不要使用示范中的名稱,否則可能被封堵。? | ||
+ | ? | ||
===== 動態域名更新接口 ===== | ===== 動態域名更新接口 ===== | ||
行 47: | 行 74: | ||
該參數可選, | 該參數可選, | ||
+ | ==== HTTP狀態返回碼 ==== | ||
+ | HTTP狀態返回碼為200、4XX、5XX,其中4XX表示認證錯誤,500表示服務器內部出錯,200表示正常請求。但是動態域名客戶端 | ||
+ | 請忽略HTTP返回碼,而是對下面的返回值進行解析。比如返回值" | ||
==== 返回值 ==== | ==== 返回值 ==== | ||
行 73: | 行 103: | ||
* notfqdn | * notfqdn | ||
- | 沒有提供域名參數,必須提供一個在小辣椒注冊的動態域名域名。 | + | 沒有提供域名參數,必須提供一個在公云注冊的動態域名域名。 |
* nohost | * nohost | ||
行 85: | 行 115: | ||
* !active | * !active | ||
- | 該域名被系統關閉,請聯系小辣椒客服人員。 | + | 該域名被系統關閉,請聯系公云客服人員。 |
* abuse | * abuse | ||
- | 該域名由于段時間大量發送更新請求,被系統禁止,請聯系小辣椒客服人員。 | + | 該域名由于段時間大量發送更新請求,被系統禁止,請聯系公云客服人員。? |
+ | ? | ||
+ | === 服務器出錯 === | ||
* dnserr | * dnserr | ||
- | DNS 服務器更新失敗 | + | DNS 服務器更新失敗。 |
+ | * interror | ||
+ | 服務器內部嚴重錯誤,比如數據庫出錯或者DNS服務器出錯。 | ||
===== 獲取IP接口 ===== | ===== 獲取IP接口 ===== | ||
行 129: | 行 163: | ||
- | 小辣椒動態域名更新API簡單易用,方便了開發者和集成商開發自己的客戶端,給設備增加動態域名功能。 | + | 公云(3322)動態域名更新API簡單易用,方便了開發者和集成商開發自己的客戶端,給設備增加動態域名功能。 |
但是如果對客戶端的理解不深入,會產生一些錯誤或者更新失敗,導致動態域名更新失敗,用戶無法通過域名訪問設備。 | 但是如果對客戶端的理解不深入,會產生一些錯誤或者更新失敗,導致動態域名更新失敗,用戶無法通過域名訪問設備。 | ||
- | 小辣椒為了規范域名的更新流程,保障設備的正常工作,對市場上使用小辣椒動態域名更新API的設備進行認證: | + | 公云為了規范域名的更新流程,保障設備的正常工作,對市場上使用公云動態域名更新API的設備進行認證: |
- | * 由小辣椒的工程師,對設備進行認真,全面的測試,保證設備能夠在各種網絡條件、各種異常條件下正常更新域名? | + | * 由公云的工程師,對設備進行認真,全面的測試,保證設備能夠在各種網絡條件、各種異常條件下正常更新域名? |
- | * 提供認證的設備清單,推薦小辣椒的廣大用戶選用 | + | * 提供認證的設備清單,推薦公云的廣大用戶選用 |
設備認證的具體方法,請參見[[幫助: | 設備認證的具體方法,請參見[[幫助: |