## 什么是 RESTful？

REST 是一种架构风格，核心是用 HTTP 方法操作资源。好的 API 设计让开发者用起来舒服。

## 核心原则

### 1. 资源命名

```
✅ /users          # 复数名词
✅ /users/123      # 具体资源
❌ /getUsers       # 避免动词
```

### 2. HTTP 方法语义

| 方法 | 用途 | 幂等性 |
|------|------|--------|
| GET | 获取资源 | 是 |
| POST | 创建资源 | 否 |
| PUT | 更新资源 | 是 |
| DELETE | 删除资源 | 是 |

### 3. 状态码使用

```python
200 OK          # 成功
201 Created     # 创建成功
400 Bad Request # 客户端错误
401 Unauthorized# 未认证
404 Not Found   # 资源不存在
500 Server Error# 服务器错误
```

## 版本控制

```
/api/v1/users
/api/v2/users
```

好的 API 设计是产品成功的关键！

<h2 id="heading-1">什么是 RESTful？</h2>
<p>REST 是一种架构风格，核心是用 HTTP 方法操作资源。好的 API 设计让开发者用起来舒服。</p>
<h2 id="heading-2">核心原则</h2>
<h3 id="heading-3">1. 资源命名</h3>
<pre><code>✅ /users          # 复数名词
✅ /users/123      # 具体资源
❌ /getUsers       # 避免动词
</code></pre>
<h3 id="heading-4">2. HTTP 方法语义</h3>
<table>
<thead>
<tr>
<th>方法</th>
<th>用途</th>
<th>幂等性</th>
</tr>
</thead>
<tbody><tr>
<td>GET</td>
<td>获取资源</td>
<td>是</td>
</tr>
<tr>
<td>POST</td>
<td>创建资源</td>
<td>否</td>
</tr>
<tr>
<td>PUT</td>
<td>更新资源</td>
<td>是</td>
</tr>
<tr>
<td>DELETE</td>
<td>删除资源</td>
<td>是</td>
</tr>
</tbody></table>
<h3 id="heading-5">3. 状态码使用</h3>
<pre><code class="language-python">200 OK          # 成功
201 Created     # 创建成功
400 Bad Request # 客户端错误
401 Unauthorized# 未认证
404 Not Found   # 资源不存在
500 Server Error# 服务器错误
</code></pre>
<h2 id="heading-6">版本控制</h2>
<pre><code>/api/v1/users
/api/v2/users
</code></pre>
<p>好的 API 设计是产品成功的关键！</p>


什么是 RESTful？ REST 是一种架构风格，核心是用 HTTP 方法操作资源。好的 API 设计让开发者用起来舒服。 核心原则 1. 资源命名 2. HTTP 方法语义 | 方法 | 用途 | 幂等性 | | | | | | GET | 获取资源 | 是 | | POST | 创建资源 | 否 | | PUT ...

RESTful API 设计规范与实战

什么是 RESTful？

核心原则

1. 资源命名

2. HTTP 方法语义

3. 状态码使用

版本控制

评论 0

为你推荐

精选内容

方法	用途	幂等性
GET	获取资源	是
POST	创建资源	否
PUT	更新资源	是
DELETE	删除资源	是