跳到正文
D13-05开放 API1 分钟更新于 2026-11

限流设计

一句话

限流要返回明确错误码与重试建议。

本文目录8 节

限流设计

它解决什么

开放接口的限流要按商户与接口两个维度设置:总量限流会让大商户挤掉小商户,按商户配额更公平。限流的返回也要讲究——一律返回 500,调用方以为是自己代码错了,排查半天;返回明确的限流错误码与 Retry-After,调用方才知道该等多久。

怎么用

  • 按商户配额
  • 按接口维度
  • 返回限流码
  • 给出重试建议

一个判断

某平台被限流时返回 500,接入方以为是自己代码错,排查了两天才发现是限流。

边界

限流的边界是「公平与保护」:限得太松,一个商户打垮整个系统;限得太紧,正常业务被误伤。

一个反例

某平台被限流时返回 500,接入方以为是自己代码错,排查了两天才发现是限流。现在返回 429 加 Retry-After,文档写明处理方式。

常见误判

  • 一律返回 500。

自查清单

  • 知道这个模块的边界在哪
  • 知道它的状态机有哪几个状态
  • 知道它出错时的兜底路径
  • 知道它的数据存在哪张表

依据

  • 开放接口的限流策略。

相关:开放 API 的四件事要同时成立

相关阅读