速率限制是每把密钥每秒或每分钟接受的最大 API 请求数;超过时 API 返回 429 和 Retry-After 标头,批量端点则用于高流量发送。
速率限制规定了一个凭据在一段时间内(通常是一秒或一分钟)最多能发出多少个请求。它保护平台免受失控循环的冲击,也保护每个账户不受他人程序缺陷的连带影响。实现方式各不相同:固定窗口按时钟区间统计请求数,滑动窗口回看一个随时间移动的区间,令牌桶则在维持平均速率的同时允许短时突发。表示“请求过多”的状态码是 429;设计良好的 API 会在 Retry-After 标头中说明需要等待多久,并在响应标头中公开剩余额度,让客户端能在触及限制之前放慢速度。
速率限制针对的是请求,而不是消息。一个携带一千条消息的请求只计一次,所以大批量发送应使用批量调用,而不是大量并行的单条发送。API 限制也不等同于吞吐量(即运营商送达消息的速度),也不等同于发送速度控制(即你为群发任务选择的发送速度)。
示例
假设一个注册服务把每条验证码都放在单独的请求中发送。促销期间注册量激增,服务开始收到 429 响应。解决办法不是增加密钥或线程:验证码改为经过一个遵守 Retry-After 的小型队列发送,而同一时间正在发出的新闻简报则改用批量请求。
常见错误
- 收到 429 后立即在紧密循环中重试,使客户端一直处于超限状态。
- 忽视剩余额度标头,直到请求开始失败。
- 把 429 当作消息发送失败;实际上什么都没有发送,之后使用同一幂等密钥重试是安全的。
- 把流量分散到额外的密钥上来规避限制,而不是使用批量请求。
在 SMSMeteor:限制为每个密钥每秒 50 个请求,一个最多包含 1,000 条消息的批次只算一个请求。响应带有 X-RateLimit-Limit 和 X-RateLimit-Remaining,429 响应则带有 Retry-After。由于限制按密钥计算,每个系统使用一把密钥,还能防止某个集成中失控的任务耗尽另一个集成的额度。
相关术语
深入了解
在实践中了解这个术语。一个电子邮箱地址即可开户,费率公开,支持加密货币付款,测试密钥免费。
开始发送
