跳到主要内容

API 域名

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

重要

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

Server API 域名

国内数据中心 API 地址

即时通讯服务为国内数据中心的应用提供了两个独立的服务端 API 地址:

  • api.rong-api.com
  • api-b.rong-api.com
提示

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

以下 Server API 域名已过时,目前仍然可以使用,但已不推荐使用。

  • api.cn.ronghub.com
  • api-cn.ronghub.com
  • api2-cn.ronghub.com
  • ai-sg.ronghub.com(翻译服务)

海外数据中心 API 地址

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

  • 新加坡:api.sg-light-api.com(主)、api-b.sg-light-api.com(备)
  • 新加坡(企业级):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 (备)

重要

使用海外数据中心的应用还需要配置客户端 SDK 的数据中心地址。详见知识库文档海外数据中心使用指南

域名切换最佳实践

提示

域名切换仅针对使用国内数据中心的应用。

使用单一服务端 API 地址时,可能会因为 CDN 服务商问题,导致访问 Server API 延时,对自身业务造成影响。针对使用国内数据中心的应用,我们提供了两个域名,建议开发者实现默认域名与备用域名的切换逻辑。

  1. 开发者调用即时通讯服务端 API 时,需要保存当前使用的域名。

  2. 调用过程中,如访问出现超时或不可用时,立即切换至另一备用域名进行访问,同时更新当前使用域名,如此循环,避免对业务造成影响。