api-development
Installation
SKILL.md
API 接口设计规范
核心规范
| 原则 | 说明 |
|---|---|
| RESTful 风格 | 使用标准 HTTP 方法表达语义 |
| 认证保护 | 所有业务接口必须添加认证注解 |
| 参数校验 | 使用分组校验区分新增/修改场景 |
| 统一响应 | 使用统一的响应格式包装返回数据 |
HTTP 方法规范
| 操作 | 方法 | 路径示例 |
|---|---|---|
| 列表查询 | GET | /list 或 /page |
| 获取详情 | GET | /{id} |
| 新增 | POST | / 或 /add |
| 修改 | PUT | / 或 /update |
Related skills