📐 优雅的 API 规范：RESTful 设计原则、状态码与版本控制

RESTful API：后端与前端的契约

一个设计良好的 **RESTful API** 是前后端高效协作的基础。它遵循 **无状态性** 和 **统一接口** 的原则，并以资源为中心进行设计。API 的优雅性体现在其 URL 路径、HTTP 方法和状态码 的准确使用上。

HTTP 动词与资源操作：

HTTP 方法	操作	示例路径
**GET**	获取资源	`/users/1`
**POST**	创建新资源	`/users`
**PUT/PATCH**	更新资源	`/users/1`
**DELETE**	删除资源	`/users/1`

应正确使用 **HTTP 状态码** 来表达操作结果（如 200 OK, 201 Created, 204 No Content, 400 Bad Request, 500 Internal Error）。同时，对于频繁变动的 API，应采用 **版本控制**（如 `v1/users`），以保障向后兼容性。清晰、语义化的 API 设计是后端代码 高可维护性 的重要体现。