As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# API de validação de e-mail
A validação da API permite que você valide endereços de e-mail individuais por meio de chamadas de API, fornecendo feedback imediato sobre a validade do endereço, a capacidade de entrega e os fatores de risco. Esse recurso foi projetado para validar endereços no ponto de coleta, como durante o registro do usuário, formulários de assinatura ou qualquer outro cenário em que você precise de resultados de validação oportunos.
A validação da API realiza várias verificações em cada endereço de e-mail, incluindo validação de sintaxe, verificação de domínio, verificação de existência de caixa de correio e outras. Os resultados da validação incluem veredictos de confiança (ALTO, MÉDIO ou BAIXO) para validade geral e avaliações individuais.
**Verificações de validação realizadas**
A validação da API realiza as seguintes avaliações em cada endereço de e-mail:
+ **Validação de sintaxe (HasValidSyntax'')** — Verifica se o endereço de e-mail segue os padrões RFC adequados e contém caracteres válidos no formato correto.
+ **Registros DNS ('HasValidDnsRecords')** — Verifica se o domínio existe, tem registros DNS válidos e está configurado para receber e-mails.
+ **Existência da caixa de correio (MailboxExists'')** — Verifica se a caixa de correio existe e pode receber mensagens sem realmente enviar um e-mail.
+ **Endereço da função ('IsRoleAddress')** — Identifica endereços baseados em funções (como admin@, support@ ou info@) que podem ter taxas de engajamento mais baixas.
+ **Domínio descartável ('IsDisposable')** — Verifica endereços de e-mail descartáveis ou temporários que podem afetar negativamente a reputação do remetente.
+ **Padrões de string aleatórios ('IsRandomInput')** — Verifica padrões gerados aleatoriamente.
## Usando a validação de API com o console do Amazon SES
O procedimento a seguir mostra como validar um endereço de e-mail usando o console do Amazon SES.
**Para validar um endereço de e-mail usando o console do Amazon SES**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon SES em [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/).
1. No painel de navegação esquerdo, escolha Validação de **endereços de e-mail em Validação** de **e-mail**.
1. Na seção **Validar endereço de e-mail**, insira o endereço de e-mail que você deseja validar no campo **Endereço de e-mail**.
1. Escolha **Validar**.
Os resultados da validação aparecem no painel **Resultados da validação**, mostrando:
+ **IsValid**— Validade geral com um veredicto de confiança (ALTO, MÉDIO ou BAIXO).
+ **Avaliações** — resultados de avaliações individuais com veredictos de confiança para sintaxe, registros DNS, existência de caixas de correio e fatores de risco listados acima.
## Usando a validação da API com o AWS CLI
Os exemplos a seguir mostram como validar endereços de e-mail usando o. AWS CLI
**Para validar um endereço de e-mail usando o AWS CLI**
Você pode usar a [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetEmailAddressInsights.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetEmailAddressInsights.html)operação na API v2 do Amazon SES para validar endereços de e-mail. Você pode chamar essa operação a partir do AWS CLI, conforme mostrado nos exemplos a seguir.
+ Valide um único endereço de e-mail:
```
aws --region us-east-1 sesv2 get-email-address-insights --email-address user@example.com
```
+ A resposta deve ser semelhante a esta:
```
{
"MailboxValidation": {
"IsValid": {
"ConfidenceVerdict": "HIGH"
},
"Evaluations": {
"HasValidSyntax": {
"ConfidenceVerdict": "HIGH"
},
"HasValidDnsRecords": {
"ConfidenceVerdict": "MEDIUM"
},
"MailboxExists": {
"ConfidenceVerdict": "MEDIUM"
},
"IsRoleAddress": {
"ConfidenceVerdict": "LOW"
},
"IsDisposable": {
"ConfidenceVerdict": "LOW"
},
"IsRandomInput": {
"ConfidenceVerdict": "LOW"
}
}
}
}
```
+ Para obter mais informações sobre valores de resposta e tipos de dados, consulte o tipo de [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_MailboxValidation.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_MailboxValidation.html)dados na referência da API v2 do Amazon SES.
+ Certifique-se de que sua identidade do IAM tenha as permissões necessárias para a publicação de chamadas e CloudWatch métricas da API de validação de e-mail:
```
{
"Version": "2012-10-17 ",
"Statement": [
{
"Sid": "EmailValidationPermissions",
"Effect": "Allow",
"Action": [
"ses:GetEmailAddressInsights",
"iam:CreateServiceLinkedRole"
],
"Resource": "*"
}
]
}
```
A `GetEmailAddressInsights` permissão é necessária para chamadas de validação da API e `CreateServiceLinkedRole` permite a publicação de CloudWatch métricas para atividades de validação.
**Interpretando os resultados da validação**
A resposta de validação inclui veredictos de confiança para ajudar você a tomar decisões sobre endereços de e-mail:
+ `IsValid`— Avaliação geral da validade com um veredicto de confiança de ALTO, MÉDIO ou BAIXO. ALTA confiança de validade indica alta probabilidade de entrega para o endereço de e-mail, MÉDIA indica probabilidade de entrega moderada e BAIXA indica baixa probabilidade de entrega.
+ `Evaluations`— Resultados da avaliação individual, cada um com um veredicto de confiança:
+ `HIGH`— Forte indicação da verificação específica (por exemplo, HIGH for IsRandomInput significa que o e-mail provavelmente foi gerado aleatoriamente).
+ `MEDIUM`— Indicação moderada da verificação específica (por exemplo, MEDIUM for IsRandomInput significa que há alguma probabilidade de o endereço de e-mail ser gerado aleatoriamente).
+ `LOW`— Indicação fraca ou nenhuma da verificação específica (por exemplo, LOW for IsRandomInput significa que o endereço de e-mail é menos provável de ser gerado aleatoriamente).