Todos os produtos
Search

Este produto

    Direct Mail:ValidateEmail

    Central de documentação

    Direct Mail:ValidateEmail

    Última atualização: Oct 27, 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

    *Todos os recursos.

    *

    		 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 em segundos. Valor padrão: 60.

    20
    CheckGraylist

    boolean

    Não

    Especifica se a lista cinza deve ser verificada. 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:\n- FULL: Ativa todos os recursos de detecção, incluindo a 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. Uma única verificação consome uma cota de validação de endereço. Neste modo, o status UNKNOWN não é medido.\n- 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 a validação de endereço de e-mail em tempo real durante o registro para identificar endereços de e-mail descartáveis ou endereços anormais com encaminhamento MX, a fim de defender contra registros em massa pela cadeia da economia subterrânea cibernética. Uma única verificação consome um terço de uma cota de validação de endereço. Neste modo, o status UNKNOWN é medido.

    Valores válidos:

    • BASIC_ONLY :

      Recursos básicos de detecção, exceto sondagem SMTP.

    • FULL :

      Todos os recursos de detecçã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 validado.

    Valores válidos:

    • VALID :

      Endereço válido.

    • CATCHALL :

      Endereço catch-all, que indica que o domínio aceita e-mails enviados para todos os endereços de e-mail inexistentes no domínio.

    • UNKNOWN :

      Endereço com status desconhecido.

    • INVALID :

      Endereço inválido.

    • DONOTMAIL :

      Endereço anormal, que pode ser excluído em cenários de marketing.

    VALID
    SubStatus

    string

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

    Valores válidos:

    • NO_DNS_ENTRIES :

      Endereço inválido sem registros DNS.

    • MISSPELLED :

      Endereço inválido devido a um erro de ortografia.

    • DOES_NOT_ACCEPT_MAIL :

      Endereço inválido porque o servidor de e-mail não aceita e-mails.

    • MAILBOX_NOT_EXISTS :

      Endereço inválido porque a caixa de correio não existe.

    • SYSTEM_ERROR :

      Status desconhecido devido a um erro do sistema.

    • MX_FORWARD :

      Endereço anormal com encaminhamento MX.

    • SYNTAX_INVALID :

      Endereço inválido devido a um erro de sintaxe.

    • ROLE_ACCOUNT :

      Endereço anormal que é uma conta de função, como role@, info@ ou contact@.

    • SMTP_CONNECT_FAILED :

      Status desconhecido porque a conexão com o servidor SMTP do destinatário falhou.

    • DISABLED :

      Endereço inválido porque a caixa de correio está desativada.

    • UNSPECIFIED :

      Não especificado, que pode ser retornado para status válidos, catch-all ou desconhecidos.

    • IP_UNROUTABLE :

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

    • GRAY_LIST :

      Status desconhecido devido ao graylisting.

    • MAILBOX_FULL :

      Endereço inválido porque a caixa de correio está cheia.

    • DISPOSABLE :

      Endereço anormal que é um endereço de e-mail descartável no banco de dados de lista negra.

    • TIMEOUT_EXCEEDED :

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

    UNSPECIFIED
    Provider

    string

    A categoria 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 é um endereço de e-mail gratuito.

    Valores válidos:

    • true :

      true.

    • false :

      false.

    true
    LocalPart

    string

    A parte local do endereço de e-mail analisada por meio da validação de sintaxe, que é convertida para minúsculas e exclui o sinal de mais e os caracteres subsequentes.

    xxx
    DomainPart

    string

    A parte do domínio do endereço de e-mail analisada por meio da validação de sintaxe, que é convertida para 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.