HTTP API を直接呼び出すか、公式 SDK を使用して Short Message Service (SMS) をビジネスシステムに統合し、検証コード、通知、マーケティングメッセージをプログラムで送信します。このトピックでは、統合の中核となる概念を説明し、適切なアプローチの選択に役立ちます。
使用上の注意
ショートメッセージサービスは、メッセージの送信とレコードのクエリのための OpenAPI オペレーションを提供します。統合する前に、ショートメッセージサービスの API バージョン、エンドポイント、およびサポートされている呼び出し元 ID を確認してください。
「OpenAPI とは」では、完全な呼び出しフロー、アイデンティティ、認可、および認証情報について説明しています。
バージョンガイド
Alibaba Cloud OpenAPI はバージョン番号を使用して API リストを管理します。SMS の API バージョンは 2018-05-01 です。文字列 2018-05-01 は日付ではなくバージョン識別子です。API は 2018-05-01 の古いものではなく、利用可能な最新バージョンです。
|
API バージョン番号 |
説明 |
|
推奨 |
エンドポイント
エンドポイントは、クラウドサービスの API にアクセスするために使用されるドメイン名です。リソースに最も近いエンドポイントを選択して、レイテンシーを最小限に抑えてください。
シンガポールエンドポイント dysmsapi.ap-southeast-1.aliyuncs.com を使用できます。
利用可能なすべてのエンドポイントは、エンドポイントに記載されています。
サポートされているアイデンティティ
OpenAPI ポータルは、API デバッグのためにデフォルトで Alibaba Cloud アカウントを使用します。このアカウントは完全な API アクセス権を持ち、セキュリティリスクが高いため、API 呼び出しと日々の運用保守には、代わりに Resource Access Management (RAM) ユーザーを使用してください。API 操作を呼び出す前に、各 RAM ユーザーに必要な権限のみを付与してください。
|
ユーザーアイデンティティ |
サポート |
|
対応 |
|
|
RAM ユーザー (推奨) |
対応 |
|
RAM ロール (推奨) |
対応 |
統合方法
OpenAPI 操作の呼び出しには SDK の使用が推奨されます。可能な限り SDK を使用してください。
|
統合方法 |
説明 |
|
Alibaba Cloud SDK (推奨) |
|
|
カスタム API 呼び出し (非推奨) |
ネイティブ HTTP 呼び出しでは、署名アルゴリズムを実装し、リクエストを手動で作成する必要があります。署名メカニズムについては、「V3 リクエストボディと署名メカニズム」に記載されています。 |
関連ドキュメント
-
API 呼び出しでエラーが返された場合は、「API エラーコード」と照らし合わせてリクエストパラメーターを確認してください。
-
応答または SDK のエラーメッセージから RequestID を記録し、「Alibaba Cloud OpenAPI 診断プラットフォーム」を使用して問題を診断してください。
-
「アイデンティティ、認証情報、および認可」では、呼び出し元アイデンティティのタイプ、認証情報、および認可について説明しています。
-
Alibaba Cloud は OpenAPI の呼び出し頻度をスロットリングします。レート制限とクォータについては、「スロットリングとクォータ管理」に記載されています。