3 个稳定版本

1.1.1	2024年3月20日
1.1.0	2023年9月14日
1.0.0	2021年11月3日

#60 在电子邮件

MIT 许可证

39KB
120 行

MailboxValidator Rust 包

此 Rust 包使用户能够轻松验证电子邮件地址是否有效、是否为一次性电子邮件或免费电子邮件。

此模块可以用于许多类型的项目，例如

在注册期间验证用户的电子邮件
在发送电子邮件之前清理您的邮件列表
进行欺诈检查
等等

安装

只需将 mailboxvalidator = "1.1.0" 添加到您的 Cargo.toml。

依赖关系

此模块需要 API 密钥才能运行。

前往 https://www.mailboxvalidator.com/plans#api 注册免费 API 计划，您将获得一个 API 密钥。

函数

validate_email(email_address)

对提供的电子邮件地址进行电子邮件验证。

返回字段

字段名称	描述
email_address	输入电子邮件地址。
domain	电子邮件地址的域名。
is_free	该电子邮件地址是否来自像 Gmail 或 Hotmail 这样的免费电子邮件提供商。返回值：True，False
is_syntax	电子邮件地址是否语法正确。返回值：True，False
is_domain	电子邮件地址是否在其 DNS 条目中有有效的 MX 记录。返回值：True，False，- （- 表示不适用）
is_smtp	MX 记录中指定的邮件服务器是否对连接做出响应。返回值：True，False，- （- 表示不适用）
is_verified	邮件服务器是否确认该电子邮件地址确实存在。返回值：True，False，- （- 表示不适用）
is_server_down	邮件服务器当前是否关闭或不响应。返回值：True，False，- （- 表示不适用）
is_greylisted	邮件服务器是否采用灰名单策略，其中电子邮件必须稍后再次发送。返回值：True，False，- （- 表示不适用）
is_disposable	该电子邮件地址是否来自一次性电子邮件提供商。返回值：True，False，- （- 表示不适用）
is_suppressed	该电子邮件地址是否在我们的黑名单中。返回值：True，False，- （- 表示不适用）
is_role	电子邮箱地址是否是像[email protected]或[email protected]这样的基于角色的电子邮箱地址。返回值：True，False，-（-表示不适用）
is_high_risk	电子邮箱地址是否包含高风险关键词。返回值：True，False，-（-表示不适用）
is_catchall	电子邮箱地址是否是通配邮箱地址。返回值：True，False，Unknown，-（-表示不适用）
mailboxvalidator_score	电子邮箱地址信誉分数。分数>0.70表示良好；分数>0.40表示公平；分数<=0.40表示较差。
time_taken	获取结果所需的时间（秒）。
status	根据所有前面的字段，我们的系统是否认为电子邮箱地址是有效的。返回值：True，False
credits_available	可用于执行验证的信用额度数量。
error_code	如有错误，显示错误代码。请参阅下文中的错误表。
error_message	如有错误，显示错误信息。请参阅下文中的错误表。

is_disposable_email(email_address)

检查提供的电子邮箱地址是否来自一次性电子邮箱服务提供商。

返回字段

字段名称	描述
email_address	输入电子邮件地址。
is_disposable	电子邮箱地址是否来自一次性电子邮箱服务提供商的临时邮箱。返回值：True，False
credits_available	可用于执行验证的信用额度数量。
error_code	如有错误，显示错误代码。请参阅下文中的错误表。
error_message	如有错误，显示错误信息。请参阅下文中的错误表。

is_free_email(email_address)

检查提供的电子邮箱地址是否来自免费电子邮箱服务提供商。

返回字段

字段名称	描述
email_address	输入电子邮件地址。
is_free	该电子邮件地址是否来自像 Gmail 或 Hotmail 这样的免费电子邮件提供商。返回值：True，False
credits_available	可用于执行验证的信用额度数量。
error_code	如有错误，显示错误代码。请参阅下文中的错误表。
error_message	如有错误，显示错误信息。请参阅下文中的错误表。

示例代码

验证电子邮箱

use mailboxvalidator;

let validation_result = mailboxvalidator::validate_email("[email protected]",PASTE_API_KEY_HERE);

match validation_result {
    Ok(num) => {
        let ok_result = num;
        println!("{:#?}", ok_result);
    },
    Err(err) => println!("{:#?}", err),
};

检查电子邮箱是否来自一次性电子邮箱服务提供商

use mailboxvalidator;

let validation_result = mailboxvalidator::is_disposable_email("[email protected]",PASTE_API_KEY_HERE);

match validation_result {
    Ok(num) => {
        let ok_result = num;
        println!("{:#?}", ok_result);
    },
    Err(err) => println!("{:#?}", err),
};

检查电子邮箱是否来自免费电子邮箱服务提供商

use mailboxvalidator;

let validation_result = mailboxvalidator::is_free_email("[email protected]",PASTE_API_KEY_HERE);

match validation_result {
    Ok(num) => {
        let ok_result = num;
        println!("{:#?}", ok_result);
    },
    Err(err) => println!("{:#?}", err),
};

错误

error_code	error_message
10000	缺少参数。
10001	API密钥未找到。
10002	API密钥已禁用。
10003	API密钥已过期。
10004	信用额度不足。
10005	未知错误。

版权

依赖关系

~4–15MB
~230K SLoC