検証
メール検証API
Cleariflowの最高クラスのメール検証APIで、受信トレイへの到達率を向上させ、メーリングリストを健全に保ちましょう。
GET
メール検証API
クイックスタート
リクエストを行うには、固有のapi_key と確認したい email を指定するだけで十分です。他に必要なパラメータはありません。
リクエストパラメータ
レスポンスパラメータ
レスポンスは、コンパクトで標準化された JSON 形式で返されます。タイプミスの可能性が検出された場合の修正候補です(例:johnsmith@gmial.com => johnsmith@gmail.com)。候補がない場合は空です。
アドレスがメールを受信できるかどうかのCleariflowの評価です。取り得る値:
DELIVERABLE、UNDELIVERABLE、UNKNOWN。DELIVERABLE には SMTP 検証の成功が必要です。MX レコードはあるが SMTP でメールボックスを確認できない場合(大手プロバイダでよくある)は UNKNOWN になります。すべてのプランで同じ検証を実行します。無料プランは月間クォータとレート制限のみが異なります(エラーコード 422、429 を参照)。ドメインが キャッチオール として設定されている場合に true です。
ドメインに MXレコード が存在する場合に true です。
SMTP 検証が成功した場合に true です。SMTPが失敗しても他のチェックが通過した場合、結果は
UNKNOWN になることがあります。SMTPの失敗のみを理由にサインアップやフォーム送信をブロックすることは推奨しません。リクエスト例
例:タイプミスの可能性
この例では、送信されたアドレスにタイプミスの可能性が検出されたリクエストを示します。 タイプミスの可能性が見つかった場合でも、他のすべてのチェック(無料メール、使い捨てドメインなど)は、修正候補ではなく元のアドレスに対して実行されます。例:無効なフォーマット
この例では、基本的なフォーマットチェックに失敗するアドレスを示します。is_valid_format が false の場合、後続のチェック(is_free_email、is_role_email など)はスキップされ、false として報告されます。
一括アップロード(CSV)
APIを直接呼び出したくない場合は、CSV一括アップローダーをご利用ください。処理が完了すると結果がメールで送信されます。 CSVをアップロードする際は、次のガイドラインに従ってください。- メールアドレスを最初の列に配置してください。
- 空行を削除してください。
- 1行に1アドレスのみ記載してください。
- ファイルは最大50,000行までに制限してください。