Obter resultados (e-mails processados) | Documentação | Email Verification Bulk API | WhoisXML API

Obter resultados (e-mails processados)

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

Exemplo de solicitação 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"}'

Exemplo de corpo de solicitação POST

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

Parâmetros de entrada

apiKey

Obrigatório. Obtenha sua chave de API pessoal na página Meus produtos.

id

Required. Inteiro.

ID of the request.

format

Opcional. String.

Usado para especificar o formato da resposta.

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

Default value: "json".

Saída de amostra

{
    "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

O objeto de resposta.

Contém uma matriz de resultados de verificação para cada endereço de e-mail na solicitação original (consulte a documentação abaixo).

As respostas a essas solicitações podem ser salvas diretamente no disco.

No caso de um erro, ele contém sua descrição no campo "error". Se houver vários erros, suas descrições serão retornadas na matriz "errors".

result

O campo de resultado pode conter quatro valores: 'ok', 'unknown', 'smtp-failed', 'bad'. O valor "ok" valor significa que o e-mail passou com sucesso pela verificação SMTP, verificação de DNS e este endereço de e-mail não é descartável. O valor "bad" (ruim) valor significa que algumas dessas verificações (exceto a verificação SMTP) falharam. O valor "smtp-failed significa que o endereço de e-mail não existe no servidor SMTP de destino ou que não foi possível receber mensagens temporariamente. O valor "unknown" significa que a hospedagem de e-mail suporta o recurso "catch all".

emailAddress
O endereço de e-mail a ser verificado.
formatCheck
Permite que você saiba se há algum erro de sintaxe no endereço de e-mail. Essa é uma verificação básica que é feita para detectar erros de digitação simples ou erros graves. Esse valor será "true" se não houver erros, e "falso" caso contrário. Nos bastidores, o serviço de API está lidando com todos esses tipos de verificação para você de várias maneiras interessantes.
smtpCheck
Verifica se o endereço de e-mail existe e se pode receber e-mails usando a conexão SMTP e técnicas de emulação de envio de e-mails. Esse valor será "true"(verdadeiro) se o endereço de e-mail existir e puder receber e-mails por SMTP e "falso"(falso) se o endereço de e-mail não existir no servidor SMTP de destino ou temporariamente não puder receber mensagens. O valor será nulo se a solicitação SMTP não puder ser concluída, a verificação da caixa de correio não for compatível com o provedor de caixa de correio de destino ou não for aplicável.
dnsCheck
Garante que o domínio no endereço de e-mail, por exemplo: gmail.com, seja um domínio válido. Esse valor será "true" se o domínio for válido e "false" caso contrário. Pode ser "nulo" para e-mails inválidos ou inexistentes. e-mails.
freeCheck
Verifique se o endereço de e-mail é de um provedor de e-mail gratuito, como o Gmail, ou não. Esse valor será será "false" se o endereço de e-mail não for gratuito e "true" caso contrário. Pode ser "null" para e-mails inválidos ou ou inexistentes.
disposableCheck
Informa se o endereço de e-mail é descartável ou não (criado por meio de um serviço como o Mailinator). Isso o ajuda a verificar se há abuso. Esse valor será "false" se o e-mail não for descartável e "true"(verdadeiro) caso contrário. Pode ser "null" para e-mails inválidos ou inexistentes.
catchAllCheck
Informa se este servidor de e-mail possui ou não um endereço "catch-all". Refere-se a um tipo especial de endereço que pode receber e-mails de qualquer número de endereços de e-mail inexistentes em um domínio específico. Endereços "catch-all" são comuns em empresas onde, se você enviar um e-mail para test@hi.com e outro e-mail para o inexistente test2@hi.com, inexistente, ambos os e-mails irão para a mesma caixa de entrada. Os valores possíveis são "true" (verdadeiro) ou "false"(falso). Pode ser "null" para e-mails inválidos ou inexistentes.
mxRecords
Lista de servidores de correio eletrônico. Pode estar ausente para e-mails inválidos ou inexistentes.