# 保障 REST 服务高可用 (/zh-CN/api-reference/api-ref/console/guarantee-rest)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

为保障 REST 服务的高可用，避免因区域网络故障造成的服务不可用，声网提供切换域名的方案。

:::warning[注意]
声网 RESTful API 仅支持 HTTP 1.1 和 HTTP 2.0 协议。如果使用 HTTPS 连接，请确保使用 TLS 1.0、1.1 或 1.2 版本进行加密通信。使用其他协议版本可能导致连接失败。
:::

## 切换域名操作 [#切换域名操作]

1. 根据你的业务服务器所在地设置主域名：
    - 业务服务器 DNS 地址位于中国大陆时，设置主域名为 `api.sd-rtn.com`。
    - 业务服务器 DNS 地址位于中国大陆以外的国家或地区时，设置主域名为 `api.agora.io`。
2. 当使用主域名发起 RESTful API 请求失败时，使用该域名重试一次。
3. 如果步骤 2 的重试依然失败，使用备用的主域名重试：
    - 如果当前设置的主域名为 `api.sd-rtn.com`，备用的主域名指 `api.agora.io`。
    - 如果当前设置的主域名为 `api.agora.io`，备用的主域名指 `api.sd-rtn.com`。
4. 如果步骤 3 的重试依然失败，使用与当前解析区域相邻的区域域名重试。
    举例说明：假设你的业务服务器位于欧洲，你设置的主域名为 `api.agora.io`，且主域名解析到了德国。德国位于欧洲中部 api-eu-central-1.agora.io，查域名信息表可知，相邻区域为欧洲西部 api-eu-west-1.agora.io 或 api-eu-west-1.sd-rtn.com。因此，出现网络故障且步骤 2、3 的重试失败时，请使用 api-eu-west-1.agora.io 或 api-eu-west-1.sd-rtn.com 域名重试。

## 注意事项 [#注意事项]

- 为避免重试请求过于频繁，超过声网服务所规定的 QPS（每秒请求数），声网建议你使用退避策略。例如，第一次等待 1 秒后重试、第二次等待 3 秒后重试、第三次等待 6 秒后重试。
- 如果是网络问题而非 DNS 解析域名问题导致的请求失败，声网建议你跳过步骤 3，直接进行步骤 4。
- 切换至区域域名前，请确保你使用的业务（例如，云端录制、云信令、频道管理等 REST 服务）在该区域有部署服务。

## 域名信息 [#域名信息]

<DocsTable>
<thead>
<tr>
<th scope="col">主域名</th>
<th scope="col">区域域名</th>
<th scope="col">地理区域</th>
</tr>
</thead>
<tbody>
<tr>
<td rowSpan={8}>api.sd-rtn.com</td>
<td>api-us-west-1.sd-rtn.com</td>
<td>美国西部</td>
</tr>
<tr>
<td>api-us-east-1.sd-rtn.com</td>
<td>美国东部</td>
</tr>
<tr>
<td>api-ap-southeast-1.sd-rtn.com</td>
<td>亚太东南</td>
</tr>
<tr>
<td>api-ap-northeast-1.sd-rtn.com</td>
<td>亚太东北</td>
</tr>
<tr>
<td>api-eu-west-1.sd-rtn.com</td>
<td>欧洲西部</td>
</tr>
<tr>
<td>api-eu-central-1.sd-rtn.com</td>
<td>欧洲中部</td>
</tr>
<tr>
<td>api-cn-east-1.sd-rtn.com</td>
<td>中国华东</td>
</tr>
<tr>
<td>api-cn-north-1.sd-rtn.com</td>
<td>中国华北</td>
</tr>
<tr>
<td rowSpan={8}>api.agora.io</td>
<td>api-us-west-1.agora.io</td>
<td>美国西部</td>
</tr>
<tr>
<td>api-us-east-1.agora.io</td>
<td>美国东部</td>
</tr>
<tr>
<td>api-ap-southeast-1.agora.io</td>
<td>亚太东南</td>
</tr>
<tr>
<td>api-ap-northeast-1.agora.io</td>
<td>亚太东北</td>
</tr>
<tr>
<td>api-eu-west-1.agora.io</td>
<td>欧洲西部</td>
</tr>
<tr>
<td>api-eu-central-1.agora.io</td>
<td>欧洲中部</td>
</tr>
<tr>
<td>api-cn-east-1.agora.io</td>
<td>中国华东</td>
</tr>
<tr>
<td>api-cn-north-1.agora.io</td>
<td>中国华北</td>
</tr>
</tbody>
</DocsTable>