概述
欢迎使用 PaaSoo 云通讯服务 API。
PaaSoo 致力于为全球企业打造稳定、高效的云通信解决方案。我们的 REST API 提供了丰富多样的通信能力，帮助开发者轻松将全球触达服务无缝集成至您的应用程序中，实现快速、高质量且可扩展的全球化通信。
通过 PaaSoo API，您可以自由组合短信 (SMS)、彩信 (MMS)、语音 (Voice) 以及号码状态查询 (Phone Number Lookup) 等功能模块，轻松构建营销推广、验证码分发（OTP）、客户服务等多种业务场景。
所有 REST API 均遵循统一的设计规范，支持 HTTP/HTTPS 请求，采用 JSON 数据格式交互，并使用 UTF-8 编码。
为了保障数据的机密性与安全性，我们强烈建议您在生产环境中使用 HTTPS 协议调用 API，以防数据在传输过程中被窃听或篡改。
本开发者文档按功能模块划分子目录，您可以按需查阅相关接口：
核心概念
在开始接入 API 之前，请先了解以下核心概念：
1. API Key & API Secret
API Key 和 API Secret 是您访问 PaaSoo REST API 的专属凭证，分别由 8 位字母或数字组成。所有 API 请求均依赖此凭证进行身份验证。
您可以在 PaaSoo 控制台获取您的专属密钥对。为保障您的资产与账户安全，请务必遵守以下最佳实践：
- 妥善保管：切勿将 API Secret 硬编码在客户端（如 App、前端网页）或提交至公共代码仓库。
- 环境隔离：建议结合服务端验证、IP 白名单等安全策略，防止恶意盗刷。
- 加密传输：务必通过 HTTPS 加密传输请求，防止密钥泄露。
2. Sender ID
Sender ID（即发件人）是指在接收方终端设备上显示的发信人名称。常见的格式包括：
- 数字格式：标准 E.164 格式的电话号码（例如：
+8618911111111）。 - 字母数字格式 (Alphanumeric)：包含字母与数字的自定义字符串（例如：
MyPromo123）。
PaaSoo 平台最高支持 20 个字符的 Sender ID。在使用 API 传递自定义 Sender ID 时（通常通过 from 参数），请注意以下事项：
- URL 编码：如 Sender ID 包含特殊字符或空格，请务必在传参前对其进行 URL Encode (UTF-8) 编码。
- 合规与限制：不同国家/地区的运营商对 Sender ID 的监管政策差异巨大。部分国家支持动态自定义 Sender ID，而部分国家则严格要求必须向当地运营商预先注册并报备后方可使用。
- 显示保证：由于各地运营商政策限制，PaaSoo 无法保证您在
from参数中传递的自定义字符串能够在所有目标国家/地区按预期显示。如有特定市场的 Sender ID 需求（如注册专属 Sender ID），请联系您的专属客户经理或技术支持团队。
如在 API 对接过程中遇到任何技术问题或业务疑问，欢迎随时联系我们的开发者支持团队：support@paasoo.com。我们将竭诚为您提供技术协助。