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

Required. Obtenha sua chave de API pessoal na página Meus produtos.

id

Required. Inteiro.

ID da solicitação.

format

Optional. String.

Usado para especificar o formato da resposta.

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

Valor padrão: "json".

Saída de amostra

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

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" significa que o e-mail e-mail passou com êxito pela verificação de SMTP, verificação de DNS e esse endereço de e-mail não é descartável. O valor "bad" significa que algumas dessas verificações (exceto a verificação de 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" se o endereço de e-mail existir e puder receber e-mails por SMTP e "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 esse servidor de e-mail tem ou não um endereço "catch-all". Isso se refere a um tipo especial de endereço de endereço que pode receber e-mails de qualquer número de endereços de e-mail inexistentes em um determinado domínio específico. Os endereços "catch-all" são comuns em empresas em que, se você enviar um e-mail para [email protected] e outro e-mail para o inexistente [email protected], 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.