域名
验证发信域名,添加它的 DNS 记录,并配置追踪、收信和预热。
每封邮件都必须从你的团队已验证的域名发出。使用其他任何 from 地址都会被拒绝,返回 422。在控制台的 域名 中添加并验证域名,也可以通过 API 操作。
添加并验证域名
curl -X POST https://api.billionsend.com/domains \
-H "Authorization: Bearer $BILLIONSEND_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "name": "mail.example.com" }'
响应会列出需要在 DNS 服务商处添加的 DNS 记录。mail.example.com 这样的子域名很适合作为发信域名。记录生效后,在域名页面点击 验证,或调用 POST /domains/{id}/verify。
| 记录 | 用途 |
|---|---|
DKIM(两条 CNAME:bs1._domainkey 和 bs2._domainkey) |
为邮件签名,让服务商确认邮件来自你。 |
| MAIL FROM(MX 和 TXT) | 在你自己的域名上设置退信地址,使 SPF 对齐。 |
| DMARC(TXT,推荐) | 告诉服务商如何处理未通过检查的邮件。它不会阻止发送。 |
发送之前,DKIM 和 MAIL FROM 必须通过验证。在 Cloudflare 上,这些记录要保持 仅 DNS(灰色云朵)。
域名页面会对照公共 DNS 实时检查每条记录,并显示为已找到、缺失或不匹配。GET /domains/{id} 在 records[] 中返回同样的信息。每条记录都有一个 status(not_started、pending、verified 或 failed)、表示公共 DNS 当前返回内容的 live 值,出问题时还有一条简短的 detail。
DKIM 密钥自动轮换
BillionSend 为每个域名创建一把 DKIM 密钥,并每 180 天更换一次,在两条 CNAME 之间切换。记录只需添加一次,之后不用再动。可以在域名的 设置 标签页中关闭自动轮换。
区域
POST /domains 可以传一个可选的 region。一个域名只属于一个区域。要迁移,需先删除它,再在另一个区域重新添加,它的 DNS 记录也会随之改变。
套餐限制
| Free | Starter | Pro 和 Scale | |
|---|---|---|---|
| 每个团队的发信域名数 | 3 | 10 | 不限 |
超过上限后,POST /domains 返回 403 plan_limit_reached。如果域名已被其他团队占用,则返回 409。
新域名预热
新注册的域名在建立信誉期间,每日发送量有限制。上限取决于注册域名的年龄(mail.example.com 对应 example.com),并按 UTC 日计数:
| 域名年龄 | 每日邮件数 |
|---|---|
| 不足 1 天 | 100 |
| 1 天到不足 7 天 | 300 |
| 7 天到不足 30 天 | 2,000 |
| 30 天或更久 | 仅受套餐限制 |
- 发送质量良好(退信少、没有投诉)的域名,会更早升一档。
- 上限在套餐之外叠加生效。升级套餐不会解除它。
- 你的所有新域名共用一个每日发送量:再添加一个新域名不会增加发送量。
- 超出上限的邮件不会丢失。它们显示为 等待中,第二天按最早的先发出。如果已经有大量邮件在等待,发送会返回
429 daily_quota_exceeded,请在 UTC 日切换后重试。
存在上限期间,域名页面会显示「预热中:今日 N 封/天」。关于发送的所有保护措施,参见 发送限制。
设置
域名验证通过后,可使用以下设置:
- 打开与点击追踪。 两者默认关闭。在域名的 链接 标签页中开启,或在
PATCH /domains/{id}上使用open_tracking和click_tracking。参见 邮件追踪。 - 自有追踪与退订子域名。 用你自己的域名提供追踪链接和退订链接。需要付费套餐。参见 邮件追踪。
- 退订页面。 收件人看到的页面外观:名称、Logo、颜色和文字。在域名的 品牌 标签页中设置,或在
PATCH /domains/{id}上使用unsubscribe_page。参见 退订。 - 强制 TLS。 只向支持 TLS 的服务器投递。在 设置 标签页中设置。
- 默认发件人名称、发件地址和回复地址。 在 设置 标签页中设置。
收信
已验证的域名还可以 接收邮件。在域名页面点击 开启收信,或使用 PATCH /domains/{id}:
{ "capabilities": { "receiving": "enabled" } }
- 只有已验证的域名才能开启收信。带
"receiving": "enabled"的POST /domains会返回422:先添加域名,验证通过后再开启收信。 - 开启后会添加两条
Receiving记录:指向mx1.billionsend-dns.com和mx2.billionsend-dns.com的 MX 记录,优先级都是10。两条都要发布,这样发件方发现其中一台不可用时,会改用另一台重试。它们不影响发送。如果该域名已在别处收信,请把 MX 记录放在inbound.example.com这样的子域名上,因为编号更小的 MX 记录会抢走邮件。 - 一个域名只能在一个团队中收信。如果该域名已被其他团队用于收信,则返回
409。 - 默认只有你的 收件箱 的地址会收信。全域收信(catch-all) 会接收该域名下的所有地址。它需要付费套餐,可在控制台设置,或在
PATCH /domains/{id}上使用receiving_catch_all。
共享子域名
每个团队还会在 BillionSend 的共享域名下获得一个子域名,团队的共享 收件箱 在这里获得地址。它出现在 GET /domains 列表的末尾,带有 shared: true。它已经验证通过且只读:PATCH、验证和 DELETE 都返回 403 forbidden,也不计入域名数量上限。它只能用你的收件箱自己的地址发信。
删除域名
DELETE /domains/{id},或域名页面上的 删除,在两种情况下会被拒绝并返回 409:
删除域名时,它的收件箱也会一并删除。收件人对该域名的 退订 会保留,如果你再次添加同一个域名,这些退订会重新生效。
API 密钥与域名
API 密钥可以限定在某一个域名。这样的密钥只能从该域名发送,使用其他 from 会返回 403 restricted_api_key。它只能读取该域名收到的邮件,在 /domains 下只能看到并修改该域名(其他域名返回 404),它创建的密钥也限定在同一个域名。Webhook、抑制列表、模板,以及其余属于整个团队的内容,都会返回 403 restricted_api_key,API 密钥 页面列出了这些内容。密钥也可以限定在某一个 收件箱。