メール検証APIドキュメント
はじめに
すべてのAPIリクエストには、APIキーを使用した認証が必要です。APIキーはダッシュボードで確認できます。
ヘッダー"x-api-key:あなたのapi-key"シングル検証
1つのEメールアドレスまたはドメインの有効性、使い捨てステータス、プライバシーサービス、配信可能性を検証します。
エンドポイント
GET /v1/verifyパラメータ
| 名称 | タイプ | 必須 | 説明 |
|---|---|---|---|
| input | string | はい | 確認する電子メールアドレスまたはドメイン(例:[email protected] または example.com) |
apiDocs.responseFields
| フィールド | 説明 |
|---|---|
| valid | 電子メールのフォーマットが正しいかどうかを示す |
| block | メールがブロックされるべきかどうかを示します (disposable、privacy、applePrivateEmail、deliverable または catch_all が true の場合は true)。 |
| disposable | 電子メールアドレスが一時的なものか使い捨てのものかを判断します。 |
| privacy | メールサーバーが電子メールのエイリアスまたはフォワーダーを利用しているかどうかを判断する。 |
| applePrivateEmail | メールがAppleのプライベートメールアドレスであるかどうかを示します。 |
| deliverable | メールボックスが存在し、メールを受信できるかどうかをチェックします。 |
| domain | メールアドレスのドメイン部分 |
| email_address | メールアドレス |
| catch_all | ドメインが、受信者アドレスに関係なくすべての受信メールを受け入れるキャッチオールメール設定を持っているかどうかを示します。 |
| mx_found | ドメインに有効なメールサーバ(MXレコード)があるかどうかを示します。 |
| remaining_credits | アカウントに残っているAPIクレジットの数 |
回答例
{
"valid": true,
"block": false,
"disposable": false,
"privacy": false,
"applePrivateEmail": false,
"deliverable": true,
"domain": "example.com",
"email_address": "[email protected]",
"catch_all": false,
"mx_found": true,
"error": null,
"remaining_credits": 99
}コード例
curl "https://api.verify-email.app/v1/[email protected]" \
-H "X-API-Key: your-api-key"試してみる
エンドポイントをテストするにはAPIキーが必要です。
一緒に試してみよう:
バッチ検証
1回のリクエストで複数のメールアドレスまたはドメインを検証します(最大100件)。
エンドポイント
POST /v1/verify/batchパラメータ
| 名称 | タイプ | 必須 | 説明 |
|---|---|---|---|
| inputs | array of strings | はい | 検証する電子メールアドレスまたはドメインの配列 |
コード例
curl -X POST "https://api.verify-email.app/v1/verify/batch" \
-H "Content-Type: application/json" \
-H "X-API-Key: your-api-key" \
-d '{
"inputs": [
"[email protected]",
"[email protected]"
]
}'試してみる
エンドポイントをテストするにはAPIキーが必要です。
異なるドメインで試してみてください: