tempemail-sdk 1.2.0

临时邮箱 SDK，所有渠道返回统一标准化格式

tempmail-sdk (Python)

临时邮箱 SDK（Python），支持 21 个邮箱服务提供商，顺序与 client.py 中 ALL_CHANNELS 一致，返回格式与根目录 README 描述一致。

安装

# 从 PyPI
pip install tempemail-sdk

# 从 GitHub Release（wheel）
pip install https://github.com/XxxXTeam/tempmail-sdk/releases/latest/download/tempemail_sdk-1.1.0-py3-none-any.whl

支持的渠道

渠道	服务商	需要 Token	说明
tempmail	tempmail.ing	-	支持自定义有效期
tempmail-cn	tempmail.cn	-	Socket.IO：request shortid / set shortid / mail；GenerateEmailOptions.domain 可指定自定义接入域名
linshi-email	linshi-email.com	-
linshiyou	linshiyou.com	✅	NEXUS_TOKEN + Cookie；HTML 分段解析
mffac	mffac.com	✅	mailbox id；REST 24h
tempmail-lol	tempmail.lol	✅	支持指定域名
chatgpt-org-uk	mail.chatgpt.org.uk	✅	Inbox Token 等由 SDK 封装
temp-mail-io	temp-mail.io	-
awamail	awamail.com	✅	Session Cookie 自动管理
temporary-email-org	temporary-email.org	✅	GET /zh/messages Cookie + XHR 收信
mail-tm	mail.tm	✅	自动注册账号获取 Bearer Token
mail-cx	mail.cx	✅	api.mail.cx OpenAPI；GenerateEmailOptions.domain 可选
dropmail	dropmail.me	✅	GraphQL API
guerrillamail	guerrillamail.com	✅	公开 JSON API
maildrop	maildrop.cx	✅	REST：suffixes.php + emails.php；description→text
smail-pw	smail.pw	✅	__session Cookie；正则 + JSON 遍历解析 Flight 中的邮件行对象
boomlify	boomlify.com	-	domains/public + emails/public/create；地址 {UUID}@{域名}
minmail	minmail.app	✅	visitor-id / ck 等序列化在 token（JSON）
vip-215	vip.215.im	✅	POST 建箱 + WebSocket；无正文时 synthetic 兜底
anonbox	anonbox.net	✅	GET /en/ 解析 HTML + mbox 收信
fake-legal	fake.legal	-	/api/domains + /api/inbox/new；可选 GenerateEmailOptions.domain

快速开始

from tempmail_sdk import generate_email, get_emails, GenerateEmailOptions, GetEmailsOptions

# 创建临时邮箱
info = generate_email(GenerateEmailOptions(channel="guerrillamail"))
print(f"邮箱: {info.email}")

# 获取邮件
result = get_emails(GetEmailsOptions(
    channel=info.channel,
    email=info.email,
    token=info.token,
))
if result.success:
    print(f"收到 {len(result.emails)} 封邮件")

使用客户端类

from tempmail_sdk import TempEmailClient, GenerateEmailOptions

client = TempEmailClient()
info = client.generate(GenerateEmailOptions(channel="maildrop"))
result = client.get_emails()

日志

from tempmail_sdk import set_log_level, LOG_DEBUG

set_log_level(LOG_DEBUG)  # 开启所有日志

代理与 HTTP 配置

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

from tempmail_sdk import set_config

# 一行跳过 SSL 验证
set_config(insecure=True)

# 设置代理
set_config(proxy="http://127.0.0.1:7890")

# 设置代理 + 超时 + 跳过 SSL 验证
set_config(proxy="socks5://127.0.0.1:1080", timeout=30, insecure=True)

# 添加自定义请求头
set_config(headers={"X-Custom": "value"})

配置项（SDKConfig / set_config）：

参数	类型	说明
proxy	str	代理 URL（http/https/socks5）
timeout	int	全局超时秒数，默认 15
insecure	bool	跳过 SSL 验证（调试用）
headers	dict	自定义请求头
dropmail_auth_token 等	见 config.py	DropMail DROPMAIL_* 环境变量亦可
telemetry_enabled	Optional[bool]	None 默认开启；False 关闭匿名遥测
telemetry_url	Optional[str]	覆盖默认上报 URL

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

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 TEMPMAIL_TELEMETRY_ENABLED=false
export TEMPMAIL_TELEMETRY_URL="https://example.com/v1/event"

匿名遥测

默认 开启：批量 POST 匿名事件（schema_version: 2），内置默认 URL 见 telemetry.py。关闭：TEMPMAIL_TELEMETRY_ENABLED=false（或 0 / no）或 set_config(telemetry_enabled=False)；改 URL：TEMPMAIL_TELEMETRY_URL 或 telemetry_url。

重试配置

from tempmail_sdk import generate_email, GenerateEmailOptions, RetryConfig

info = generate_email(GenerateEmailOptions(
    channel="temp-mail-io",
    retry=RetryConfig(max_retries=3, initial_delay=2.0),
))

拉取邮件同样可传 GetEmailsOptions(retry=RetryConfig(...))。