服务IP调度接口

接口能力和应用场景

本接口根据源IP，返回最优和最新的服务调度信息，并同时提供更多的容灾能力。包括以下能力：

1. 获取服务IP列表，允许客户端动态获取服务节点IP。

2. 列出当前所有已启用的域名列表，允许客户端避免无效解析请求。

3. 当某服务节点异常后，允许动态获取最新的服务接入点列表。

术语介绍

调度服务：即本服务调度接口，根据来源IP，返回服务IP及其他服务调度信息。

解析服务：即HTTPDNS解析服务接口，请参见解析服务接口文档。

启动IP：用于首次启动或灾难场景下调用服务调度接口，此IP不提供解析服务。

服务IP：常规场景下用于调用调度服务和解析服务的IP地址。

接入方式

1. 提工单或加入钉钉群35248489申请启动IP列表。

   说明

   启动IP应写死在App中，为保证服务可用性，我们会提供多个启动IP供您接入。

2. 使用启动IP调用调度服务获取服务IP列表。

   说明

   • 调度服务支持HTTP/HTTPS方式访问，请参考下文中验证服务器身份章节来验证服务器身份。

   • 启动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":["203.107.1.33"],"service_ipv6":["64:ff9b::cb6b:121"]}

• 请求url：http://{启动IP_或_服务IP}/{account_id}/ss?n=2EUenAaShVfy&t=1568802250

• sign = hmacMD5("IAmASecret", "2EUenAaShVfy-{"service_ip":["203.107.1.33"],"service_ipv6":["64:ff9b::cb6b:121"]}-1568802250") = 3C74A498A00EEE6C5E7C599B3B882658

• 则响应头中应包含：X-Checksum-HmacMD5：3C74A498A00EEE6C5E7C599B3B882658

返回示例：

请求成功时，HTTP响应的状态码为200，响应结果用JSON格式表示，示例如下：

{
  "service_ip": [
    "203.107.1.33"
  ],
  "service_ipv6": [
    "64:ff9b::cb6b:121"
  ]
}

请求失败时，HTTP响应的状态码为4xx/5xx，同时也返回具体的错误码，响应结果用JSON格式表示，示例如下：

{
  "code": "MissingArgument"
}

状态码说明