開発者向け メール 検証API
REST API、わかりやすい結果ラベル、大きなファイル向けのバックグラウンドジョブで、登録フォーム、CRM、エンリッチメントのフロー、一括インポートに検証を追加できます。
開発者向け メール 検証の ユースケース
メールの品質が商品、営業、顧客対応のワークフローに影響する箇所に検証を組み込みましょう。
| 連携ポイント | 検証パターン | よくある対応 |
|---|---|---|
| 登録とトライアル | アカウント作成前のリアルタイムAPIチェック | 受け付ける、修正を求める、またはレビューに回す。 |
| リードフォーム | CRMやマーケティングオートメーションに書き込む前に検証 | 連絡できないリードが振り分けキューに入るのを防ぐ。 |
| 一括インポート | 大きなファイルはCSVまたはバックグラウンドジョブで | インポートや有効化の前に結果ラベルを付加する。 |
| データ商品 | エクスポートやエンリッチデータの納品前のAPIチェック | 検証ステータスのフィールドを顧客に公開する。 |
開発者が検証を追加するのは、たいていメールの品質が商品の導線に影響するときです。トライアル登録、アカウント作成、リードの振り分け、CRM同期、サポートの受付、データのエクスポートなどです。形式チェックだけでは、そのアドレスを先に進めるべきかどうかはわかりません。壊れやすい判断ツリーを増やさずにアプリケーションで使える、構造化された結果が必要です。
一方、検証API は、予測しやすい動作を重視して設計されています。メールアドレスを送るとJSONが返り、わかりやすいステータスラベルを自分のアプリケーションで処理できます。結果に応じて、アドレスを受け付けたり、修正を求めたり、リスクのあるレコードを除外したり、連絡先をレビュー状態にしたりできます。 APIドキュメントとクイックスタートでは、リクエストの構造、認証、エラー処理、レスポンスのフィールドを解説しています。
大規模なジョブでは、ユーザーのリクエストをブロックせずに一括検証を使いましょう。CSVをアップロードしてバックグラウンドジョブとして処理し、ダウンロードした結果ファイルまたはWebhookのフローでデータベースを更新します。実装パターンを比較するなら、まずは次をご覧ください: API検証と一括メール検証の比較。
開発者が 期待する すべてを
明確な入力、予測しやすい出力、リアルタイムと一括の両ワークフローに対応する連携方法。
シンプルな REST API
エンドポイントもキーも1つ、JSONレスポンスは一貫しています。HTTPリクエストを送れる言語やフレームワークなら何でも使えます。
充実した ドキュメント
リクエスト/レスポンスの例、エラーコード、主要なフレームワークや言語向けの連携ガイドを含む完全なAPIリファレンス。
言語を 問わない 連携
Node、Python、PHP、Ruby、Go、Java、またはJSONを解析できるあらゆるバックエンドから、HTTPSリクエストを直接送れます。
Webhook対応の ジョブ
大きなファイルにはバックグラウンドのワークフローを使い、結果の準備ができたらアプリケーションに通知できます。
運用の ための 管理機能
文書化された制限、結果の処理、アカウント管理を活用し、本番環境でも検証を予測可能に保てます。
リアルタイムと バッチ
フォームにはリアルタイムチェックを、インポート、CRMの更新、データのエクスポートにはバックグラウンドジョブを使えます。
1 リクエストに 1つの 結果
アプリケーションが振り分けに使える、一貫したJSONレスポンス。
"email": "dev@example.com"、
"status": "valid"、
"score": 94、
"disposable": false、
"catch_all": false、
"role_based": false
}
実装 チェックリスト
最初のリクエストから、本番での結果処理まで。
登録して キーを 取得
無料アカウントを作成してください。APIキーはダッシュボードですぐに発行されます。審査も待ち時間もありません。
結果の ステータスを マッピング
有効、無効、リスクあり、使い捨て、ロールベース、キャッチオールの各ステータスに対して、商品でどう対応するかを決めます。
リアルタイム または 一括で 本番へ
インラインのチェックにはAPIを、インポート、エンリッチメント用ファイル、CRMのクリーンアップにはバックグラウンドジョブを使います。
判断 レイヤーは 一度だけ構築
優れた連携は、エンドポイントを呼び出すだけではありません。結果を保存し、判断をログに残し、必要に応じてユーザーがアドレスを修正できるようにし、一括検証をレイテンシに敏感なユーザーフローから切り離します。
スタックの どこに 検証を 置くべきか
不正なアドレスが後で手間を生む場所にチェックを置きましょう。登録フォームでは、アカウント作成前に入力ミスを見つけます。リードフォームでは、CRMがジャンクで埋まる前に使い捨てドメインを弾きます。インポートはバックグラウンドで実行し、大きなCSVが商品の動作を妨げないようにします。ファイルが同期リクエストには大きすぎる場合でも、Webhookとジョブのポーリングで一括処理の流れを予測可能にできます。
見栄えのよいダッシュボードより、わかりやすい結果モデルのほうが重要です。アプリには、対応を判断できるステータスと、使い捨て、ロールベース、キャッチオールの検出ラベルが必要です。有効なメールは先に進め、無効なメールはユーザーに修正を求め、リスクのある行はレビューに回しましょう。まずは APIドキュメントから始め、検証APIをテストし、料金を確認してから、本番のボリュームに組み込みましょう。
よく ある 質問
VeriMailsを連携する開発者からよく寄せられる質問です。