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

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

結果フィールドには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]にメールを送信し、存在しない[email protected]に別のメールを送信した場合、両方のメールが同じ受信トレイに届くような企業でよく使用されます。可能な値は「true」または「false」です。無効なメールや存在しないメールの場合は「null」になることがあります。
mxRecords
メールサーバーの一覧。無効なメールアドレスまたは存在しないメールアドレスについては表示されないことがあります。