概要
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 をクライアント側（アプリやフロントエンドのウェブページなど）にハードコーディングしたり、公開コードリポジトリにコミットしたりしないでください。
- 環境の分離：サーバー側の検証や IPホワイトリスト などのセキュリティポリシーと組み合わせて、悪意のある不正利用を防ぐことをお勧めします。
- 暗号化通信：キーの漏洩を防ぐため、リクエストは必ず HTTPS を通じて暗号化して送信してください。
2. Sender ID
Sender ID（つまり送信者）とは、受信者の端末デバイスに表示される送信者名のことです。一般的な形式は以下の通りです：
- 数字形式：標準的な E.164 形式の電話番号（例：
+819012345678）。 - 英数字形式 (Alphanumeric)：文字と数字を含むカスタム文字列（例：
MyPromo123）。
PaaSoo プラットフォームは最大 20文字 の Sender ID をサポートしています。API を使用してカスタム Sender ID を渡す場合（通常は from パラメータを使用します）、以下の点にご注意ください：
- URL エンコード：Sender ID に特殊文字やスペースが含まれる場合は、パラメータを渡す前に必ず URL エンコード (UTF-8) を行ってください。
- コンプライアンスと制限：国や地域によって通信事業者の Sender ID に対する規制ポリシーは大きく異なります。一部の国では動的なカスタム Sender ID をサポートしていますが、一部の国では現地の通信事業者に事前に登録および報告してからでないと使用できないよう厳格に要求されています。
- 表示の保証：各地域の通信事業者のポリシー制限により、PaaSoo は
fromパラメータで渡されたカスタム文字列がすべてのターゲット国/地域で期待通りに表示されることを保証できません。特定の市場での Sender ID のニーズ（専用 Sender ID の登録など）がある場合は、専任のアカウントマネージャーまたはテクニカルサポートチームにお問い合わせください。
API 連携の過程で技術的な問題やビジネスに関する疑問が生じた場合は、いつでも当社の開発者サポートチーム（support@paasoo.com）までご連絡ください。誠心誠意、技術的なサポートを提供いたします。