Valider les messages OTP dans Amazon Pinpoint - Amazon Pinpoint
Réponse de VerifyOtpMessage

Avis de fin de support : le 30 octobre 2026, le support d'Amazon Pinpoint AWS prendra fin. Après le 30 octobre 2026, vous ne pourrez plus accéder à la console Amazon Pinpoint ni aux ressources Amazon Pinpoint (points de terminaison, segments, campagnes, parcours et analytique). Pour plus d’informations, consultez Fin de la prise en charge d’Amazon Pinpoint. Remarque : en ce qui APIs concerne les SMS, la voix, le push mobile, l'OTP et la validation des numéros de téléphone ne sont pas concernés par cette modification et sont pris en charge par AWS la messagerie utilisateur final.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Valider les messages OTP dans Amazon Pinpoint

Après avoir envoyé un one-time-password, votre application peut appeler l'API Amazon Pinpoint pour le vérifier. Pour vérifier un code OTP, appelez l'API VerifyOtpMessages. Votre demande doit inclure les paramètres suivants :

  • DestinationIdentity : le numéro de téléphone au format E.164 auquel le code OTP a été envoyé.

  • ReferenceId : l'ID de référence que vous avez utilisé lorsque vous avez envoyé le code OTP au destinataire. L'ID de référence doit correspondre exactement.

  • Otp : le code OTP que vous êtes en train de valider.

Vous pouvez utiliser le AWS CLI pour tester le processus de validation. Pour plus d'informations sur l'installation et la configuration du AWS CLI, consultez le guide de AWS Command Line Interface l'utilisateur.

Pour vérifier un OTP à l'aide du AWS CLI, exécutez la verify-otp-messagecommande dans le terminal :

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

Dans la commande précédente, procédez comme suit :

  • Remplacez 7353f53e6885409fa32d07cedexample par l'identifiant de votre application.

  • +12065550007Remplacez-le DestinationIdentity par le numéro de téléphone auquel le code OTP a été envoyé.

  • SampleReferenceIdReferenceIdRemplacez-le par un numéro de référence unique pour la demande. Cette valeur doit correspondre à celle ReferenceID qui a été utilisée pour envoyer la demande.

  • 01234OtpRemplacez-le par un Otp envoyé auDestinationIdentity.

Réponse de VerifyOtpMessage

Lorsque vous envoyez une demande à l'API VerifyOTPMessage, celle-ci renvoie un objet VerificationResponse contenant une seule propriété, Valid. Si l'ID de référence, le numéro de téléphone et l'OTP correspondent tous aux valeurs attendues par Amazon Pinpoint, et si l'OTP n'a pas expiré, la valeur de Valid est true ; sinon, elle est false. Voici un exemple de réponse à une vérification OTP réussie :

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