tempmail-sdk (Rust)

临时邮箱 SDK（Rust），公开 279 个 channel 标识，按独立服务商合并为 109 个 provider。固定域名、裸域、镜像域名和同一 API 的多域名只算同一个独立服务商。所有渠道返回统一标准化格式。顺序与 client.rs 中 ALL_CHANNELS 一致，并与 Go / npm / Python / C 的 listChannels 顺序对齐。随机生成邮箱时会在本端独立打乱尝试顺序，不需要与其他 SDK 的随机顺序一致。

安装

# 从 crates.io
[dependencies]
tempmail-sdk = "1.1.0"

# 从 GitHub
[dependencies]
tempmail-sdk = { git = "https://github.com/XxxXTeam/tempmail-sdk", subdirectory = "sdk/rust" }

支持的渠道

快速开始

use tempmail_sdk::{generate_email, get_emails, GenerateEmailOptions, Channel};

fn main() {
    let opts = GenerateEmailOptions {
        channel: Some(Channel::GuerrillaMail),
        ..Default::default()
    };
    if let Some(info) = generate_email(&opts) {
        println!("邮箱: {}", info.email);
        // channel / email / token 由 SDK 从 EmailInfo 读取
        let result = get_emails(&info, None);
        println!("success={} count={}", result.success, result.emails.len());
    }
}

使用客户端类

use tempmail_sdk::{TempEmailClient, GenerateEmailOptions, Channel};

let mut client = TempEmailClient::new();
if client.generate(&GenerateEmailOptions {
    channel: Some(Channel::Maildrop),
    ..Default::default()
}).is_some() {
    let _result = client.get_emails(None).expect("get_emails");
}

代理与 HTTP 配置

SDK 支持全局配置代理、超时等 HTTP 客户端参数，也可通过环境变量零代码配置：

use tempmail_sdk::{set_config, SDKConfig};

// 一行跳过 SSL 验证
set_config(SDKConfig { insecure: true, ..Default::default() });

// 设置代理
set_config(SDKConfig {
    proxy: Some("http://127.0.0.1:7890".into()),
    ..Default::default()
});

// 设置代理 + 超时 + 跳过 SSL 验证
set_config(SDKConfig {
    proxy: Some("socks5://127.0.0.1:1080".into()),
    timeout_secs: 30,
    insecure: true,
});

配置项（SDKConfig）：

环境变量（无需修改代码）：

export TEMPMAIL_PROXY="http://127.0.0.1:7890"
export TEMPMAIL_INSECURE=1
export TEMPMAIL_TIMEOUT=30
export DROPMAIL_AUTH_TOKEN="af_..."
export DROPMAIL_NO_AUTO_TOKEN=1
export DROPMAIL_RENEW_LIFETIME=1d
export TEMPMAIL_TELEMETRY_ENABLED=false
export TEMPMAIL_TELEMETRY_URL="https://example.com/v1/event"

匿名遥测

默认 开启：批量上报匿名事件（schema_version: 2），默认 URL 见 src/telemetry.rs。关闭：TEMPMAIL_TELEMETRY_ENABLED=false 或 set_config(SDKConfig { telemetry_enabled: Some(false), .. })；改 URL：TEMPMAIL_TELEMETRY_URL 或 telemetry_url。

HTTP 重试

GenerateEmailOptions 与 GetEmailsOptions 均支持 retry: Option<RetryConfig>（最大次数、初始延迟等），与 npm / Go / Python 行为一致。

日志

需要配合 env_logger 或其他 log 实现：

env_logger::init();
tempmail_sdk::set_log_level(tempmail_sdk::LogLevelFilter::Debug);