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

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
}

入力パラメータ

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

The result field may contains four values: 'ok', 'unknown', 'smtp-failed', 'bad'. The 'ok' value means that the email successfully passed through the SMTP check, DNS check, and this email address isn’t disposable. The 'bad' value means that some of these checks (except SMTP check) failed. The 'smtp-failed' value means the email address does not exist on the target SMTP server or temporarily couldn't receive messages. The 'unknown' value means that email hosting supports "catch all feature".

emailAddress
認証するメールアドレス。
formatCheck
メールアドレスに構文エラーがあるかどうかをお知らせします。これは、単純なタイプミスや重大なエラーを検出するための基本的なチェックです。エラーがない場合は「true」、エラーがある場合は「false」となります。裏側では、こうした認証チェックをAPIサービスが処理しています。
smtpCheck
Checks if the email address exists and can receive emails by using SMTP connection and email-sending emulation techniques. This value will be 'true' if the email address exists and can receive email over SMTP, and 'false' if the email address does not exist on the target SMTP server or temporarily couldn't receive messages. The value will be 'null' if the SMTP request could not be completed, mailbox verification is not supported on the target mailbox provider, or not applicable.
dnsCheck
メールアドレスのドメイン名(例:gmail.com)が有効なドメイン名であることを確認します。ドメイン名が有効であればこの値は「true」、無効であれば「false」となります。無効なメールアドレスや存在しないメールアドレスの場合は「null」になることがあります。
freeCheck
メールアドレスがGmailなどの無料メールプロバイダーのものであるかどうかを確認します。メールアドレスが無料でない場合、この値は「false」となります。無料メールアドレスである場合は「true」となります。無効なメールアドレスや存在しないメールアドレスの場合は「null」となることがあります。
disposableCheck
メールアドレスが使い捨て(Mailinatorのようなサービスで作成された)かどうかを示します。これにより、不正利用の有無を確認できます。メールアドレスが使い捨てでない場合は「false」、使い捨てである場合は「true」となります。無効なメールアドレスや存在しないメールアドレスの場合は「null」となることがあります。
catchAllCheck
このメールサーバーに「キャッチオール」アドレスがあるかどうかを示します。これは、特定のドメイン名の下ある、存在しないメールアドレスのメールを全て受信できる特別なタイプのアドレスを指します。キャッチオールアドレスは、[email protected]にメールを送信し、存在しない[email protected]に別のメールを送信した場合、両方のメールが同じ受信トレイに届くような企業でよく使用されます。可能な値は「true」または「false」です。無効なメールや存在しないメールの場合は「null」になることがあります。
mxRecords
メールサーバーの一覧。無効なメールアドレスまたは存在しないメールアドレスについては表示されないことがあります。