Skip to content

配额与速率限制 ​

短信服务支持配额和速率控制。超出配额或速率限制时,接口会返回 HTTP 429 状态码,并返回对应错误码。

配额字段 ​

字段说明
total_quota总配额,0 表示无限。
used_quota已用配额,仅发送成功时累加。
rate_limit速率限制,格式为 次数:秒数。

返回码 ​

场景HTTP 状态码Code
配额已用尽429OverQuota
超过速率限制429RateLimitExceeded

量费规则 ​

  • 扣费从短信包余额中扣除,优先扣除最早过期的短信包(FIFO)。
  • 按短信内容长度计费:每 50 字计 1 条(不足 50 字按 1 条计算)。
  • 只有发送成功的短信才会扣除配额。
  • 发送失败不会扣除配额。
  • 无论成功或失败,系统都会记录发送日志,便于后续排查。

速率限制说明 ​

  • 默认速率限制为每分钟 100 条,可在短信后台进行配置。
  • 速率校验在防刷总开关开启时生效。
  • 同一用户、同一号码的频率都会受速率限制约束。