結果を取得(処理されたメールアドレス) | ドキュメント | Email Verification Bulk API | WhoisXML API

結果を取得(処理されたメールアドレス)

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

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"}'

POSTリクエストボディのサンプル

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

入力パラメータ

apiKey

必須 。My productsページでAPIキーを取得してください。

id

必須。整数。

リクエストのID。

format

任意。文字列。

応答の形式を指定するために使用します。

使用可能な値:「xml」、「json」、「csv」。

初期値:「json」。

サンプル出力

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

Responseオブジェクト。

元のリクエストで指定した各メールアドレスの認証結果の一覧が含まれています(以下のドキュメントを参照してください)。

これらのリクエストに対する応答は、直接ディスクに保存することができます。

エラーが発生した場合は、その説明が「error」フィールドに含まれます。複数のエラーが発生した場合は、それらの説明が「errors」配列で返されます。

result

結果フィールドには、次の4つの値が含まれる場合があります:「ok」「unknown」「smtp-failed」「bad」「ok」は、メールアドレスがSMTPチェック、DNSチェックに通過し、使い捨てではないことを意味します。「bad」は、これらのチェック(SMTP チェックを除く)の一部で失敗したことを意味します。「smtp-failed」は、対象のSMTPサーバー上にそのメールアドレスが存在しないか、または一時的にメッセージを受信できなかったことを意味します。「unknown」は、メールホストが「キャッチオール機能」をサポートしていることを意味します。

emailAddress
認証するメールアドレス。
formatCheck
メールアドレスに構文エラーがあるかどうかをお知らせします。これは、単純なタイプミスや重大なエラーを検出するための基本的なチェックです。エラーがない場合は「true」、エラーがある場合は「false」となります。裏側では、こうした認証チェックをAPIサービスが処理しています。
smtpCheck
SMTP接続とメール送信のエミュレーション技術を使用して、メールアドレスが存在し、メールを受信できるかどうかを確認します。この値は、メールアドレスが存在し、SMTP経由でメールを受信できる場合は「true」、対象のSMTPサーバーにメールアドレスが存在しない場合や一時的にメッセージを受信できない場合は「false」となります。SMTPリクエストが完了できなかった場合、標的としたメールボックスプロバイダーでメールボックスの検証がサポートされていない場合、または該当しない場合は、値はnullになります。
dnsCheck
メールアドレスのドメイン名(例:gmail.com)が有効なドメイン名であることを確認します。ドメイン名が有効であればこの値は「true」、無効であれば「false」となります。無効なメールアドレスや存在しないメールアドレスの場合は「null」になることがあります。
freeCheck
メールアドレスがGmailなどの無料メールプロバイダーのものであるかどうかを確認します。メールアドレスが無料でない場合、この値は「false」となります。無料メールアドレスである場合は「true」となります。無効なメールアドレスや存在しないメールアドレスの場合は「null」となることがあります。
disposableCheck
メールアドレスが使い捨て(Mailinatorのようなサービスで作成された)かどうかを示します。これにより、不正利用の有無を確認できます。メールアドレスが使い捨てでない場合は「false」、使い捨てである場合は「true」となります。無効なメールアドレスや存在しないメールアドレスの場合は「null」となることがあります。
catchAllCheck
このメールサーバーが「キャッチオール」アドレスを持っているかどうかを示す。キャッチオールアドレスとは、特定のドメイン名の下で実在しないメールアドレスへのメールを受信できる特別なタイプのアドレスを指します。 キャッチオールアドレスは、[email protected] に1通のメールを送信し、実在しない[email protected]に別の1通のメールを送信した場合に、両方のメールが同じ受信トレイに届くようなビジネスでよく使用されます。値は「true」または「false」です。 無効なメールアドレスや存在しないメールアドレスの場合は「null」となることがあります。
mxRecords
メールサーバーの一覧。無効なメールアドレスまたは存在しないメールアドレスについては表示されないことがあります。