在 Amazon Pinpoint 中验证 OTP 消息 - Amazon Pinpoint
VerifyOtpMessage 响应

终止支持通知： AWS 将于 2026 年 10 月 30 日终止对亚马逊 Pinpoint 的支持。2026 年 10 月 30 日之后，您将无法再访问亚马逊 Pinpoint 控制台或亚马逊 Pinpoint 资源（终端节点、区段、活动、旅程和分析）。有关更多信息，请参阅 Amazon Pinpoint 终止支持。注意： APIs 与短信相关、语音、移动推送、OTP 和电话号码验证不受此更改的影响，并受 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。

  • 用 OTP 代码发送到的电话号码替换+12065550007。DestinationIdentity

  • ReferenceId替SampleReferenceId换为请求的唯一参考编号。该值必须与发送请求时使用的 ReferenceID 相匹配。

  • 01234用Otp发送到的 Otp 替换。DestinationIdentity

VerifyOtpMessage 响应

当您向 VerifyOTPMessage API 发送请求时，它会返回一个 VerificationResponse 对象，其中包含单个属性 Valid。如果参考 ID 、电话号码和 OTP 都与 Amazon Pinpoint 预期的值相匹配，并且 OTP 没有过期，则 Valid 的值为 true；否则为 false。以下是 OTP 验证成功响应的示例：

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