特殊的邮箱地址
本页由英文自动翻译。
阅读英文版注册表单常常拒绝完全有效的地址,比如带加号或撇号的,或者放过永远收不到邮件的地址。每个 Proxy Mail QA 地址都有一些变体,邮件仍会进入它的收件箱,所以两种情况都能检查。
下面的例子使用测试地址 k7f2x9ab12cd@mailclub.dev。换成你自己的即可。
能到达你收件箱的变体
Section titled “能到达你收件箱的变体”发给以下任一地址的邮件,都会进入和普通地址相同的收件箱。已于 2026 年 10 月 15 日在我们的邮件服务器上验证。
| 测试内容 | 地址 |
|---|---|
| 大写字母 | K7F2X9AB12CD@MAILCLUB.DEV |
| 加号标签 | k7f2x9ab12cd+signup@mailclub.dev |
| 撇号 | k7f2x9ab12cd+o'brien@mailclub.dev |
| & 符号 | k7f2x9ab12cd+r&d@mailclub.dev |
| 等号和问号 | k7f2x9ab12cd+a=b?c@mailclub.dev |
| 斜杠和百分号 | k7f2x9ab12cd+team/50%@mailclub.dev |
| 花括号、竖线和波浪号 | k7f2x9ab12cd+{x}|~y@mailclub.dev |
| 名称中的点 | k7f2x9ab12cd+first.last@mailclub.dev |
| 第二个加号 | k7f2x9ab12cd+a+b@mailclub.dev |
| 允许的最长名称(@ 前 64 个字符) | k7f2x9ab12cd+aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa@mailclub.dev |
+ 之后可以用字母、数字、! # $ % & ' * + - / = ? ^ _ ` { | } ~ 中的任意字符以及点(不能连续两个,也不能在末尾)。+ 之后的文字会显示在收件箱里的每封邮件上,你能看出邮件是发给哪个变体的。
自定义地址名(Add account → Custom name,或 API 中的 name)可以使用相同的字符,可出现在名称中的任意位置,总长最多 64 个:o'brien@mailclub.dev、r&d.team@mailclub.dev 或 {acme}@mailclub.dev。只有 + 不能使用,因为它表示标签的开始。
有些名称是保留的。用于运营邮件域名的词,如 admin、postmaster 或 noreply,以及我们自己的名称,不能出现在名称的任何位置。test@、demo@ 或 info@ 这类通用名称不能单独使用,因为陌生人会把它们当一次性地址随手输入,他们的邮件会发到你这里。加点你自己的内容:test-acme@mailclub.dev 就可以。
三段式域名:在 valida.te.it 上创建地址(添加账号中的域名选择器,或 API 中的 domain),检查表单是否接受 k7f2x9ab12cd@valida.te.it 这样的域名。有些表单只接受 @ 后有一个点。
有效,但这里没有收件箱能接收
Section titled “有效,但这里没有收件箱能接收”邮件标准允许这些地址,但我们的邮件服务器(以及大多数其他服务器)不接受,所以发给它们的邮件在到达前就会被拒收。它们适合用来检查投递失败时你的应用怎么处理。
| 测试内容 | 示例 |
|---|---|
| 带空格的引号名称 | "john doe"@mailclub.dev |
| 非拉丁字母的名称 | josé@mailclub.dev, 用户@mailclub.dev |
| 没有点的域名,只在私有网络内可用 | k7f2x9ab12cd@mailclub |
| @ 前 65 个或更多字符 | k7f2x9ab12cd+aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa@mailclub.dev |
你的应用应在尝试发送前就拒绝这些地址。它们不需要收件箱。
| 问题 | 示例 |
|---|---|
| 没有 @ | k7f2x9ab12cd.mailclub.dev |
| @ 前没有内容 | @mailclub.dev |
| @ 后没有内容 | k7f2x9ab12cd@ |
| 两个 @ | k7f2@x9@mailclub.dev |
| 有空格 | k7f2 x9@mailclub.dev |
| 名称开头或结尾有点 | .k7f2@mailclub.dev, k7f2.@mailclub.dev |
| 连续两个点 | k7f2..x9@mailclub.dev |
| 域名中有连续两个点 | k7f2x9ab12cd@mailclub..dev |
| 域名以连字符开头 | k7f2x9ab12cd@-mailclub.dev |
| 尖括号或逗号 | <k7f2>@mailclub.dev, k7f2,x9@mailclub.dev |
使用 API 或智能体
Section titled “使用 API 或智能体”REST API 和 MCP 工具在接受地址的地方都接受变体,并作用于普通地址。用 +tag 等待某个变体时,只会找到发给该变体的邮件;等待普通地址则会找到发给其中任何一个的邮件。照常传入 since(测试提交表单的时间)。
GET /v1/addresses/{address}/variants 会为你的某个地址列出以上全部:delivered、undeliverable 和 invalid,每项附带它测试的内容。见 REST API 参考。
地址放进 URL 路径时要编码:JavaScript 中的 encodeURIComponent 会把 ' 变成 %27,+ 变成 %2B,/ 变成 %2F,? 变成 %3F。
变体也能测试优惠规则:用普通地址和两个变体注册欢迎优惠,GET /v1/addresses/{address}/offers(MCP check_offers)会说明同一个人是否多次拿到优惠。Gmail 的点号技巧无法在这些域名上测试,因为在这里加点会变成另一个地址。
编程智能体可以根据上表自己生成变体:让它“试着用带撇号和加号标签的邮件地址注册,并检查验证码仍能收到”。
对本页有疑问?
可以用任何语言提问。文档可以立即回答,你也可以把问题发给 Proxy Mail QA 团队,他们会用英文回复。