API 接口地址与数据驻留
作为一家领先的国际云通讯服务提供商，PaaSoo 在全球多个节点部署了核心基础设施。为了给您的业务提供最低的网络通信延迟，同时确保用户数据严格符合当地的合规与隐私保护法律（如欧盟 GDPR、中国《数据安全法》等），PaaSoo 实行了严格的区域隔离与数据本地驻留机制。
在调用 PaaSoo API 时，您必须根据您与 PaaSoo 的合作主体或注册的 PaaSoo Entity，使用对应的 API 接口地址（Base URL） 发起请求。
1. 全球 API 接口地址映射表
请在下表中找到您业务所在的区域，了解该节点支持的产品服务，并在您的 API 请求中使用推荐的 Base URL。
| 区域 (Region) | API 接口地址 (Base URL) | 支持服务 (Supported Services) | 数据驻留地 (Data Localized) | 适用场景与合规说明 |
|---|---|---|---|---|
| 新加坡 (Global) | https://api.paasoo.com | SMS, MMS, Voice | 是 (新加坡) | 默认/全局主节点。适用全球通用业务，无需满足特定地域数据合规要求的客户。 |
| 欧洲 (Europe) | https://api.paasoo.eu | SMS, MMS, Voice | 是 (爱尔兰) | 欧盟合规节点。数据隔离存储于欧盟境内，强烈建议有 GDPR 要求的客户使用。 |
| 中国大陆 (Mainland China) | https://api.paasoo.cn | SMS, MMS, Voice | 是 (中国北京) | 中国合规节点。满足中国《数据出境安全评估办法》，境内业务闭环专属。 |
| 印度 (India) | https://api.paasoo.in | SMS, MMS, Voice | 是 (印度孟买) | 印度合规节点。满足印度 TRAI 监管政策及本地数据强制驻留要求。 |
| 中国香港 (Hong Kong) | https://api.paasoo.hk | SMS, MMS, Voice | 是 (中国香港) | 适用亚太及大湾区业务，提供独立的数据存储与隔离环境。 |
| 日本 (Japan) | https://api.paasoo.jp | 仅语音 (Voice Only) | 路由至全球节点 | 接入点优化日本本地语音业务延迟，数据安全与存储由全球主节点统一保障。 |
| 中国台湾 (Taiwan) | https://api.paasoo.com.tw | SMS, MMS, Voice | 路由至全球节点 | 接入点优化台湾本地网络延迟，数据安全与存储由全球主节点统一保障。 |
如何选择适合您的端点？
请务必根据您的数据合规要求与目标用户所在地来选择对应的 API 接口地址。
- 强合规需求：如果您的业务受特定法律管辖（如欧盟 GDPR、中国《数据出境安全评估办法》、印度数据本地化政策），请务必选择对应的本地合规节点，以确保数据在当地闭环存储，不发生跨境传输。
- 全球通用需求：若您的业务没有特定的地域数据驻留限制，建议使用默认的新加坡 (Global) 主节点，以获得最佳的全球网络连通性。
2. 如何在代码中使用
在查阅本 API 文档的具体接口规范（如“发送短信 API”）时，您需要将选择好的 API 接口地址（Base URL）与具体的接口路径（例如返回 JSON 格式的 /json）进行拼接，并附带您的身份认证参数。
示例：使用中国区 Endpoint (api.paasoo.cn) 调用发送短信接口
# 请求地址构成: [您的区域 Base URL] + [接口路径] + [参数]
# 请将 API_KEY 和 API_SECRET 替换为您获取的真实凭证
https://api.paasoo.cn/json?key=API_KEY&secret=API_SECRET&from=TEST&to=8618911111111&text=This+is+test+from+TEST
提示：在实际开发中，请确保对 URL 中的参数值（如 text 短信内容）进行正确的 URL 编码 (URL Encoding)。如果您的合作主体属于其他区域（例如欧洲），只需将上述示例中的 api.paasoo.cn 替换为 api.paasoo.eu 即可。
3. 特定产品的注意事项 (Product-Specific Notes)
- SMS / MMS：全面支持数据本地化驻留与区域隔离。请注意，日本节点 (
api.paasoo.jp) 暂不支持 SMS/MMS 消息类服务，若需发送日本本地短信，请使用新加坡全局主节点 (api.paasoo.com)。 - Voice (语音服务)：受限于跨国运营商信令路由架构，Voice 产品的某些核心控制节点可能统一集中在特定数据中心（如新加坡）。如果您对 Voice 产品的媒体流与数据驻留有严格的本地化要求，请参考 全球语音 API 或联系您的专属客户经理。
技术支持
如在 API 对接过程中遇到任何技术问题或业务疑问，欢迎随时联系我们的开发者支持团队：support@paasoo.com。我们将竭诚为您提供技术协助。