Obtener resultados (correos procesados) | Documentación | Email Verification Bulk API | WhoisXML API

Obtener resultados (correos procesados)

POST https://emailverification.whoisxmlapi.com/api/bevService/request/completed

Muestra de solicitud CURL

curl https://emailverification.whoisxmlapi.com/api/bevService/request/completed -X POST -H "Content-Type: application/json"  -d '{"apiKey": "YOUR_API_KEY", "id": 622, "format": "json"}'

Ejemplo de cuerpo de solicitud POST

{
    "apiKey": "YOUR_API_KEY",
    "id": 596,
    "format": "csv"
}

Parámetros de entrada

apiKey

Obligatorio. Obtenga su clave API personal en la página Mis productos.

id

Obligatorio. Entero.

ID de la solicitud.

format

Opcional. Cadena.

Se utiliza para especificar el formato de respuesta.

Valores permitidos: "xml", "json", "csv".

Valor por defecto: "json".

Muestra de salida

{
    "response": [
        {
            "emailAddress": "[email protected]",
            "formatCheck": "true",
            "smtpCheck": "null",
            "dnsCheck": "false",
            "freeCheck": "false",
            "disposableCheck": "false",
            "catchAllCheck": "null",
            "result": "bad"
        },
        {
            "emailAddress": "[email protected]",
            "formatCheck": "true",
            "smtpCheck": "true",
            "dnsCheck": "true",
            "freeCheck": "false",
            "disposableCheck": "false",
            "catchAllCheck": "true",
            "mxRecords": [
                "alt2.aspmx.l.google.com",
                "alt3.aspmx.l.google.com",
                "alt4.aspmx.l.google.com",
                "aspmx.l.google.com",
                "alt1.aspmx.l.google.com"
            ],
            "result": "unknown"
        },
        {
            "emailAddress": "[email protected]",
            "formatCheck": "true",
            "smtpCheck": "true",
            "dnsCheck": "true",
            "freeCheck": "true",
            "disposableCheck": "false",
            "catchAllCheck": "true",
            "mxRecords": [
                "mta6.am0.yahoodns.net",
                "mta5.am0.yahoodns.net",
                "mta7.am0.yahoodns.net"
            ],
            "result": "unknown"
        }
    ]
}

Code: 200 OK.
{
    "response": {
        "error": "Wrong request id"
    }
}

Code: 422 Unprocessable Entity.
response

El objeto de respuesta.

Contiene una matriz de resultados de verificación para cada dirección de correo de la solicitud original (véase la documentación más abajo).

Las respuestas a estas solicitudes pueden guardarse directamente en el disco.

En caso de error, contiene su descripción en el campo 'error'. Si hay varios errores se devuelven sus descripciones en la matriz 'errors'.

result

El campo de resultado puede contener cuatro valores: 'ok', 'unknown', 'smtp-failed', 'bad'. El valor 'ok' significa que el correo electrónico pasó con éxito la comprobación SMTP, la comprobación DNS y que esta dirección no es desechable. El valor 'bad' significa que algunas de estas comprobaciones (excepto la comprobación SMTP) fallaron. El valor 'smtp-failed' significa que la dirección de correo no existe en el servidor SMTP de destino o que temporalmente no pudo recibir mensajes. El valor 'unknown' significa que el alojamiento de correo electrónico admite la "función catch all".

emailAddress
La dirección de correo que debe verificarse.
formatCheck
Le permite saber si hay algún error de sintaxis en la dirección de correo. Se trata de una comprobación básica que se realiza para detectar cualquier errata simple o error importante. Este valor será 'true' si no hay errores y 'false' en caso contrario. Entre bastidores, el servicio API gestiona todos estos tipos de comprobaciones por usted de varias formas interesantes.
smtpCheck
Comprueba si la dirección de correo existe y puede recibir correos utilizando conexión SMTP y técnicas de emulación de envío de correo. Este valor será 'true' si la dirección de correo existe y puede recibir correosa través de SMTP y 'false' si la dirección de correo electrónico no existe en el servidor SMTP de destino o temporalmente no puede recibir mensajes. El valor será nulo si la solicitud SMTP no ha sido completada, la verificación del buzón no está soportada en el proveedor de buzones de destino o si no es aplicable.
dnsCheck
Garantiza que el dominio de la dirección de correo, por ejemplo: gmail.com, sea un dominio válido. Este valor será 'true' si el dominio es bueno y 'false' en caso contrario. Puede ser 'null' para correos no válidos o inexistentes.
freeCheck
Compruebe si la dirección de correo es de un proveedor de correo gratuito como Gmail o no. Este valor será será 'false' si la dirección de correo electrónico no es gratuita y 'true' en caso contrario. Puede ser 'null' para correos no válidos o inexistentes.
disposableCheck
Le indica si la dirección de correo electrónico es desechable (creada a través de un servicio como Mailinator). Esto le ayuda a comprobar si hay abusos. Este valor será 'false ' si el correo electrónico no es desechable, y 'true' en caso contrario. Puede ser 'null' para correos inválidos o inexistentes.
catchAllCheck
Le indica si este servidor de correo tiene o no una dirección "catch-all". Esto se refiere a un tipo especial de dirección que puede recibir correos electrónicos para cualquier número de direcciones de correo electrónico inexistentes bajo un determinado dominio. Las direcciones "catch-all" son comunes en negocios en los que, si envía un correo electrónico a [email protected] y otro correo electrónico a la inexistente [email protected], ambos correos irán a la misma bandeja de entrada. Los valores posibles son 'true' o 'false'. Puede ser 'null' para correos no válidos o inexistentes.
mxRecords
Lista de servidores de correo. Puede estar ausente para correos no válidos o inexistentes.