API 端點與資料落地 (Endpoints & Data Residency)
作為一家領先的國際雲端通訊服務供應商，PaaSoo 在全球多個節點部署了核心基礎架構。為提供您的業務最低的網路通訊延遲，同時確保使用者資料嚴格符合當地的法規遵循與隱私保護法律（如歐盟 GDPR、中國《數據安全法》等），PaaSoo 實行了嚴格的區域隔離與資料落地 (在地化) 機制。
在呼叫 PaaSoo API 時，您必須根據您與 PaaSoo 的簽約主體或註冊的 PaaSoo 實體 (法人)，使用對應的 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 要求的客戶使用。 |
| 中國大陸 (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）進行串接，並附帶您的身分驗證參數。
範例：使用全球區端點 (api.paasoo.com) 呼叫發送簡訊介面
# 請求網址結構: [您的區域 Base URL] + [介面路徑] + [參數]
# 請將 API_KEY 和 API_SECRET 替換為您取得的真實憑證
https://api.paasoo.com/json?key=API_KEY&secret=API_SECRET&from=TEST&to=886912345678&text=This+is+test+sms+from+TEST
提示：在實際開發中，請確保對 URL 中的參數值（如 text 簡訊內容）進行正確的 URL 編碼 (URL Encoding)。如果您的簽約主體屬於其他區域（例如歐洲），只需將上述範例中的 api.paasoo.com 替換為 api.paasoo.eu 即可。
3. 特定產品注意事項 (Product-Specific Notes)
- SMS / MMS：全面支援資料落地與區域隔離。請注意，日本節點 (
api.paasoo.jp) 暫不支援 SMS/MMS 簡訊類服務，若需發送日本當地簡訊，請使用新加坡全球主節點 (api.paasoo.com)。 - Voice (語音服務)：受限於跨國電信業者信令路由架構，語音產品的某些核心控制節點可能統一集中在特定資料中心（如新加坡）。若您對語音產品的媒體串流與資料落地有嚴格的在地化要求，請參考 全球語音 API 或聯繫您的專屬客戶經理。