开发apirestopenapi
REST API 设计评审
评审 API 的资源建模、错误码、版本策略与开发者体验。
提示词
请评审以下 API 设计（OpenAPI 片段或文字描述）。
```yaml
{粘贴 OpenAPI 或端点列表}
```
**使用场景**：{内部 / 公开 / 移动端}
**非功能需求**：{QPS、延迟、多租户等}
评审：
1. 资源命名与 REST 语义是否一致
2. 鉴权与权限模型是否清晰
3. 错误响应结构、错误码是否可编程处理
4. 分页、过滤、排序、幂等（POST/PUT/PATCH）
5. 版本与破坏性变更策略
6. 改进建议（按优先级）
引用具体端点举例说明。将 {花括号} 中的占位符替换为你的实际内容后再发送。