级别
| 级别 | 特征 | 说明 |
|---|---|---|
| 0 | 单端点传参调用 | 本质 RPC 风格 |
| 1 | 资源化路径 | 按资源划分 URL |
| 2 | 动词与状态码 | 多数业务 API 的落点 |
| 3 | 超媒体驱动 | 服务端控制可达状态，客户端更通用 |
成熟度用于沟通定位而非评分：内部 API 停在级别 2 通常已足够。
Richardson 成熟度模型
用四级阶梯描述 HTTP API 的成熟程度：单端点 POST、资源化、使用 HTTP 动词与状态码、超媒体驱动；级别是沟通工具，不必盲目追求高等级。
易错点
- 把级别 3 当强制目标，投入与收益不匹配
- 级别 0 的接口对外暴露，与调用方预期不符
数据来源与参考
- Martin Fowler 博客：Richardson Maturity Model
- Leonard Richardson & Mike Amundsen《RESTful Web APIs》