Amazon Pinpoint で OTP メッセージを検証する - Amazon Pinpoint
VerifyOtpMessageレスポンス

サポート終了通知: 2026 年 10 月 30 日、 AWS は Amazon Pinpoint のサポートを終了します。2026 年 10 月 30 日を過ぎると、Amazon Pinpoint コンソールまたは Amazon Pinpoint のリソース (エンドポイント、セグメント、キャンペーン、ジャーニー、分析) にアクセスできなくなります。詳細については、「Amazon Pinpoint のサポート終了」を参照してください。注: SMS、音声、モバイルプッシュ、OTP、電話番号の検証に関連する APIs は、この変更の影響を受けず、 AWS エンドユーザーメッセージングでサポートされています。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon Pinpoint で OTP メッセージを検証する

ワンタイムパスワードを送信した後、アプリケーションは Amazon Pinpoint API を呼び出して検証できます。OTP コードを検証するには、VerifyOtpMessages API を呼び出します。リクエストには次のパラメータが含まれます。

  • DestinationIdentity — OTP コードの送信先の電話番号 (E.164形式)。

  • ReferenceId — OTP コードを受信者に送信したときに使用した参照 ID。参照 ID は完全に一致する必要があります。

  • Otp — 認証している OTP コード。

を使用して検証プロセスを AWS CLI テストできます。のインストールと設定の詳細については AWS CLI、 AWS Command Line Interface ユーザーガイドを参照してください。

を使用して OTP を検証するには AWS CLI、ターミナルで verify-otp-message コマンドを実行します。

aws pinpoint verify-otp-message --application-id 7353f53e6885409fa32d07cedexample --verify-otp-message-request-parameters DestinationIdentity=+12065550007,ReferenceId=SampleReferenceId,Otp=01234

上記のコマンドで、次の操作を行います。

  • 7353f53e6885409fa32d07cedexample をアプリケーション ID に置き換えます。

  • DestinationIdentity の +12065550007 を、OTP コードが送信された電話番号に置き換えます。

  • ReferenceId の SampleReferenceId をリクエストの一意のリファレンス ID に置き換えます。この値は、リクエストの送信に使用された ReferenceID と一致する必要があります。

  • Otp の 01234 を、DestinationIdentity に送信された OTP に置き換えます。

VerifyOtpMessageレスポンス

VerifyOTPMessage API にリクエストを送信すると、VerificationResponse オブジェクトが返されます。これには 1 つのプロパティ、Valid が含まれています。参照 ID、電話番号、OTP のすべてが Amazon Pinpoint が期待する値と一致し、OTP が有効期限内であれば、Valid は true となり、それ以外は false となります。以下は、OTP 検証に成功した場合のレスポンスの例です。

{
    "VerificationResponse": {
        "Valid": true
    }
}