Todos os produtos
Search

Este produto

    Direct Mail:ValidateEmail

    Central de documentação

    Direct Mail:ValidateEmail

    Última atualização: Jul 14, 2026

    Valida um endereço de e-mail.

    Experimente agora

    Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

    Testar

    Autorização RAM

    A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

    • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

    • API: A API que você pode chamar para executar a ação.

    • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

    • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

      • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

      • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

    • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

    • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

    Ação

    Nível de acesso

    Tipo de recurso

    Chave de condição

    Ação dependente

    dm:ValidateEmail

    none

    *All Resource

    *

    		 Nenhuma Nenhuma

    Sintaxe da solicitação

    POST  HTTP/1.1

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    Email

    string

    Sim

    O endereço de e-mail a ser validado.

    xxx@yyy.com
    Timeout

    integer

    Não

    O período de tempo limite. Valor padrão: 60 segundos.

    20
    CheckGraylist

    boolean

    Não

    Especifica se deve verificar a lista cinza. Valor padrão: false. O resultado é notificado de forma assíncrona por meio do EventBridge.

    true
    ProbeType

    string

    Não

    O tipo de sondagem. Valores válidos:

    • FULL: Ativa todos os recursos de detecção, incluindo sondagem SMTP. Como a sondagem SMTP envolve conexões remotas, a latência geral é alta. Este valor é adequado para cenários que não são sensíveis ao tempo de resposta. Cada detecção consome 1 cota de validação de endereço.

    • BASIC_ONLY: Ativa todos os recursos de detecção, exceto a sondagem SMTP, com baixa latência. Este valor é adequado para cenários sensíveis ao tempo de resposta, como validação em tempo real durante o registro para verificar se um endereço de e-mail é uma caixa postal descartável ou um endereço anômalo com encaminhamento MX, a fim de evitar registros em massa pela cadeia econômica subterrânea cibernética. Cada detecção consome 1/3 de uma cota de validação de endereço.

    FULL

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    Esquema da resposta.

    RequestId

    string

    O ID da solicitação.

    xxxx-xxxx-xxxx-xxxx
    Status

    string

    O status do endereço de e-mail obtido na validação.

    Valores válidos:

    • VALID :

      Endereço válido.

    • CATCHALL :

      Endereço catch-all, indicando que o domínio aceita e-mails enviados para todos os endereços de caixa postal inexistentes sob o nome de domínio.

    • UNKNOWN :

      Endereço com status desconhecido.

    • INVALID :

      Endereço inválido.

    • DONOTMAIL :

      Endereço anômalo que pode ser excluído em cenários de marketing.

    VALID
    SubStatus

    string

    O substatus do endereço de e-mail obtido na validação, que fornece uma descrição detalhada do status.

    Valores válidos:

    • NO_DNS_ENTRIES :

      Endereço inválido. Não existem registros DNS.

    • MISSPELLED :

      Endereço inválido. O endereço está grafado incorretamente.

    • DOES_NOT_ACCEPT_MAIL :

      Endereço inválido. O servidor de e-mail não aceita mensagens.

    • MAILBOX_NOT_EXISTS :

      Endereço inválido. A caixa postal não existe.

    • SYSTEM_ERROR :

      Status desconhecido. Ocorreu um erro de sistema.

    • MX_FORWARD :

      Endereço anômalo. O encaminhamento MX está configurado.

    • SYNTAX_INVALID :

      Endereço inválido. Existe um erro de sintaxe.

    • ROLE_ACCOUNT :

      Endereço anômalo. O endereço é uma conta de função, como role@, info@ ou contact@.

    • SMTP_CONNECT_FAILED :

      Status desconhecido. Falha ao conectar ao servidor SMTP remoto.

    • DISABLED :

      Endereço inválido. A caixa postal foi desativada.

    • UNSPECIFIED :

      Não especificado. Este valor pode ser retornado para endereços válidos, catch-all ou com status desconhecido.

    • IP_UNROUTABLE :

      Endereço inválido. O endereço IP do servidor de e-mail está inacessível.

    • GRAY_LIST :

      Status desconhecido. O endereço está na lista cinza.

    • MAILBOX_FULL :

      Endereço inválido. A caixa postal está cheia.

    • DISPOSABLE :

      Endereço anômalo. O endereço é uma caixa postal descartável na lista negra.

    • TIMEOUT_EXCEEDED :

      Status desconhecido. O período de tempo limite especificado foi excedido.

    UNSPECIFIED
    Provider

    string

    A classificação do provedor de e-mail do endereço.

    Valores válidos:

    • Others :

      Outros.

    • Yahoo :

      Yahoo.

    • Gmx :

      Gmx.

    • MailDotCom :

      MailDotCom.

    • Tencent :

      Tencent.

    • Gmail :

      Gmail.

    • Outlook :

      Outlook.

    • Zoho :

      Zoho.

    • Proton :

      Proton.

    • Netease :

      Netease.

    • Icloud :

      Icloud.

    • Webde :

      Webde.

    Gmail
    IsFreeMail

    boolean

    Indica se o endereço é uma caixa postal gratuita.

    Valores válidos:

    • true :

      true.

    • false :

      false.

    true
    LocalPart

    string

    A parte local do endereço de e-mail analisada na validação de sintaxe (em minúsculas e com a parte do sinal de mais removida).

    xxx
    DomainPart

    string

    A parte do domínio do endereço de e-mail analisada na validação de sintaxe (em minúsculas).

    yyy.com

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "RequestId": "xxxx-xxxx-xxxx-xxxx",
  "Status": "VALID",
  "SubStatus": "UNSPECIFIED",
  "Provider": "Gmail",
  "IsFreeMail": true,
  "LocalPart": "xxx",
  "DomainPart": "yyy.com"
}

    Códigos de erro

    Consulte Códigos de Erro para uma lista completa.

    Notas de versão

    Consulte Notas de Versão para uma lista completa.