跳到主要内容

Server API 域名

您在融云创建应用时，可根据业务所在的环境选择 国内数据中心 或 海外数据中心（参见数据中心）。不同数据中心使用独立的服务端 API 地址。应用服务器在调用 Server API 时必须使用与数据中心对应的 Server API 地址，否则 API 请求将无法正确返回结果。

国内数据中心 API 地址​

融云为国内数据中心的应用提供了两个独立的服务端 API 地址：

  • api.rong-api.com
  • api-b.rong-api.com
注意

建议您实现默认域名与备用域名自动切换的逻辑，尽量避免因单一 CDN 服务商问题，导致访问融云 Server API 受阻，进而影响您业务。

海外数据中心 API 地址​

海外数据中心的应用，请使用对应的服务端 API 地址：

  • 新加坡：api.sg-light-api.com（主）、api-b.sg-light-api.com（备）
  • 新加坡 B：api.sg-b-light-api.com（主）、api-b.sg-b-light-api.com（备）
  • 北美：api.us-light-api.com（主）、api-b.us-light-api.com（备）
  • 沙特：api.sau-light-api.com（主）、api-b.sau-light-api.com（备）
重要
  • 具体域名的调用，请以控制台中的 App Key 页面为准
  • 使用海外数据中心的应用还需要配置客户端 SDK 的数据中心地址。

域名切换​

在使用单一服务端 API 地址时，可能因 CDN 服务商的问题导致访问延迟，从而影响业务的正常运行。因此，我们建议开发者实现以下域名切换逻辑：

  1. 开发者调用融云 Server API 时，需要保存当前使用的域名
  2. 调用过程中，如访问出现超时或不可用时，立即切换至另一备用域名进行访问，同时更新当前使用域名，如此循环，避免对业务造成影响

注意事项​

重要
  • 为避免 App Secret 泄漏等问题，所有 Server API 接口必须通过 App Server 进行调用。切勿通过客户端直接调用 Server API 接口
  • 在调用 Server API 时，建议不要使用 KeepAlive 方式。如有特殊情况需要使用 KeepAlive，建议每条长连接空闲超时小于 55 秒，并且复用次数小于 80 次。建议在一次连接空闲 55 秒或复用 80 次时切换新连接。长期使用同一条连接会导致 API 负载均衡失效，影响故障转移策略