全部產品
Search

搜尋本產品

    Direct Mail：ValidateEmail

    文件中心

    Direct Mail：ValidateEmail

    更新時間：Jun 23, 2026

    驗證電子郵件地址。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    dm:ValidateEmail

    none

    *All Resource

    *

    		 無 無

    請求文法

    POST  HTTP/1.1

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Email

    string

    是

    待驗證的電子郵件地址

    xxx@yyy.com
    Timeout

    integer

    否

    逾時時間，預設 60 秒

    20
    CheckGraylist

    boolean

    否

    是否檢查灰名單，預設為否。結果將透過 eventbridge 非同步通知

    true
    ProbeType

    string

    否

    檢測類型：

    • FULL：啟用全部檢測能力，包括 SMTP 探測。由於 SMTP 探測涉及遠端連線，整體延遲較高，適用於對回應時間不敏感的場景。單次檢測消耗 1 個地址驗證額度。

    • BASIC_ONLY：啟用除 SMTP 探測外的所有檢測能力，延遲低。適用於對回應時間敏感的場景，例如註冊環節即時驗證郵箱地址是否為一次性郵箱或 MX 轉發等異常地址，以防禦黑灰產批量註冊。單次檢測消耗 1/3 個地址驗證額度。

    FULL

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Schema of Response

    RequestId

    string

    請求 ID

    xxxx-xxxx-xxxx-xxxx
    Status

    string

    驗證得到的電子郵件地址狀態

    枚舉值：

    • VALID :

      有效地址

    • CATCHALL :

      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 :

      沒有說明，有效、CatchAll、未知狀態可能返回

    • 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

    樣本

    正常返回樣本

    JSON格式

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

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。