概述
歡迎使用 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 格式的電話號碼（例如：
+886912345678）。 - 字母數字格式 (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。我們將竭誠為您提供技術協助。