APIエンドポイントとデータレジデンシー
大手グローバルクラウドコミュニケーションプロバイダーであるPaaSooは、世界中の複数のリージョンにコアインフラストラクチャを展開しています。お客様のビジネスに最小限のネットワーク遅延（レイテンシ）を提供すると同時に、現地のデータプライバシー規制（EUのGDPRや中国のデータセキュリティ法など）への厳格な準拠を保証するため、PaaSooは厳格な**リージョン（地域）の分離およびデータのローカル保存（データレジデンシー）**メカニズムを適用しています。
PaaSoo APIを呼び出す際は、お客様が ご契約されたPaaSooの法人（契約主体） に対応する適切な APIエンドポイント（ベースURL） を使用する必要があります。
1. グローバルAPIエンドポイント マッピング表
以下の表からお客様のビジネスリージョンを見つけ、そのノードでサポートされているプロダクトを確認した上で、すべてのAPIリクエストに推奨されるベース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 | はい (アイルランド) | EUコンプライアンス対応ノード。 データはEU圏内で安全に分離・保存されます。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 | はい (中国 香港) | APACおよび大湾区（グレーターベイエリア）のビジネスに最適であり、独立したデータ保存・分離環境を提供します。 |
| 日本 (Japan) | https://api.paasoo.jp | 音声のみ (Voice Only) | グローバルへルーティング | 日本国内の音声（Voice）サービスにおける低遅延に最適化されたアクセスポイント。データのセキュリティと保存はグローバルプライマリノードによって統合管理されます。 |
| 台湾 (Taiwan) | https://api.paasoo.com.tw | SMS, MMS, Voice | グローバルへルーティング | 台湾国内のネットワーク低遅延に最適化されたアクセスポイント。データのセキュリティと保存はグローバルプライマリノードによって統合管理されます。 |
お客様のデータコンプライアンス要件とターゲットユーザーの所在地に基づいて、対応するAPIエンドポイントを選択してください。
- 厳格なコンプライアンス要件：お客様のビジネスが特定の法律（EUのGDPR、中国の「データ越境安全評価弁法」、インドのデータローカリゼーションポリシーなど）の管轄下にある場合は、データが現地でクローズドループで保存され、越境移転が発生しないように、必ず対応するローカルコンプライアンス対応ノードを選択してください。
- グローバルな一般的な要件：特定の地域的なデータ保存（データレジデンシー）の制限がない場合は、最適なグローバルネットワーク接続を実現するために、デフォルトのシンガポール (Global) プライマリノードを使用することをお勧めします。
2. コードでのエンドポイントの使用方法
本APIドキュメントで特定のAPI仕様（例：「SMS送信 API」）を参照する際、選択したAPIベースURLに、特定のAPIパス（JSON形式のレスポンスを返す /json など）と認証パラメータを追加して連結する必要があります。
例：グローバルエンドポイント (api.paasoo.com) を使用してSMS送信APIを呼び出す場合
# リクエストURLの構成: [ご契約リージョンのベースURL] + [APIパス] + [パラメータ]
# API_KEY と API_SECRET は、実際に取得した認証情報に置き換えてください
https://api.paasoo.com/json?key=API_KEY&secret=API_SECRET&from=TEST&to=819011111111&text=This+is+test+from+TEST
ヒント：実際の実装では、URL内のパラメータ値（text のメッセージ内容など）が正しくURLエンコード (URL Encoding) されていることを確認してください。ご契約の法人が別のリージョン（例：ヨーロッパ）に属している場合は、上記の例の api.paasoo.com を api.paasoo.eu に置き換えるだけです。
3. 特定プロダクトに関する注意事項 (Product-Specific Notes)
- SMS / MMS：データのローカル保存およびリージョン間の分離を完全にサポートしています。ただし、日本ノード (
api.paasoo.jp) では現在SMS/MMSメッセージサービスをサポートしていません。日本国内でSMSを送信する場合は、シンガポールのグローバルプライマリノード (api.paasoo.com) を使用してください。 - 音声 API：国際通信キャリアのシグナリングおよびルーティングアーキテクチャの性質上、Voiceプロダクトの一部のコア制御ノードは特定のデータセンター（シンガポールなど）に集約される場合があります。Voiceのメディアストリームやデータの保存拠点に関して厳密なローカライゼーション要件がある場合は、音声 API をご参照いただくか、専任のアカウントマネージャーまでお問い合わせください。
APIの連携中に技術的な問題が発生した場合や、ビジネスに関するご質問がございましたら、弊社の開発者サポートチーム（support@paasoo.com）までお気軽にお問い合わせください。専任スタッフが迅速にサポートいたします。