跳到内容
Esc
↑↓导航↵打开⌘J预览
本页内容

域名

验证发信域名,添加它的 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:

  • 有 订阅主题 或 分群 绑定在该域名上。请删除它,或把它的 domain_id 设为 null。
  • 有已定时或正在发送的 群发 使用该域名。请取消它,或等它发完。

删除域名时,它的收件箱也会一并删除。收件人对该域名的 退订 会保留,如果你再次添加同一个域名,这些退订会重新生效。

API 密钥与域名

API 密钥可以限定在某一个域名。这样的密钥只能从该域名发送,使用其他 from 会返回 403 restricted_api_key。它只能读取该域名收到的邮件,在 /domains 下只能看到并修改该域名(其他域名返回 404),它创建的密钥也限定在同一个域名。Webhook、抑制列表、模板,以及其余属于整个团队的内容,都会返回 403 restricted_api_key,API 密钥 页面列出了这些内容。密钥也可以限定在某一个 收件箱。

这个页面有帮助吗?