API 配额与限流响应

面向调用方的配额体系:按应用、用户与接口维度限制速率与总量,用响应头声明余额与重置时间,让客户端自助退避并配合告警。

响应头

响应头
HTTP/1.1 429 Too Many Requests
Retry-After: 30
RateLimit-Limit: 1000
RateLimit-Remaining: 0
RateLimit-Reset: 30
配额维度要与计费、审计口径一致;临时提额走配置流程,避免在代码内硬编码例外。

易错点

  • 限流无响应头提示,客户端无从退避反复撞墙
  • 配额只算网关层,绕过网关的内部调用不计入

数据来源与参考

  • IETF 草案:RateLimit header fields for HTTP(draft-ietf-httpapi-ratelimit-headers)
  • RFC 6585:429 Too Many Requests
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌