メールリアルタイムチェック

POST/v1/realtime/check/email

1つのメールアドレスを 1〜10個のリアルタイムメールプロダクト に対して同期的にチェックします。エンジン、課金の契約、レスポンスの形状は電話エンドポイントと同一で、異なるのはシリーズと識別子の形式だけです。

パラメータ

フィールド	タイプ	必須	説明
`identifier`	string	はい	1つのメールアドレス。例: `user@example.com`。
`country`	string	いいえ	メールでは省略する必要があります。メールプロダクトとともに国コードを送信すると拒否されます。
`product_ids`	array<int>	はい	1〜10個のリアルタイムメールプロダクト ID の配列。

プロダクトの選択

メールプロダクトと電話プロダクトは 異なるシリーズであり、1つのリクエストで組み合わせることはできません。mode が realtime で かつシリーズがメール であるエントリの id をリアルタイムプロダクトから読み取ってください。この一覧は GET /v1/products に基づいています。ここでスラッグを渡しても機能せず、メール呼び出しに電話プロダクト ID を渡すと、一致しないシリーズとして拒否されます。

レスポンス例

{
  "request_id": "b7d2a1c4-9f3e-4a1b-8c5d-2e6f7a8b9c0d",
  "identifier": "user@example.com",
  "series": "email",
  "status": "succeeded",
  "request_status": "completed",
  "replayed": false,
  "total_reserved": 0.004000,
  "total_charged": 0.004000,
  "total_refunded": 0.000000,
  "results": [
    {
      "product_id": 49,
      "product": "insemailvalid-rt",
      "result": "valid",
      "cached": false,
      "billing_status": "charged",
      "charged_amount": 0.002000,
      "refunded_amount": 0.000000,
      "checked_at": "2026-09-13T10:00:00Z",
      "error_code": null
    }
  ]
}

上記の product_id の値は例です。実際のリクエストを送信する前に、現在のメールプロダクト ID をリアルタイムプロダクトで確認してください。request_id は UUID で、cached はトップレベルではなく各結果の内部にあります。

cURL の例

curl -X POST "https://api.zelnum.com/api/v1/realtime/check/email" \
  -H "X-API-Key: YOUR_KEY_HERE" \
  -H "Idempotency-Key: UNIQUE_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{"identifier":"user@example.com","product_ids":[49]}'

メール固有のエラー

HTTP	`code`	意味
400	`invalid_realtime_request`	アドレスの形式が不正、`country` が送信された、ID が別のシリーズに属する、または ID が指定されていない場合です。何も送信されず、課金もされません。
400	`idempotency_key_required`	`Idempotency-Key` ヘッダーがありません。
402	`insufficient_balance`	残高が予約額をカバーしていません。どの項目も開始されません。
409	`request_in_progress` / `idempotency_conflict`	同じキーでまだ実行中、または同じキーでペイロードが異なります。

残りのステータスコード — 401、403、429、503、500 — は、電話エンドポイントに記載されているとおりに動作します。