IPScanner

Agentscan

電郵檢查

在接受註冊前檢查電郵地址：語法、一次性電郵網域、郵件伺服器、拼寫錯誤及職能電郵。

檢查電郵地址

POST/v1/email/check
API 金鑰1 次請求

參數

  • emailstring必填

    要檢查的地址，最多 320 位元組。GET 請求以 ?email= 傳入。

回應欄位

  • emailstring

    已檢查的地址，網域轉為小寫。

  • statusstring

    valid、invalid、risky 或 unknown。

  • reasonstring | null

    原因：syntax、no_mx、null_mx、disposable、typo、role、dns_error 或 quota。valid 時為 null。

  • suggestionstring | null

    當網域似是某個常用電郵網域的拼寫錯誤時，提供修正後的地址。

  • domainstring

    ASCII 形式的網域（IDN 已轉換）。

  • checksobject

    決定狀態的每一項檢查。

  • checks.mxboolean | null

    該網域可接收電郵。未查詢 DNS 或 DNS 未回應時為 null。

  • checks.disposableboolean

    該網域提供一次性電郵。

  • checks.roleboolean

    共用信箱，例如 info@ 或 support@。

  • checks.freeProviderboolean

    免費電郵服務商，例如 Gmail 或 Outlook。

  • mailboxstring

    一律為 not_checked：不探測信箱本身。

curl -X POST https://ipscanner.io/v1/email/check \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"jane@outlok.com"}'
回應
{
  "email": "jane@outlok.com",
  "status": "risky",
  "reason": "typo",
  "suggestion": "jane@outlook.com",
  "domain": "outlok.com",
  "checks": {
    "syntax": true,
    "mx": true,
    "disposable": false,
    "role": false,
    "freeProvider": false
  },
  "mailbox": "not_checked"
}