API de validação de e-mail - Amazon Simple Email Service
Validação de API (console)Validação da API (AWS CLI)

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

  2. No painel de navegação esquerdo, escolha Validação de endereços de e-mail em Validação de e-mail.

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

  4. 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 GetEmailAddressInsightsoperaçã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 MailboxValidationdados 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).