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.
API de validation des e-mails
La validation des API vous permet de valider des adresses e-mail individuelles par le biais d'appels d'API, en fournissant des informations immédiates sur la validité des adresses, la délivrabilité et les facteurs de risque. Cette fonctionnalité est conçue pour valider les adresses au moment de la collecte, par exemple lors de l'enregistrement des utilisateurs, des formulaires d'abonnement ou dans tout autre scénario nécessitant des résultats de validation rapides.
La validation de l'API effectue plusieurs vérifications sur chaque adresse e-mail, notamment la validation de la syntaxe, la vérification du domaine, la vérification de l'existence des boîtes aux lettres, etc. Les résultats de validation incluent des verdicts de confiance (ÉLEVÉ, MOYEN ou FAIBLE) pour la validité globale et les évaluations individuelles.
Contrôles de validation effectués
La validation de l'API effectue les évaluations suivantes sur chaque adresse e-mail :
-
Validation de la syntaxe (HasValidSyntax« ») — Vérifie que l'adresse e-mail respecte les normes RFC appropriées et contient des caractères valides au format correct.
-
Enregistrements DNS (« HasValidDnsRecords ») : vérifie que le domaine existe, qu'il possède des enregistrements DNS valides et qu'il est configuré pour recevoir des e-mails.
-
Existence d'une boîte aux lettres (MailboxExists« ») — Vérifie que la boîte aux lettres existe et qu'elle peut recevoir des messages sans envoyer d'e-mail.
-
Adresse de rôle (« IsRoleAddress ») — Identifie les adresses basées sur les rôles (telles que admin@, support@ ou info@) susceptibles de présenter des taux d'engagement inférieurs.
-
Domaine jetable (« IsDisposable ») — Vérifie les adresses e-mail jetables ou temporaires susceptibles d'avoir un impact négatif sur la réputation de votre expéditeur.
-
Modèles de chaînes aléatoires (« IsRandomInput ») — Vérifie les modèles générés de manière aléatoire.
Utilisation de la validation d'API avec la console Amazon SES
La procédure suivante explique comment valider une adresse e-mail à l'aide de la console Amazon SES.
Pour valider une adresse e-mail à l'aide de la console Amazon SES
Connectez-vous à la console Amazon SES AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/ses/
. -
Dans le volet de navigation de gauche, choisissez Validation des adresses e-mail sous Validation des e-mails.
-
Dans la section Valider l'adresse e-mail, entrez l'adresse e-mail que vous souhaitez valider dans le champ Adresse e-mail.
-
Choisissez Valider.
Les résultats de validation apparaissent dans le panneau des résultats de validation, avec les informations suivantes :
-
IsValid— Validité globale avec un verdict de confiance (ÉLEVÉ, MOYEN ou FAIBLE).
-
Évaluations — Résultats d'évaluation individuels assortis de verdicts fiables concernant la syntaxe, les enregistrements DNS, l'existence de boîtes aux lettres et les facteurs de risque énumérés ci-dessus.
-
Utilisation de la validation de l'API avec le AWS CLI
Les exemples suivants vous montrent comment valider les adresses e-mail à l'aide du AWS CLI.
Pour valider une adresse e-mail à l'aide du AWS CLI
Vous pouvez utiliser l'GetEmailAddressInsightsopération dans l'API Amazon SES v2 pour valider les adresses e-mail. Vous pouvez appeler cette opération à partir du AWS CLI, comme indiqué dans les exemples suivants.
-
Validez une seule adresse e-mail :
aws --region us-east-1 sesv2 get-email-address-insights --email-address user@example.com -
La réponse devrait ressembler à ceci :
{ "MailboxValidation": { "IsValid": { "ConfidenceVerdict": "HIGH" }, "Evaluations": { "HasValidSyntax": { "ConfidenceVerdict": "HIGH" }, "HasValidDnsRecords": { "ConfidenceVerdict": "MEDIUM" }, "MailboxExists": { "ConfidenceVerdict": "MEDIUM" }, "IsRoleAddress": { "ConfidenceVerdict": "LOW" }, "IsDisposable": { "ConfidenceVerdict": "LOW" }, "IsRandomInput": { "ConfidenceVerdict": "LOW" } } } } -
Pour plus d'informations sur les valeurs de réponse et les types de données, consultez le type de
MailboxValidationdonnées dans la référence de l'API Amazon SES v2. -
Assurez-vous que votre identité IAM dispose des autorisations requises pour les appels d'API de validation des e-mails et la publication CloudWatch des métriques :
{ "Version": "2012-10-17 ", "Statement": [ { "Sid": "EmailValidationPermissions", "Effect": "Allow", "Action": [ "ses:GetEmailAddressInsights", "iam:CreateServiceLinkedRole" ], "Resource": "*" } ] }L'
GetEmailAddressInsightsautorisation est requise pour les appels de validation d'API etCreateServiceLinkedRolepermet de publier CloudWatch des métriques pour les activités de validation.
Interprétation des résultats de validation
La réponse de validation inclut des verdicts de confiance pour vous aider à prendre des décisions concernant les adresses e-mail :
-
IsValid— Évaluation de la validité globale avec un verdict de confiance élevé, moyen ou faible. Un niveau de fiabilité élevé indique une probabilité de livraison élevée pour l'adresse e-mail, un niveau MOYEN indique une probabilité de livraison modérée et un niveau faible indique une faible probabilité de livraison. -
Evaluations— Résultats d'évaluation individuels, chacun assorti d'un verdict de confiance :-
HIGH— Indication forte de la vérification spécifique (par exemple, HIGH IsRandomInput signifie que l'e-mail est très probablement généré de manière aléatoire). -
MEDIUM— Indication modérée de la vérification spécifique (par exemple, MEDIUM IsRandomInput signifie qu'il est probable que l'adresse e-mail soit générée de manière aléatoire). -
LOW— Indication faible ou inexistante de la vérification spécifique (par exemple, FAIBLE IsRandomInput signifie que l'adresse e-mail est moins susceptible d'être générée de manière aléatoire).
-
