一括電子メール検証: ジョブ結果の取得
/api/v3/email/batch/file/{jobid}
一括Eメール検証ジョブ結果の取得:
このAPIは、検証ジョブの結果の取得に役立ちます。
入力: /api/v3/email/batch/verifyレスポンスの値を使用して、jobidというパス・パラメータを定義します。
出力: A JSON object containing jobId, status, totalVerifiedEmails, completedOn, results, error.
レスポンスの例: { "jobId": "1000080", "status": "Complete", "totalEmailCount": "2", "completedOn": "2024-01-03 11:33:17.474", "results": [ { "statusMessage": "", "account": "abc", "domain": "oracle.com", "status": "valid", "email": "abc@oracle.com" }, { "statusMessage": "email_account_invalid", "account": "xyz", "domain": "gmail.com", "status": "invalid", "email": "xyz@gmail.com" } ], "error": {} }
「レスポンス属性」
各Eメール結果は、これらの属性で構成されます。
| フィールド | 説明 |
|---|---|
Email | 検証のために送信した電子メール・アドレス。 |
Status | 検証のステータス。 詳細は、「ステータス」セクションを参照してください。 |
StatusMessage | ステータスに関する追加情報。 ステータス・メッセージの詳細は、「ステータス」セクションを参照してください。 |
Account | 検証のために送信された電子メール・アドレスのアカウント部分。 |
Domain | 検証のために送信した電子メール・アドレスのドメイン部分。 |
「ステータス」
ジョブの結果は、Eメールごとにプライマリ・ステータス(ステータス)およびセカンダリ・ステータス(StatusMessage)を返します。
「プライマリ・ステータス」
次に、潜在的なプライマリ・ステータス・タイプを示します:
| Status | 説明 |
|---|---|
valid | 電子メール・アドレスは有効なアカウントです。 |
invalid | Eメール・アドレスが無効です。 詳細は、「セカンダリ・ステータス」表を参照してください。 |
accept_all | たとえそうでなくても、ドメインでEメールが常に有効であるとみなされることを示します。 これは、後でメッセージを削除したりバウンス・メッセージを送信したりできるファイアウォールまたは別のスパム・ツールが原因である可能性があります。 |
unknown | 電子メール・アドレスは有効であるように見えますが、ドメインが応答していません。 これは、ドメインに問題がある場合、ドメインが機能しなくなった場合、または会社のファイアウォール・ブロック・アクセスの問題である場合、一時的な問題になる可能性があります。 |
「セカンダリ・ステータス」
デフォルトでは、表示する追加情報がないかぎり、StatusMessageは空白フィールドとして返されます。 潜在的セカンダリ・ステータス・タイプは次のとおりです:
| StatusMessage | 説明 |
|---|---|
email_address_invalid | Eメール・アドレス書式が無効です。 |
email_domain_invalid | 電子メール・アドレスは、存在しないドメインに関連付けられています。 |
email_account_invalid | 指定されたドメインにEメール・アカウントが存在しません。 |
mailbox_full_invalid | このアカウントの受信ボックスは一杯であり、受信メールを受け入れることができません。 |
disposable | この電子メール・アドレスは使用不可です。 |
role_address | 電子メール・アドレスは、support@、sales@などの機能をサポートするために作成されました。 これは有効な電子メールである可能性がありますが、通常は個々のアドレスと比較してパフォーマンスが低下します。 |
リクエスト
この操作にはリクエスト本文がありません。
トップに戻るレスポンス
- application/json; charset=UTF-8
200 レスポンス
object