驗證 Amazon Pinpoint 中的 OTP 訊息 - Amazon Pinpoint

支援終止通知: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

針對上述命令執行以下事項:

  • 以您的應用程式 ID 取代 7353f53e6885409fa32d07cedexample

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

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

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

VerifyOtpMessage 回應

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

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