Todos los productos
Search

Este producto

    Direct Mail:ValidateEmail

    Centro de documentos

    Direct Mail:ValidateEmail

    Última actualización: Oct 27, 2026

    Valida una dirección de correo electrónico.

    Pruébelo ahora

    Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

    Test

    Autorización de RAM

    La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

    • Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.

    • API: La API que debe invocarse para llevar a cabo la acción.

    • Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.

    • Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.

      • En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.

      • Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.

    • Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.

    • Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

    Action

    Nivel de acceso

    Tipo de recurso

    Clave de condición

    Acción dependiente

    dm:ValidateEmail

    none

    *Todos los recursos.

    *

    		 Ninguna Ninguna

    Sintaxis de la solicitud

    POST  HTTP/1.1

    Parámetros de la solicitud

    Parámetro

    Tipo

    Obligatorio

    Descripción

    Ejemplo
    Email

    string

    Sí

    La dirección de correo electrónico que se va a validar.

    xxx@yyy.com
    Timeout

    integer

    No

    El tiempo de espera en segundos. Valor predeterminado: 60.

    20
    CheckGraylist

    boolean

    No

    Especifica si se debe comprobar la lista gris. Valor predeterminado: false. El resultado se notifica de forma asíncrona a través de EventBridge.

    true
    ProbeType

    string

    No

    El tipo de sondeo. Valores válidos:

    • FULL: Habilita todas las capacidades de detección, incluido el sondeo SMTP. Dado que el sondeo SMTP implica conexiones remotas, la latencia general es alta. Este valor es adecuado para escenarios que no son sensibles al tiempo de respuesta. Una sola comprobación consume una cuota de validación de dirección. En este modo, el estado UNKNOWN no se contabiliza.

    • BASIC_ONLY: Habilita todas las capacidades de detección excepto el sondeo SMTP, con baja latencia. Este valor es adecuado para escenarios sensibles al tiempo de respuesta, como la validación de direcciones de correo electrónico en tiempo real durante el registro para identificar direcciones de correo electrónico desechables o direcciones anómalas con reenvío MX, con el fin de defenderse contra el registro masivo por parte de la cadena de economía subterránea cibernética. Una sola comprobación consume un tercio de una cuota de validación de dirección. En este modo, el estado UNKNOWN sí se contabiliza.

    Valores válidos:

    • BASIC_ONLY :

      Capacidades de detección básicas excepto el sondeo SMTP.

    • FULL :

      Todas las capacidades de detección.

    FULL

    Elementos de la respuesta

    Elemento

    Tipo

    Descripción

    Ejemplo

    object

    Esquema de la respuesta.

    RequestId

    string

    El ID de la solicitud.

    xxxx-xxxx-xxxx-xxxx
    Status

    string

    El estado de la dirección de correo electrónico validada.

    Valores válidos:

    • VALID :

      Dirección válida.

    • CATCHALL :

      Dirección catch-all, que indica que el dominio acepta correos electrónicos enviados a todas las direcciones de correo electrónico inexistentes bajo el dominio.

    • UNKNOWN :

      Dirección con estado desconocido.

    • INVALID :

      Dirección no válida.

    • DONOTMAIL :

      Dirección anómala, que se puede excluir en escenarios de marketing.

    VALID
    SubStatus

    string

    El subestado de la dirección de correo electrónico validada, que proporciona una descripción detallada del estado.

    Valores válidos:

    • NO_DNS_ENTRIES :

      Dirección no válida sin registros DNS.

    • MISSPELLED :

      Dirección no válida debido a un error ortográfico.

    • DOES_NOT_ACCEPT_MAIL :

      Dirección no válida porque el servidor de correo no acepta correos electrónicos.

    • MAILBOX_NOT_EXISTS :

      Dirección no válida porque el buzón no existe.

    • SYSTEM_ERROR :

      Estado desconocido debido a un error del sistema.

    • MX_FORWARD :

      Dirección anómala con reenvío MX.

    • SYNTAX_INVALID :

      Dirección no válida debido a un error de sintaxis.

    • ROLE_ACCOUNT :

      Dirección anómala que es una cuenta de rol, como role@, info@ o contact@.

    • SMTP_CONNECT_FAILED :

      Estado desconocido porque la conexión al servidor SMTP del destinatario falló.

    • DISABLED :

      Dirección no válida porque el buzón está deshabilitado.

    • UNSPECIFIED :

      No especificado, que se puede devolver para estados válidos, catch-all o desconocidos.

    • IP_UNROUTABLE :

      Dirección no válida porque la dirección IP del servidor de correo es inalcanzable.

    • GRAY_LIST :

      Estado desconocido debido a la lista gris.

    • MAILBOX_FULL :

      Dirección no válida porque el buzón está lleno.

    • DISPOSABLE :

      Dirección anómala que es una dirección de correo electrónico desechable en la base de datos de lista negra.

    • TIMEOUT_EXCEEDED :

      Estado desconocido porque se superó el tiempo de espera especificado.

    UNSPECIFIED
    Provider

    string

    La categoría del proveedor de correo electrónico de la dirección.

    Valores válidos:

    • Others :

      Otros.

    • 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 si la dirección es una dirección de correo electrónico gratuito.

    Valores válidos:

    • true :

      true.

    • false :

      false.

    true
    LocalPart

    string

    La parte local de la dirección de correo electrónico analizada mediante la validación de sintaxis, que se convierte a minúsculas y excluye el signo más y los caracteres posteriores.

    xxx
    DomainPart

    string

    La parte del dominio de la dirección de correo electrónico analizada mediante la validación de sintaxis, que se convierte a minúsculas.

    yyy.com

    Ejemplos

    Respuesta exitosa

    JSON Formato

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

    Códigos de error

    Consulte Códigos de error para ver la lista completa.

    Notas de la versión

    Consulte Notas de la versión para ver la lista completa.