CRUD 与错误场景映射
| 场景 | 推荐码 | 备注 |
|---|---|---|
| 读取成功 | 200 | 带表示 |
| 创建成功 | 201 + Location | 或 200（返回创建结果体） |
| 删除成功 | 204 | 无需返回体 |
| 异步受理 | 202 | 配任务状态 URL |
| 参数语法错误 | 400 | JSON 畸形等 |
| 参数语义校验失败 | 422 | 字段级错误明细 |
| 未认证/凭证过期 | 401 + WWW-Authenticate | 客户端刷新令牌 |
| 已认证无权限 | 403 | 不引导重登 |
| 资源不存在 | 404 | 聚合接口可整体 200 列明细 |
| 并发版本冲突 | 409 或 412 | 配合 If-Match |
| 限流 | 429 + Retry-After | 退避重试 |
| 未处理异常 | 500 | 日志留栈 |
校验映射的自测清单
校验映射的自测清单
# 每个核心接口至少覆盖：正常、未认证、无权限、不存在、参数错、限流六种用例