ValidateEmail - 校验电子邮件-邮件推送(Direct Mail)-阿里云帮助中心

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求语法

POST  HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
Email	string	是	待校验的电子邮件地址	xxx@yyy.com
Timeout	integer	否	超时时间，默认 60 秒	20

返回参数

名称	类型	描述	示例值
	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"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。