すべてのプロダクト
Search
ドキュメントセンター

Direct Mail:ValidateEmail

最終更新日:Jul 14, 2026

メールアドレスを検証します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

dm:ValidateEmail

none

*All Resource

*

なし なし

リクエスト構文

POST  HTTP/1.1

リクエストパラメーター

パラメーター

必須 / 任意

説明

Email

string

必須

検証対象の有効なメールアドレス。

xxx@yyy.com

Timeout

integer

任意

タイムアウト期間。デフォルト値: 60 秒。

20

CheckGraylist

boolean

任意

グレーリストを確認するかどうかを指定します。デフォルト値: false。結果は EventBridge を通じて非同期に通知されます。

true

ProbeType

string

任意

プロービングタイプ。有効な値:

  • FULL: SMTP プロービングを含むすべての検出機能を有効にします。SMTP プロービングにはリモート接続が伴うため、全体的なレイテンシが高くなります。この値は応答時間に敏感ではないシナリオに適しています。各検出で住所検証クォータが 1 つ消費されます。

  • BASIC_ONLY: SMTP プロービングを除くすべての検出機能を有効にし、低レイテンシで実行します。この値は応答時間に敏感なシナリオ(登録時のリアルタイム検証で、メールアドレスが使い捨てメールボックスや MX 転送された異常アドレスかどうかを確認し、サイバー地下エコノミー型チェーンによるバッチ登録を防止するなど)に適しています。各検出で住所検証クォータの 1/3 が消費されます。

FULL

レスポンスフィールド

フィールド

説明

object

レスポンスのスキーマ。

RequestId

string

リクエスト ID。

xxxx-xxxx-xxxx-xxxx

Status

string

検証から取得した有効なメールアドレスのステータス。

列挙値:

  • VALID :

    有効なアドレス。

  • CATCHALL :

    キャッチオールアドレス。ドメイン名配下の存在しないすべてのメールボックスアドレスに送信されたメールをドメインが受け入れることを示します。

  • UNKNOWN :

    ステータス不明のアドレス。

  • INVALID :

    有効でないアドレス。

  • DONOTMAIL :

    マーケティングシナリオで除外できる異常アドレス。

VALID

SubStatus

string

検証から取得した有効なメールアドレスのサブステータス。ステータスの詳細な説明を提供します。

列挙値:

  • NO_DNS_ENTRIES :

    有効でないアドレス。DNS レコードが存在しません。

  • MISSPELLED :

    有効でないアドレス。アドレスのスペルが誤っています。

  • DOES_NOT_ACCEPT_MAIL :

    有効でないアドレス。メールサーバーがメールを受け付けません。

  • MAILBOX_NOT_EXISTS :

    有効でないアドレス。メールボックスが存在しません。

  • SYSTEM_ERROR :

    ステータス不明。システムエラーが発生しました。

  • MX_FORWARD :

    異常アドレス。MX 転送が設定されています。

  • SYNTAX_INVALID :

    有効でないアドレス。構文エラーが存在します。

  • ROLE_ACCOUNT :

    異常アドレス。role@、info@、contact@ などのロールアカウントです。

  • SMTP_CONNECT_FAILED :

    ステータス不明。リモート SMTP サーバーへの接続に失敗しました。

  • DISABLED :

    有効でないアドレス。メールボックスが無効化されています。

  • UNSPECIFIED :

    未指定。有効、キャッチオール、またはステータス不明のアドレスに対してこの値が返される場合があります。

  • IP_UNROUTABLE :

    有効でないアドレス。メールサーバーの IP アドレスに到達できません。

  • GRAY_LIST :

    ステータス不明。アドレスがグレーリストに登録されています。

  • MAILBOX_FULL :

    有効でないアドレス。メールボックスが満杯です。

  • DISPOSABLE :

    異常アドレス。ブラックリストにある使い捨てメールボックスです。

  • TIMEOUT_EXCEEDED :

    ステータス不明。指定されたタイムアウト期間を超えました。

UNSPECIFIED

Provider

string

アドレスのメールプロバイダー分類。

列挙値:

  • Others :

    その他。

  • Yahoo :

    Yahoo。

  • Gmx :

    Gmx。

  • MailDotCom :

    MailDotCom。

  • Tencent :

    Tencent。

  • Gmail :

    Gmail。

  • Outlook :

    Outlook。

  • Zoho :

    Zoho。

  • Proton :

    Proton。

  • Netease :

    Netease。

  • Icloud :

    Icloud。

  • Webde :

    Webde。

Gmail

IsFreeMail

boolean

アドレスがフリーメールボックスかどうかを示します。

列挙値:

  • true :

    true。

  • false :

    false。

true

LocalPart

string

構文検証から解析された有効なメールアドレスのローカルパート(小文字に変換され、プラス署名以降の部分が削除されています)。

xxx

DomainPart

string

構文検証から解析された有効なメールアドレスのドメインパート(小文字に変換されています)。

yyy.com

成功レスポンス

JSONJSON

{
  "RequestId": "xxxx-xxxx-xxxx-xxxx",
  "Status": "VALID",
  "SubStatus": "UNSPECIFIED",
  "Provider": "Gmail",
  "IsFreeMail": true,
  "LocalPart": "xxx",
  "DomainPart": "yyy.com"
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。