CTICloud 地域说明

快速阅读

用 enterpriseId 判断企业落在哪个平台区域，并核对 OpenAPI 应使用的 region。

• enterpriseId 固定 7 位数字，以 7 开头。不同前缀对应不同平台序列。
• 已确认平台：AWS2、ALI1、HW3、HS4、ALI5、AWS6。地理位置包括北京、上海、柔佛（海外）。
• OpenAPI 地址中的 {region} 当前取值是 1、2、5、6。它和企业编号前缀不是同一套数字。
• 双云双活是方案型能力，按项目选型落地。本文只记录已确认的平台序列和接入区域，不扩展未确认的全球地域清单。

阅读地图

• 编号规则：读「二」。
• 平台与前缀：读「三」「四」。
• 调接口时怎么填 region：读「五」。
• 签名算法见 鉴权认证。

一、文档说明

本文给实施、运维、研发和客户支持人员一个判断方法：这家企业的 enterpriseId 属于哪一段平台序列，接口应打到哪个接入区域。

本文主要说明已确认的平台、区域、企业编号序列，以及 OpenAPI 地址里的 region。具体企业归属以平台配置和实际数据为准。

二、核心概念

2.1 平台与区域

平台是承载企业呼叫中心服务的运行环境，可能部署在不同云厂商和不同地理位置。

已确认的平台名称：

• AWS2
• ALI1
• HW3
• HS4
• ALI5
• AWS6

已确认的云厂商：AWS、阿里云、华为云、火山引擎。

已确认的地理位置：北京、上海、柔佛（海外）。

这里的「地域」指上述已定义的平台区域，不是公开云产品的全球区域售卖清单。

2.2 企业编号 enterpriseId

enterpriseId 用来识别企业归属，并在查日志、查数据时定位平台。

三、平台与 enterpriseId 序列

四、编号判断方式

可通过 enterpriseId 前缀初步判断企业所属平台。

具体企业归属以平台配置和实际数据为准。

五、OpenAPI 的 region

5.1 请求地址

https://api-{region}.cticloud.cn/interface/{version}/{interface}

• {region}：接入区域。当前取值包括：
  • 1：华东 1 区。
  • 2：华北 2 区。
  • 5：华东 5 区。
  • 6：华北 6 区。
• {version}：接口版本号，当前版本为 v10。
• {interface}：具体接口路径，例如 WebCall 接口对应的路径为 webcall。

示例：

https://api-1.cticloud.cn/interface/v10/webcall

{region} 只选择接入地址。企业编号前缀（如 70、71、741）用来判断平台序列，不要把前缀数字直接当成 {region}。

5.2 集成时核对

• 调用前先确认企业的 enterpriseId。
• 根据 enterpriseId 判断企业所属平台，避免跨平台查询或调用。
• 同时确认该企业应使用的 region id，使请求地址中的 region 与企业归属区域一致。
• 接口域名、签名方式、版本号和区域参数以对应接口文档为准。签名见 鉴权认证。
• 测试环境与生产环境使用各自的 region，更换 region 后重新做联调验收。
• 上线前使用目标企业的真实 enterpriseId 验证接口调用、API 请求日志和事件回调日志。
• 排查接口问题时，同时提供 enterpriseId、请求时间、接口 URI、客户端 IP 和返回结果。

六、常见问题

看到 enterpriseId 就能确定请求地址吗？
前缀可以判断平台序列。OpenAPI 的 {region} 仍要按该企业实际接入区域填写，两套数字不要互相替代。

同一城市为什么有多个平台？
北京、上海都可以对应多条平台序列，例如 AWS2 与 AWS6 都在 AWS 北京，ALI1 与 ALI5 都在阿里云上海。以 enterpriseId 前缀区分。

双云双活在本页怎么用？
双云双活按项目选型落地。本页用来确认企业当前所在的平台区域，不把双云双活写成默认开通。