メールアドレスのバリデーションAPI:登録フォームをリアルタイムでチェック
ユーザーが送信したアドレスを、その場で確認します。1回の呼び出しで、メールサーバーとメールボックスが存在するかを確認し、使い捨てと役割アドレスのフラグも返します。どのアドレスを受け付けるかは、そのフラグをもとに決められます。このメールアドレスのバリデーションAPI(email validation API)は、入口で不正なデータを止め、偽のアカウントがデータベースに入るのを防ぎます。
// 1. Receive submitted form data
const { email } = req.body;
// 2. Validate via API
const { data } = await checkEmail(email);
// 3. Make real-time form decision
if (data.status === 'undeliverable') {
return res.status(400).json({ error: 'Please enter a valid, active email address.' });
}
if (data.details.attributes.disposable) {
return res.status(400).json({ error: 'Temporary or disposable emails are not allowed.' });
}
// 4. Proceed with account registration
await createUser({ email });無料クレジット1,000件付き。クレジットカードは不要です。クレジットに有効期限はありません。
正規表現だけではメールアドレスのバリデーションにならない理由
正規表現が確認するのは、文字列の構造だけです。@記号があるか、ドメインの形式がそれらしく見えるか、文字が標準のASCIIの範囲に入っているかです。正規表現でわかるのは、入力がメールアドレスのように見えるかどうかだけです。そのアドレスで誰かがメッセージを受け取れるかどうかはわかりません。
user@example.comやasdf12345@gmail.comと入力すると、RFCに沿った正規表現はどれも問題なく通します。それでも、一方のドメインには使われているメールサーバーがなく、もう一方のメールボックスは存在しないかもしれません。
このメールアドレスのバリデーションAPIは、JSONで結果を返し、正規表現よりもずっと多くのことを確認します。1回のリクエストで、DNSレコードを調べ、MXホストを検索し、送信先のメールサーバーに接続してメールボックスの応答を確かめます。さらに、ドメインを大規模な使い捨てドメインのリストと照合します。
厳しすぎる正規表現は、正しいアドレスを誤って拒否する原因にもなります。独自の正規表現は、.studioや.cloudのような珍しいトップレベルドメイン、正しい国際文字、珍しい記号を含む正規のアドレスを拒否することがよくあります。このAPIはRFC 5322の構文の仕様をすべて自動で扱うため、壊れやすい正規表現のライブラリをコードの中で管理する必要がなくなります。
構文のチェック
外部のネットワークを調べる前に、基本的な入力ミス、トップレベルドメインの抜け、使えない記号、空白の問題を見つけます。
DNSとMXの確認
ドメインが登録されているかを確認し、受信メールを受け付けるメールサーバー(MX)が設定されているかを調べます。
メールボックスのチェック
相手のメールサーバーと直接やり取りし、そのメールボックスが存在してメールを受け取れるかを確認します。
登録時にブロックするもの、印を付けるもの、受け付けるもの
登録の条件は、事業によって違います。企業向けのB2B SaaSは会社のメールアドレスを必須にすることがあり、個人向けのSNSアプリは個人のGmailアドレスも受け付けます。実際のAPIレスポンスの属性をもとにした、推奨の判断表は次のとおりです。
| APIの結果 | フィールドの条件 | フォームでの対応 |
|---|---|---|
| 無効 | status === "undeliverable" | すぐにブロックします。表示例:「使用中の正しいメールアドレスを入力してください。」 |
| 使い捨て | details.attributes.disposable === true | ブロックするか、別のアドレスを求めます。表示例:「一時的なメールアドレスは使用できません。」 |
| 役割アドレス | details.attributes.role_account === true | 受け付けます。B2Bのフォームでは印を付けます。担当者に知らせるか、一般のリードとして振り分けます。 |
| フリーメール | details.attributes.free_email === true | B2Cのアプリでは受け付けます。B2Bのデモやトライアルのフォームでは、会社のメールアドレスを必須にします。 |
| キャッチオールドメイン | details.attributes.catch_all === true | catch_all_verdictを確認します。"valid"なら受け付け、"invalid"ならブロックし、nullなら登録を受け付けます。 |
| 不明 | status === "unknown" | 受け付けて、後でもう一度チェックします(クレジットは返却されます)。正規のユーザーを決してブロックしないよう、エラー時は通過させます(フェイルオープン)。 |
登録フォームにメールアドレスのバリデーションを追加する
リアルタイムのバリデーションを安全に組み込むには、次の4つの手順に従ってください。リクエストには非公開のAPIキーが必要なので、チェックはバックエンドのサーバーから実行します。
フェイルオープンが重要な理由:登録フォームは遅延の影響を受けやすいものです。外部のAPI呼び出しがネットワークの遅延で止まったときにフォームをブロックすると、実際の顧客を失うことがあります。タイムアウトを短く設定し、時間切れのときは登録をそのまま進めるようにすれば、正規のユーザーを断らずに済みます。その間に、バックエンドはそのアドレスを後でバックグラウンドでチェックするよう順番待ちに入れます。
フォームからバックエンドへ送信
訪問者が登録内容を送信すると、ブラウザがメールアドレスを自社のアプリケーションのエンドポイントに送ります。
バックエンドがバリデーションAPIを呼び出す
サーバーは、環境変数に保存した非公開のキーを使って、GiggalにPOSTリクエストを同期で送ります。
バックエンドが判断表を適用
JSONの属性を読み取ります。アドレスが使い捨てか配信不可なら、わかりやすいエラーメッセージをブラウザに返します。
タイムアウト時は通過させる
外部との通信がタイムアウトしたら、フェイルオープンにします。登録を受け付け、後で検証するバックグラウンドのジョブを順番待ちに入れます。
実装のコード例
// server.js (Express Route)
const timeoutMs = 5000; // adjust to what your form can tolerate
app.post('/api/signup', async (req, res) => {
const { email, password } = req.body;
try {
const apiRes = await fetch('https://api.giggal.ai/v1/verify', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.GIGGAL_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({ email }),
signal: AbortSignal.timeout(timeoutMs), // fail-open timeout
});
const result = await apiRes.json();
if (result.success) {
const { status, details } = result.data;
// Decision checks
if (status === 'undeliverable') {
return res.status(400).json({ error: 'This email address does not exist.' });
}
if (details.attributes.disposable) {
return res.status(400).json({ error: 'Disposable email addresses are not accepted.' });
}
}
} catch (err) {
// Fail open: log timeout and let user proceed
console.warn('Email check timed out, failing open:', err.message);
}
// Create user in database
const user = await db.users.create({ email, password });
return res.json({ success: true, userId: user.id });
});# app.py (Flask Route)
import os, requests
from flask import Flask, request, jsonify
app = Flask(__name__)
timeout_seconds = 5 # adjust to what your form can tolerate
@app.route("/api/signup", methods=["POST"])
def signup():
email = request.json.get("email")
try:
resp = requests.post(
"https://api.giggal.ai/v1/verify",
headers={"Authorization": f"Bearer {os.environ['GIGGAL_API_KEY']}"},
json={"email": email},
timeout=timeout_seconds # fail open on timeout
)
data = resp.json().get("data", {})
if data.get("status") == "undeliverable":
return jsonify({"error": "Email address is invalid."}), 400
if data.get("details", {}).get("attributes", {}).get("disposable"):
return jsonify({"error": "Disposable emails are prohibited."}), 400
except requests.exceptions.RequestException:
# Fail open: proceed with signup on timeout
pass
# Complete user registration
return jsonify({"success": True})// Frontend form submit handler
const form = document.querySelector('#signup-form');
form.addEventListener('submit', async (e) => {
e.preventDefault();
const email = document.querySelector('#email-input').value;
const res = await fetch('/api/signup', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ email }),
});
const payload = await res.json();
if (!res.ok) {
showFormError(payload.error); // Show friendly user feedback
} else {
redirectToDashboard();
}
});重要:クライアント側のスクリプトからGiggalのAPIのエンドポイントを直接呼び出さないでください。認証情報はサーバーに置き、公開しないでください。
使い捨てのアドレスと偽のアドレスでの登録を防ぐ
一時的な受信トレイは、製品の分析データを不正確にし、無料トライアルの枠を消費し、有料の顧客になることはありません。このサービスは、リスクの高い登録のパターンに印を付けます。
使い捨ての受信トレイ
100,000以上の一時的なドメインを登録したリストと照合します。使い捨てのメールボックスを見分ける方法は、捨てメアド判定ツールで詳しく紹介しています。
プラスアドレスの検出
プラス記号で作った別名(user+trial@domain.com)に印を付けます。1人のユーザーがトライアルのアカウントを重複して作るのを防げます。
返信不可のメールボックスの検出
受信したメールを破棄する一斉送信用や自動送信用のメールボックスを見分けます。やり取りのできないアドレスでの登録を防げます。
ユーザーの入力ミスを自動で修正しない
ユーザーの入力を黙って書き換えないでください(例:gnail.comを自動でgmail.comに変える)。アドレスがバリデーションに通らなかったときは、入力を確認するようはっきりしたメッセージで伝えてください。黙って書き換えると、アカウントの有効化用のトークンや請求の領収書が別の人に届くおそれがあります。
メールアドレスをリアルタイムでバリデーションする場所
製品の中でユーザーがフォームを送信する場所なら、どこでもメールアドレスをチェックできます。
ユーザー登録フォーム
スパムの登録を防ぎ、ウェルカムメールや確認用のリンクが使われている受信トレイに届くようにします。
ECサイトの購入手続き
発送のお知らせ、領収書、注文確認が、配信エラーなしで顧客に届くようにします。
リードとデモの申し込み
競合他社による偽の入力を除き、見込み客を営業担当者に回す前に会社のドメインを確認します。
ニュースレターの購読
購読の申し込み時に、形式の正しくない入力やボットの登録を拒否し、配信用ドメインのレピュテーションを守ります。
Webhookでの自動化
用意済みのZapierとn8nの連携を使って、フォームのWebhookでバリデーションを自動で実行します。
アカウント情報の変更
既存のユーザーがプロフィールや請求先の連絡先を変更したときに、新しいメールアドレスを確認します。
登録時に使うレスポンスのフィールド
フォームのバリデーションのロジックに必要な、主なJSONフィールドの一覧です。
| JSONフィールド | 型 | 登録時の使い方 |
|---|---|---|
| data.is_valid | boolean | すばやく確認できる真偽値です。ドメインとメールボックスのチェックに通るとtrueになります。 |
| data.status | string | 主な配信ステータスです:"deliverable"、"undeliverable"、"unknown"。 |
| data.deliverability_score | number (0-100) | メールボックスの応答、MXの安定性、レピュテーションのチェックをもとにした品質スコアです。 |
| data.details.attributes.disposable | boolean | ドメインが既知の一時的または使い捨ての受信トレイのサービスのときにtrueになります。 |
| data.details.attributes.free_email | boolean | 個人向けのプロバイダー(Gmail、Outlook)のときにtrueになります。B2Bのフォームでは会社のドメインを必須にできます。 |
| data.details.attributes.role_account | boolean | info@、admin@、support@のような組織のアドレスのときにtrueになります。 |
| data.catch_all_verdict | "valid" | "invalid" | null | キャッチオールドメインを同じ呼び出しで判定した結果です。有効な見込み客を削除せずに残せます。 |
エンドポイントの定義、パラメーターのスキーマ、エラーコードのすべては、APIリファレンスをご覧ください。
メールアドレスのバリデーションAPIの料金
実行したバリデーションの分だけ支払います。月額の最低料金や契約はありません。APIのバリデーション呼び出し1回につき1クレジットを使い、キャッチオールドメインのチェックも含まれます。不明の結果は自動で返却され、最初の1,000クレジットは無料です。
すべての料金プランと月額プランの割引は、料金ページをご覧ください。
メールアドレスのバリデーションAPIに関するよくある質問
登録フォームとリアルタイムのバリデーションの実装について、よくある質問への回答です。
はい。新しいアカウントには、登録時に無料クレジット1,000件が付きます。クレジットカードは不要です。開発者用のダッシュボードでAPIキーを作成すれば、すぐにフォームのリアルタイムのバリデーションを試せます。無料クレジットに有効期限はなく、バリデーションのすべての属性とチェックを使えます。
いいえ。クライアント側のJavaScriptからAPIを直接呼び出すと、ブラウザのネットワークのリクエストを見た人に秘密のAPIキーが知られてしまいます。ユーザーのフォームの入力は、必ず先に自社のバックエンドのサーバーかサーバーレス関数に送り、サーバーからhttps://api.giggal.ai/v1/verifyにリクエストしてください。
メッセージは一切送られません。APIはメールボックスが存在するかを確認し、メールのデータや本文を送る前に接続を閉じます。ユーザーの受信トレイには何も届きません。
はい。すべてのチェックで、ドメインを100,000以上の使い捨て、一時的なメールのドメインのリストと照合します。一致すると、details.attributes.disposableがtrueになり、ステータスはundeliverableになります。バックエンドで一時的なアカウントをブロックできます。
事業のモデルによります。個人向けのアプリでは、support@やinfo@のような役割アドレスが正規の組織のこともあります。ユーザー本人の責任が必要なセルフサービスのB2B SaaSでは、認証情報の共有による不正利用を防ぐため、一般的な役割アドレスに印を付けたり、使えなくしたりする会社が多くあります。
キャッチオールドメインは、すべての受信者のアドレスを無条件に受け付けるため、通常のチェックでは結論が出ません。このAPIは、同じ呼び出しの中でキャッチオールドメインのアドレスを詳しく検証し、メールボックスが存在するかを調べます。結果が"valid"なら登録を受け付けて問題ありません。"invalid"ならそのアドレスはバウンスするので、止めてください。
フェイルオープンの実装をおすすめします。バックエンドの呼び出しでネットワークのタイムアウトや接続エラーが起きたときは、見込み客をブロックせずに登録を完了させてください。バリデーションしていないアドレスはバックグラウンドの処理の順番待ちに入れ、後で配信ステータスをもう一度チェックします。
ウェブの登録フォームで、入力ミス、使い捨ての受信トレイ、ボットを送信の時点で止めたい場合は、メールアドレスのバリデーションAPIを選んでください。既存のマーケティング用データベースの点検、CRMの連絡先の同期、キャンペーン前の大量のメールリストのクリーニングには、メールアドレス検証APIを選んでください。
