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

Obtener resultados (correos electrónicos procesados)

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

Ejemplo 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 de caracteres.

Se utiliza para especificar el formato de respuesta.

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

Valor predeterminado: "json".

Muestra de salida

{
    "response": [
        {
            "emailAddress": "alex@alex.edu",
            "formatCheck": "true",
            "smtpCheck": "null",
            "dnsCheck": "false",
            "freeCheck": "false",
            "disposableCheck": "false",
            "catchAllCheck": "null",
            "result": "bad"
        },
        {
            "emailAddress": "bob@google.com",
            "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": "mila@yahoo.com",
            "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 electrónico 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, aparce la descripción en el campo 'error' . Si hay varios errores, las descripciones se devuelven 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 de correo electrónico 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 electrónico no existe en el servidor SMTP de destino o que temporalmente no pudo recibir mensajes. El valor 'desconocido' significa que el alojamiento de correo electrónico admite la «función catch all».

emailAddress
La dirección de correo electrónico que se va a verificar.
formatCheck
Le permite saber si hay algún error de sintaxis en la dirección de correo electrónico. Esta es una verificación básica que se lleva a cabo para detectar errores tipográficos simples o errores importantes. Este valor será 'true' si no hay errores, y 'false' en caso contrario. La API se encarga de realizar todas estas verificaciones de distintas maneras y en segundo plano.
smtpCheck
Comprueba si la dirección de correo electrónico existe y puede recibir correos electrónicos al usar conexión SMTP y técnicas de emulación de envío de correos electrónicos. Este valor será 'true' si la dirección de correo electrónico existe y puede recibir correo electrónico a través de SMTP y 'false' si la dirección de correo electrónico no existe en el servidor SMTP de destino o no pudo recibir mensajes temporalmente. El valor será nulo si la solicitud SMTP no se pudo completar, si el proveedor de buzones no admite la verificación del o si no es aplicable.
dnsCheck
Garantiza que el dominio de la dirección de correo electrónico, por ejemplo: gmail.com, sea un dominio válido. Este valor será 'true' si el dominio es bueno y 'falso' en caso contrario. Puede ser 'null' en caso de correos electrónicos inexistentes o no válidos.
freeCheck
Comprueba si la dirección de correo electrónico es de un proveedor de correo electrónico gratuito como Gmail o no. Este valor ser 'false' si la dirección de correo electrónico no es gratis, y 'true' en caso contrario. Puede ser 'null' para correos electrónicos inexistentes o no válidos.
disposableCheck
Le indica si la dirección de correo electrónico es desechable o no (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 electrónicos no vá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 empresas en que, si envía un correo electrónico a test@hi.com y otro correo electrónico a la inexistente test2@hi.com, 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 electrónicos no válidos o inexistentes.