在 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 訊息

傳送one-time-password後，您的應用程式可以呼叫 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。

  • 將 中的 +12065550007 取代DestinationIdentity為傳送 OTP 代碼的電話號碼。

  • 將 中的 SampleReferenceId ReferenceId 取代為請求的唯一參考 ID。此值必須符合ReferenceID用於傳送請求的 。

  • Otp 將 中的 01234 取代為傳送至 的 OtpDestinationIdentity。

VerifyOtpMessage 回應

若向 VerifyOTPMessage API 傳送請求，它會傳回一個包含單一屬性 Valid 的 VerificationResponse 物件。如果參考 ID、電話號碼和 OTP 都與 Amazon Pinpoint 預期的值相符，且 OTP 尚未過期，則 Valid 的值將是 true；否則就是 false。以下是 OTP 驗證成功的回應範例：

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