HTTPDNS：服務IP調度介面

介面能力和應用情境

本介面根據源IP，返回最優和最新的服務調度資訊，並同時提供更多的容災能力。包括以下能力：

1. 擷取服務IP列表，允許用戶端動態擷取服務節點IP。

2. 列出當前所有已啟用的網域名稱列表，允許用戶端避免無效解析請求。

3. 當某服務節點異常後，允許動態擷取最新的服務存取點列表。

術語介紹

調度服務：即本服務調度介面，根據來源IP，返回服務IP及其他服務調度資訊。

解析服務：即HTTPDNS解析服務介面，請參見解析服務介面文檔。

啟動IP：用於初次開機或災難情境下調用服務調度介面，此IP不提供解析服務。

服務IP：常規情境下用於調用調度服務和解析服務的IP地址。

接入方式

1. 提交工單申請啟動IP列表。

   說明

   啟動IP應寫死在App中，為保證服務可用性，我們會提供多個啟動IP供您接入。

2. 使用啟動IP調用調度服務擷取服務IP列表。

   說明

   • 調度服務支援HTTP(S)方式訪問，請參考下文中驗證伺服器身份章節來驗證伺服器身份。

   • 啟動IP僅可用於調用調度服務，不提供解析服務。

3. 使用服務IP調用解析服務。

4. 必須周期性的使用服務IP調用調度服務來更新服務IP列表，保持服務IP列表的有效性。

   說明

   服務IP同時提供調度服務和解析服務。

   • 建議App冷啟動時進行更新

   • 建議切換網路環境時進行更新

   • 建議每8小時至少更新一次

5. 當所有服務IP不可用時，降級使用啟動IP來調用調度服務，擷取可用的服務IP列表。

6. 當所有啟動IP不可用時，請採用指數退避的方式來進行重試。

   重要

   解析服務返回的服務IP列表，不保證長期有效，可能隨時會發生改變，

介面訪問方式

URL：https://{啟動IP_或_服務IP}/{account_id}/ss

請求方式：GET

選擇性參數說明一：

選擇性參數說明二：

驗證伺服器身份：

• 當您使用HTTPS請求調度服務時，我們會提供主機名稱為203.107.1.1的有效認證（無論使用哪個IP請求），請據此驗證伺服器身份；這需要您手動忽略認證錯誤中的主機名稱錯誤，並手動驗證認證所持主機名稱為203.107.1.1。

• 當您使用HTTP請求調度服務時，由於缺少TLS的安全機制，我們會基於以下參數對響應內容做簽名，並將簽名值放置在回應標頭的X-Checksum-HmacMD欄位中。

調用樣本：

• 假設secretKey為：IAmASecret，隨機數n為：2EUenAaShVfy，目前時間戳1568802250, 響應內容為：{"service_ip":["47.74.222.190"],"service_ipv6":["240b:4000:f10::178"]}

• 請求url：http://{啟動IP_或_服務IP}/{account_id}/ss?n=2EUenAaShVfy&t=1568802250

• sign = hmacMD5("IAmASecret", "2EUenAaShVfy-{"service_ip":["47.74.222.190"],"service_ipv6":["240b:4000:f10::178"]}-1568802250") = 3C74A498A00EEE6C5E7C599B3B882658

• 則回應標頭中應包含：X-Checksum-HmacMD5：3C74A498A00EEE6C5E7C599B3B882658

返回樣本：

請求成功時，HTTP響應的狀態代碼為200，響應結果用JSON格式表示，樣本如下：

{
  "service_ip": [
    "47.74.222.190"
  ],
  "service_ipv6": [
    "240b:4000:f10::178"
  ]
}

請求失敗時，HTTP響應的狀態代碼為4xx/5xx，同時也返回具體的錯誤碼，響應結果用JSON格式表示，樣本如下：

{
  "code": "MissingArgument"
}

狀態代碼說明