面试题：什么是 Restful 风格的接口？

RESTful（Representational State Transfer）是一种基于HTTP协议的软件架构风格，主要用于设计网络应用程序的接口。RESTful接口的核心思想是通过URL和HTTP方法（如GET、POST、PUT、DELETE等）对资源进行操作，使接口简洁、易读且符合HTTP协议的设计原则。

以下是RESTful风格接口的核心特点及其解释：

1. 资源导向

RESTful接口的核心是资源，每个资源通过唯一的URL标识。资源可以是任何实体，如用户、订单、商品等。

示例：
- /users：表示用户资源集合。
- /users/1：表示ID为1的用户资源。

2. HTTP方法表示操作

RESTful接口使用HTTP方法（GET、POST、PUT、DELETE等）来表示对资源的操作：

HTTP方法	操作类型	描述
`GET`	查询	获取资源（单个或列表）。
`POST`	创建	创建新资源。
`PUT`	更新	更新整个资源（替换）。
`PATCH`	更新	更新资源的部分内容。
`DELETE`	删除	删除资源。

示例：
- GET /users：获取所有用户。
- GET /users/1：获取ID为1的用户。
- POST /users：创建一个新用户。
- PUT /users/1：更新ID为1的用户（全部字段）。
- PATCH /users/1：更新ID为1的用户（部分字段）。
- DELETE /users/1：删除ID为1的用户。

3. 无状态性

RESTful接口是无状态的，即每次请求都包含足够的信息来完成操作，服务器不会保存客户端的状态。客户端需要在每次请求中携带必要的身份验证和参数。

示例：
- 使用Token或API Key进行身份验证，而不是依赖服务器的Session。

4. 返回标准HTTP状态码

RESTful接口使用标准的HTTP状态码来表示请求的结果：

状态码	描述
`200`	请求成功。
`201`	资源创建成功。
`204`	请求成功，无返回内容。
`400`	请求参数错误。
`401`	未授权。
`403`	禁止访问。
`404`	资源未找到。
`500`	服务器内部错误。

示例：
- 成功创建用户：返回201状态码。
- 用户未找到：返回404状态码。

5. 返回JSON或XML格式的数据

RESTful接口通常使用JSON或XML格式返回数据，JSON更常用。

示例：

获取用户信息：

{
  "id": 1,
  "name": "John Doe",
  "email": "john@example.com"
}

6. URI设计规范

RESTful接口的URI设计应简洁、清晰，遵循以下规范：

使用名词表示资源，而不是动词。
使用复数形式表示资源集合。
使用层级关系表示资源之间的关联。
避免在URI中使用动词。
示例：
- 获取用户的所有订单：GET /users/1/orders。
- 获取用户的某个订单：GET /users/1/orders/100。

7. 版本控制

为了兼容性，RESTful接口通常需要支持版本控制。版本号可以放在URL中或HTTP头中。

示例：
- URL中：/v1/users。
- HTTP头中：Accept: application/vnd.example.v1+json。

RESTful接口的示例

以下是一个典型的RESTful接口设计：

操作	HTTP方法	URI	描述
获取所有用户	`GET`	`/users`	返回用户列表。
获取单个用户	`GET`	`/users/1`	返回ID为1的用户。
创建用户	`POST`	`/users`	创建一个新用户。
更新用户	`PUT`	`/users/1`	更新ID为1的用户。
删除用户	`DELETE`	`/users/1`	删除ID为1的用户。
获取用户的订单	`GET`	`/users/1/orders`	返回ID为1的用户的所有订单。