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 possono 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/](https://console.aws.amazon.com/ses/).
1. Nel riquadro di navigazione a sinistra, scegli **Convalida degli indirizzi e-mail** in **Convalida e-mail**.
1. **Nella sezione **Convalida indirizzo e-mail**, inserisci l'indirizzo e-mail che desideri convalidare nel campo Indirizzo e-mail.**
1. **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'[https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetEmailAddressInsights.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetEmailAddressInsights.html)operazione 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 [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_MailboxValidation.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_MailboxValidation.html)dati 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'`GetEmailAddressInsights`autorizzazione è 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).