API di convalida e-mail - Amazon Simple Email Service
Convalida dell'API (console)Convalida dell'API ()AWS CLI

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à.

API di convalida e-mail

La convalida dell'API consente di convalidare singoli indirizzi e-mail tramite chiamate API, fornendo un feedback immediato sulla validità dell'indirizzo, sulla deliverability e sui fattori di rischio. Questa funzionalità è progettata per convalidare gli indirizzi al momento della raccolta, ad esempio durante la registrazione degli utenti, i moduli di iscrizione o in qualsiasi altro scenario in cui siano necessari risultati di convalida tempestivi.

La convalida dell'API esegue più controlli su ciascun indirizzo e-mail, tra cui la convalida della sintassi, la verifica del dominio, i controlli dell'esistenza delle caselle di posta e altri. I risultati della convalida includono verdetti di fiducia (HIGH, MEDIUM o LOW) per la validità complessiva e le valutazioni individuali.

Controlli di convalida eseguiti

La convalida dell'API esegue le seguenti valutazioni su ciascun indirizzo e-mail:

  • Convalida della sintassi ('HasValidSyntax'): verifica che l'indirizzo e-mail segua gli standard RFC appropriati e contenga caratteri validi nel formato corretto.

  • Record DNS ('HasValidDnsRecords'): verifica che il dominio esista, disponga di record DNS validi e sia configurato per ricevere e-mail.

  • Mailbox Existence ('MailboxExists'): verifica che la casella di posta esista e possa ricevere messaggi senza inviare effettivamente un'e-mail.

  • Indirizzo del ruolo ('IsRoleAddress'): identifica gli indirizzi basati sui ruoli (come admin@, support@ o info@) che potrebbero avere tassi di coinvolgimento inferiori.

  • Dominio usa e getta ('IsDisposable'): verifica gli indirizzi e-mail usa e getta o temporanei che potrebbero influire negativamente sulla reputazione del mittente.

  • Schemi di stringhe casuali ('IsRandomInput'): verifica i modelli generati casualmente.

Utilizzo della convalida delle API con la console Amazon SES

La procedura seguente mostra come convalidare un indirizzo e-mail utilizzando la console Amazon SES.

Per convalidare un indirizzo e-mail utilizzando la console Amazon SES

  1. Accedi a Console di gestione AWS e apri la console Amazon SES all'indirizzo https://console.aws.amazon.com/ses/.

  2. Nel riquadro di navigazione a sinistra, scegli Convalida degli indirizzi e-mail in Convalida e-mail.

  3. Nella sezione Convalida indirizzo e-mail, inserisci l'indirizzo e-mail che desideri convalidare nel campo Indirizzo e-mail.

  4. Scegli Convalida.

    I risultati della convalida vengono visualizzati nel pannello dei risultati della convalida e mostrano:

    • IsValid— Validità complessiva con un verdetto di fiducia (ALTO, MEDIO o BASSO).

    • Valutazioni: risultati di valutazione individuali con verdetti di affidabilità relativi alla sintassi, ai record DNS, all'esistenza delle caselle di posta e ai fattori di rischio sopra elencati.

Utilizzo della convalida delle API con AWS CLI

Gli esempi seguenti mostrano come convalidare gli indirizzi e-mail utilizzando. AWS CLI

Per convalidare un indirizzo e-mail utilizzando il AWS CLI

Puoi utilizzare l'GetEmailAddressInsightsoperazione nell'API Amazon SES v2 per convalidare gli indirizzi e-mail. È possibile richiamare questa operazione da AWS CLI, come illustrato negli esempi seguenti.

  • Convalida un singolo indirizzo e-mail:

    aws --region us-east-1 sesv2 get-email-address-insights --email-address user@example.com

  • La risposta dovrebbe essere simile a questa:

    {
    "MailboxValidation": {
        "IsValid": {
            "ConfidenceVerdict": "HIGH"
        },
        "Evaluations": {
            "HasValidSyntax": {
                "ConfidenceVerdict": "HIGH"
            },
            "HasValidDnsRecords": {
                "ConfidenceVerdict": "MEDIUM"
            },
            "MailboxExists": {
                "ConfidenceVerdict": "MEDIUM"
            },
            "IsRoleAddress": {
                "ConfidenceVerdict": "LOW"
            },
            "IsDisposable": {
                "ConfidenceVerdict": "LOW"
            },
            "IsRandomInput": {
                "ConfidenceVerdict": "LOW"
            }
        }
    }
}

  • Per ulteriori informazioni sui valori di risposta e sui tipi di dati, consulta il tipo di MailboxValidationdati nel riferimento all'API Amazon SES v2.

  • Assicurati che la tua identità IAM disponga delle autorizzazioni necessarie per le chiamate all'API Email Validation e CloudWatch la pubblicazione dei parametri:

    {
  "Version": "2012-10-17		 	 	 ",
  "Statement": [
    {
      "Sid": "EmailValidationPermissions",
      "Effect": "Allow",
      "Action": [
        "ses:GetEmailAddressInsights",
        "iam:CreateServiceLinkedRole"
      ],
      "Resource": "*"
    }
  ]
}

    L'GetEmailAddressInsightsautorizzazione è richiesta per le chiamate di convalida delle API e CreateServiceLinkedRole consente la pubblicazione delle CloudWatch metriche per l'attività di convalida.

Interpretazione dei risultati della convalida

La risposta di convalida include verdetti di fiducia per aiutarvi a prendere decisioni sugli indirizzi e-mail:

  • IsValid— Valutazione della validità complessiva con un verdetto di fiducia di ALTO, MEDIO o BASSO. Un elevato grado di confidenza di validità indica un'elevata probabilità di consegna per l'indirizzo e-mail, MEDIUM indica una probabilità di consegna moderata e LOW indica una probabilità di consegna bassa.

  • Evaluations— Risultati della valutazione individuale, ciascuno con un verdetto di fiducia:

    • HIGH— Indicazione chiara del controllo specifico (ad esempio, HIGH for IsRandomInput significa che l'e-mail è molto probabilmente generata casualmente).

    • MEDIUM— Indicazione moderata del controllo specifico (ad esempio, MEDIUM IsRandomInput significa che esiste una certa probabilità che l'indirizzo e-mail sia generato casualmente).

    • LOW— Indicazione debole o assente del controllo specifico (ad esempio, LOW IsRandomInput significa che è meno probabile che l'indirizzo e-mail sia generato casualmente).