幫助:api
差別
這里會顯示出您選擇的修訂版和當前版本之間的差別。
| 后一修訂版 | 前一修訂版 | ||
|
幫助:api [2011/08/04 21:37] refactor 創建 |
幫助:api [2013/03/04 13:22] (當前版本) refactor [設備認證] |
||
|---|---|---|---|
| 行 1: | 行 1: | ||
| - | ====== | + | ====== |
| - | 通過小辣椒API，您可以很容易開發出動態域名客戶端，或者將動態域名功能集成到自己的設備中。? | + | 通過公云API，您可以很容易開發出動態域名客戶端，或者將動態域名功能集成到自己的設備中。 |
| - | ? | + | |
| - | 任何小辣椒的賬戶，都可以使用動態域名API，如果您還沒有注冊小辣椒，請[[http:// | + | |
| + | 任何公云的賬戶，都可以使用動態域名API，如果您還沒有注冊公云，請[[http:// | ||
| ===== 介紹 ===== | ===== 介紹 ===== | ||
| 行 22: | 行 21: | ||
| 定時更新，每隔一定時間，發起更新請求，注意兩次間隔時間不能短于1分鐘（收費用戶不能短于15秒），如果連續3次以上頻繁請求，該域名會被系統自動封堵，返回 abuse 代碼。 | 定時更新，每隔一定時間，發起更新請求，注意兩次間隔時間不能短于1分鐘（收費用戶不能短于15秒），如果連續3次以上頻繁請求，該域名會被系統自動封堵，返回 abuse 代碼。 | ||
| - | * IP的變化檢測，可以采用 web 方式進行檢測，客戶端可以訪問 http:// | + | * IP的變化檢測，可以采用 web 方式進行檢測，客戶端可以訪問 http:// |
| * 使用[[http:// | * 使用[[http:// | ||
| - | * User-Agent, 代表客戶端名稱、版本，需要根據設備類型、名稱、特征進行自定義，不要使用示范中的名稱，否則可能被封堵 | + | * User-Agent, 代表客戶端名稱、版本，需要根據設備類型、名稱、特征進行自定義，一般包括設備的廠家、型號、firmware版本號。請不要使用示范中的名稱，否則可能被封堵。 |
| - | ===== 動態域名更新協議 | + | ===== 動態域名更新接口 |
| - | ==== HTTP請求 | + | ==== 接口地址 |
| + | ? | ||
| + | **API URL**? | ||
| + | ? | ||
| + | < | ||
| + | http:// | ||
| + | </ | ||
| + | ? | ||
| + | **HTTP請求** | ||
| < | < | ||
| GET / | GET / | ||
| - | Host: members.3322.org | + | Host: members.3322.net |
| Authorization: | Authorization: | ||
| User-Agent: myclient/ | User-Agent: myclient/ | ||
| 行 67: | 行 74: | ||
| 該參數可選, | 該參數可選, | ||
| + | ==== HTTP狀態返回碼 ==== | ||
| + | HTTP狀態返回碼為200、4XX、5XX，其中4XX表示認證錯誤，500表示服務器內部出錯，200表示正常請求。但是動態域名客戶端 | ||
| + | 請忽略HTTP返回碼，而是對下面的返回值進行解析。比如返回值" | ||
| ==== 返回值 ==== | ==== 返回值 ==== | ||
| 行 93: | 行 103: | ||
| * notfqdn | * notfqdn | ||
| - | 沒有提供域名參數，必須提供一個在小辣椒注冊的動態域名域名。 | + | 沒有提供域名參數，必須提供一個在公云注冊的動態域名域名。 |
| * nohost | * nohost | ||
| 行 105: | 行 115: | ||
| * !active | * !active | ||
| - | 該域名被系統關閉，請聯系小辣椒客服人員。 | + | 該域名被系統關閉，請聯系公云客服人員。 |
| * abuse | * abuse | ||
| - | 該域名由于段時間大量發送更新請求，被系統禁止，請聯系小辣椒客服人員。 | + | 該域名由于段時間大量發送更新請求，被系統禁止，請聯系公云客服人員。? |
| + | ? | ||
| + | === 服務器出錯 === | ||
| * dnserr | * dnserr | ||
| - | DNS 服務器更新失敗 | + | DNS 服務器更新失敗。? |
| + | ? | ||
| + | * interror? | ||
| + | 服務器內部嚴重錯誤，比如數據庫出錯或者DNS服務器出錯。? | ||
| + | ? | ||
| + | ===== 獲取IP接口 =====? | ||
| + | ? | ||
| + | ? | ||
| + | 客戶端可以通過該接口獲取自己的IP，用于客戶端檢測IP的變化。? | ||
| + | ? | ||
| + | 注意訪問 http:// | ||
| + | ? | ||
| + | ? | ||
| + | ==== 接口地址 ====? | ||
| + | ? | ||
| + | **API URL**? | ||
| + | ? | ||
| + | < | ||
| + | http:// | ||
| + | </ | ||
| + | ? | ||
| + | ==== 參數說明 ====? | ||
| + | 無? | ||
| + | ? | ||
| + | ==== 返回值 ====? | ||
| + | ? | ||
| + | 客戶端的IP地址? | ||
| + | ? | ||
| + | ? | ||
| + | ===== 常見問題 =====? | ||
| + | ? | ||
| + | * 沒有對請求做事務處理，沒有檢查服務器的返回值，沒有判斷域名更新是否成功? | ||
| + | * 更新失敗以后，沒有記錄日志，沒有進行延時、重試的過程? | ||
| + | * 請求過于頻繁，導致域名被服務器封殺? | ||
| + | * 客戶端使用實例的名字，沒有根據自己設備的類型、名稱、特征進行自定義? | ||
| + | ? | ||
| + | ? | ||
| + | ===== 設備認證 =====? | ||
| + | ? | ||
| + | ? | ||
| + | 公云(3322)動態域名更新API簡單易用，方便了開發者和集成商開發自己的客戶端，給設備增加動態域名功能。? | ||
| + | ? | ||
| + | 但是如果對客戶端的理解不深入，會產生一些錯誤或者更新失敗，導致動態域名更新失敗，用戶無法通過域名訪問設備。? | ||
| + | ? | ||
| + | 公云為了規范域名的更新流程，保障設備的正常工作，對市場上使用公云動態域名更新API的設備進行認證：? | ||
| + | ? | ||
| + | * 由公云的工程師，對設備進行認真，全面的測試，保證設備能夠在各種網絡條件、各種異常條件下正常更新域名? | ||
| + | * 提供認證的設備清單，推薦公云的廣大用戶選用 | ||
| + | 設備認證的具體方法，請參見[[幫助: | ||
幫助/api.1312465024.txt.gz · 最后更改: 2011/08/04 21:37 由 refactor
除額外注明的地方外，本維基上的內容按下列許可協議發布： CC Attribution-Noncommercial 4.0 International
