全部產品
Search

搜尋本產品

    Direct Mail：ValidateEmail - 校正電子郵件

    文件中心

    Direct Mail：ValidateEmail - 校正電子郵件

    更新時間：Jan 07, 2026

    校正電子郵件地址。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    dm:ValidateEmail

    none

    *全部資源

    *

    		 無 無

    請求文法

    POST  HTTP/1.1

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Email

    string

    是

    待校正的電子郵件地址

    xxx@yyy.com
    Timeout

    integer

    否

    逾時時間，預設 60 秒

    20
    CheckGraylist

    boolean

    否

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

    true

    返回參數

    名稱

    類型

    描述

    樣本值

    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 :

      無效地址，拼字錯誤

    • MAILBOX_NOT_EXISTS :

      無效地址，郵箱不存在

    • SYSTEM_ERROR :

      未知狀態，系統錯誤

    • SYNTAX_INVALID :

      無效地址，語法錯誤

    • ROLE_ACCOUNT :

      非正常地址，角色帳號

    • SMTP_CONNECT_FAILED :

      未知狀態，串連對方 SMTP 伺服器失敗

    • DISABLED :

      無效地址，郵箱已被禁用

    • UNSPECIFIED :

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

    • IP_UNROUTABLE :

      無效地址，郵件伺服器 IP 不可達

    • 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"
}

    錯誤碼

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

    變更歷史

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