后端开发：RESTful API设计原则与最佳实践
REST（Representational State Transfer）是一种架构风格，而非标准。它定义了一组约束，用于创建简单、无状态和可缓存的服务。
一、核心原则：面向资源
RESTful API 应将数据视为资源。资源应该通过 URI 来定位和命名，而不是通过动词。
| HTTP 方法 (动词) | URI (资源) | 操作 |
|---|---|---|
| GET | /users | 检索用户列表 |
| POST | /users | 创建新用户 |
| PUT | /users/123 | 完整更新用户 123 |
| DELETE | /users/123 | 删除用户 123 |
二、状态码的应用
使用标准的 HTTP 状态码清晰地告知客户端请求结果：
- 200 OK： GET/PUT/PATCH/DELETE 成功。
- 201 Created： POST 请求成功，并创建了新资源。
- 400 Bad Request： 客户端提交的数据无效。
- 404 Not Found： 资源不存在。
- 500 Internal Server Error： 服务器端错误。
使用 JSON 作为数据交换格式，保持 API 的简洁和一致性，是现代后端开发的基本要求。