技术解析 · 附来源的解答

邮件 API 速率限制详解

邮件 API 速率限制是邮件服务提供商用来限制用户在特定时间段内可发起 API 请求数量的机制。它通过限制调用发送邮件、获取统计数据等端点的频率，防止系统被滥用，确保用户之间公平分配资源，并保护基础设施免受拒绝服务攻击。

实现机制

速率限制通常使用令牌桶或漏桶等算法实现。服务商按 API 密钥或 IP 地址统计请求数。当用户超过设定阈值时，服务器会拒绝后续请求，直到时间窗口重置。服务器会通过 HTTP 429 Too Many Requests 响应码告知客户端，通常还会附带 Retry After 头，以秒为单位指明需要等待的时间。

对发件人的重要性

对发件人而言，遵守速率限制对保持服务可用至关重要。超出限制可能导致账户被临时停用，或 API 密钥被永久封禁。妥善管理速率限制，才能确保密码重置、MFA 验证码等关键事务性邮件不间断地送达。这也促使开发者实现高效的队列系统，而不是依赖同步、突发式的流量模式。

常见操作错误

一个常见错误是没有在应用代码中实现指数退避。遇到 429 错误时，简单粗暴的系统会立即重试，这会进一步耗尽速率限制，还可能触发安全标记。另一个错误是忽视并发连接数限制与每秒请求数限制之间的区别，导致即使每小时总配额尚未用完也会出现超时。

实现示例

使用事务性邮件 API 的开发者可能会遇到每秒 14 个请求的限制。如果应用在一个循环中尝试发送 100 封邮件，前 14 封会成功，其余 86 封会因 429 错误而失败。为解决这个问题，开发者应使用 RabbitMQ 或 Redis 等消息队列，将外发请求限流到恰好每秒 14 个，保证流量平稳。

优化工具

为优化投递并避免触及限制，开发者可以使用 SendHQ 或其免费工具（https://sendhq.cc/tools）分析自己的基础设施，确保发信模式符合服务商的要求。监控 API 响应头可以根据实时的配额余量动态调整发送速度。

团队常问的问题

触及邮件 API 速率限制时会发生什么？

API 会返回 HTTP 429 Too Many Requests 错误。您的请求不会被处理，必须等到重置周期结束后才能再次尝试发送。

如何在代码中处理 429 错误？

实现指数退避。也就是说，第一次失败后等待一小段时间，此后每次失败都将等待时间按指数增加。

可以提高 API 速率限制吗？

可以。大多数服务商会根据账户等级、发送历史和经过验证的发送量提高限制。升级到付费套餐通常会提高这些阈值。

速率限制和发送配额是一回事吗？

不是。速率限制控制的是请求速度（例如每秒），而发送配额控制的是总量（例如每月）。

一手资料

继续学习

邮件 API事务性邮件 APIAmazon SES APISendGrid APIPostmark API