11、RESTful API 开发全解析

RESTful API 开发全解析

1. API 结构选项 B

在之前的结构中，我们为每个资源在单个目录下创建了四个文件。而在选项 B 中，我们会创建四个目录：controllers、routes、repositories 和 services。在每个目录下，会根据类别数量创建子目录，且每个子目录中为每个资源创建一个文件。

2. 资源方法

REST 并不强制使用特定协议，但目前 HTTP 方法在 REST 协议中占据主导地位。以下是常见 HTTP 方法及其用途：
| 方法 | 用途 | 示例 | 缓存特性 |
| ---- | ---- | ---- | ---- |
| GET | 仅用于检索信息，不改变状态，代表读操作 | GET https://www.example.com/accounts
GET https://www.example.com/accounts/search?name=john
GET https://www.example.com/accounts?page=5 | 默认可缓存，有长度限制 |
| POST | 为特定资源创建新数据，可创建单行或多行 | POST https://www.example.com/accounts
POST https://www.example.com/accounts/myaccount_id/users | 默认不可缓存，无长度限制，数据通常在请求体中 |
| PUT | 通常用于更新现有资源状态，也可创建新数据，具有幂等性 | PUT https://www.example.com/accounts/{myaccount_id}