D13-05开放 API1 分钟更新于 2026-11
限流设计
一句话
限流要返回明确错误码与重试建议。
限流设计
它解决什么
开放接口的限流要按商户与接口两个维度设置:总量限流会让大商户挤掉小商户,按商户配额更公平。限流的返回也要讲究——一律返回 500,调用方以为是自己代码错了,排查半天;返回明确的限流错误码与 Retry-After,调用方才知道该等多久。
怎么用
- 按商户配额
- 按接口维度
- 返回限流码
- 给出重试建议
一个判断
某平台被限流时返回 500,接入方以为是自己代码错,排查了两天才发现是限流。
边界
限流的边界是「公平与保护」:限得太松,一个商户打垮整个系统;限得太紧,正常业务被误伤。
一个反例
某平台被限流时返回 500,接入方以为是自己代码错,排查了两天才发现是限流。现在返回 429 加 Retry-After,文档写明处理方式。
常见误判
- 一律返回 500。
自查清单
- 知道这个模块的边界在哪
- 知道它的状态机有哪几个状态
- 知道它出错时的兜底路径
- 知道它的数据存在哪张表
依据
- 开放接口的限流策略。
相关阅读