Convalida dei messaggi OTP in Amazon Pinpoint - Amazon Pinpoint
Risposta VerifyOtpMessage

Avviso di fine del supporto: il 30 ottobre 2026, AWS terminerà il supporto per Amazon Pinpoint. Dopo il 30 ottobre 2026, non potrai più accedere alla console Amazon Pinpoint o alle risorse Amazon Pinpoint (endpoint, segmenti, campagne, percorsi e analisi). Per ulteriori informazioni, consulta la pagina relativa alla fine del supporto di Amazon Pinpoint. Nota: per quanto APIs riguarda gli SMS, i comandi vocali, i messaggi push su dispositivi mobili, l'OTP e la convalida del numero di telefono non sono interessati da questa modifica e sono supportati da AWS End User Messaging.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Convalida dei messaggi OTP in Amazon Pinpoint

Dopo aver inviato un one-time-password, l'applicazione può chiamare l'API Amazon Pinpoint per verificarlo. Per verificare un codice OTP, chiama l'API VerifyOtpMessages. La richiesta deve includere i seguenti parametri:

  • DestinationIdentity: numero di telefono, nel formato E.164, al quale è stato inviato il codice OTP.

  • ReferenceId: ID di riferimento usato quando hai inviato il codice OTP al destinatario. L'ID di riferimento deve corrispondere esattamente.

  • Otp: codice OTP che stai convalidando.

Puoi utilizzare il AWS CLI per testare il processo di convalida. Per ulteriori informazioni sull'installazione e la configurazione di AWS CLI, consulta la Guida per l'AWS Command Line Interface utente.

Per verificare una OTP utilizzando il AWS CLI, esegui il verify-otp-messagecomando nel terminale:

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

Nel comando precedente, procedi come segue.

  • 7353f53e6885409fa32d07cedexampleSostituiscilo con l'ID dell'applicazione.

  • +12065550007DestinationIdentitySostituiscilo con il numero di telefono a cui è stato inviato il codice OTP.

  • SampleReferenceIdReferenceIdSostituiscilo con un ID di riferimento univoco per la richiesta. Questo valore deve corrispondere a ReferenceID quello utilizzato per inviare la richiesta.

  • 01234Sostituiscilo Otp con un Otp inviato a. DestinationIdentity

Risposta VerifyOtpMessage

Quando invii una richiesta all'API VerifyOTPMessage, viene restituito un oggetto VerificationResponse contenente un'unica proprietà (Valid). Se l'ID di riferimento, il numero di telefono e il codice OTP corrispondono tutti ai valori previsti da Amazon Pinpoint e se il codice OTP non è scaduto, il valore Valid è true. In caso contrario, è false. Di seguito è riportato un esempio di risposta per una verifica riuscita del codice OTP.

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