Appearance
配额与速率限制
短信服务支持配额和速率控制。超出配额或速率限制时,接口会返回 HTTP 429 状态码,并返回对应错误码。
配额字段
| 字段 | 说明 |
|---|---|
total_quota | 总配额,0 表示无限。 |
used_quota | 已用配额,仅发送成功时累加。 |
rate_limit | 速率限制,格式为 次数:秒数。 |
返回码
| 场景 | HTTP 状态码 | Code |
|---|---|---|
| 配额已用尽 | 429 | OverQuota |
| 超过速率限制 | 429 | RateLimitExceeded |
量费规则
- 扣费从短信包余额中扣除,优先扣除最早过期的短信包(FIFO)。
- 按短信内容长度计费:每 50 字计 1 条(不足 50 字按 1 条计算)。
- 只有发送成功的短信才会扣除配额。
- 发送失败不会扣除配额。
- 无论成功或失败,系统都会记录发送日志,便于后续排查。
速率限制说明
- 默认速率限制为每分钟 100 条,可在短信后台进行配置。
- 速率校验在防刷总开关开启时生效。
- 同一用户、同一号码的频率都会受速率限制约束。