REST(Representational State Transfer)是一种用于构建网络应用程序的架构风格,特别适用于 Web API。RESTful Web API 是基于 REST 原则设计的 API,允许客户端与服务器之间进行交互。以下是 REST Web API 的一些关键概念和特点:
1. 资源(Resources)
- 在 REST 中,所有的内容都被视为资源。资源可以是用户、订单、产品等。
- 每个资源都有一个唯一的标识符,通常是一个 URL。例如,http://example.com/api/users/1 表示 ID 为 1 的用户资源。
2. HTTP 方法
RESTful API 使用标准的 HTTP 方法来操作资源:- GET:用于检索资源。客户端可以请求服务器上的资源。
- POST:用于创建新的资源。客户端可以向服务器发送数据以创建新资源。
- PUT:用于更新现有资源。客户端可以发送数据以更新指定的资源。
- DELETE:用于删除资源。客户端可以请求服务器删除指定的资源。
3. 无状态(Stateless)
- RESTful API 是无状态的,这意味着每个请求都是独立的,服务器不会存储客户端的状态信息。每个请求都必须包含所有必要的信息,以便服务器能够理解和处理请求。
4. 表现层(Representation)
- 资源可以有多种表现形式,例如 JSON、XML、HTML 等。客户端可以请求特定的表现形式,服务器将返回相应的格式。
- 在您的代码示例中,使用 JSON 作为数据交换格式。
5. 状态码(Status Codes)
- RESTful API 使用 HTTP 状态码来指示请求的结果。例如:
- 200 OK:请求成功。
- 201 Created:成功创建资源。
- 204 No Content:请求成功,但没有返回内容。
- 400 Bad Request:请求无效。
- 404 Not Found:请求的资源不存在。
- 500 Internal Server Error:服务器发生错误。
6. 统一接口(Uniform Interface)
- REST 的一个重要原则是统一接口,这使得 API 更加简单和一致。统一接口的设计使得客户端和服务器之间的交互更加清晰。
7. HATEOAS(Hypermedia as the Engine of Application State)
- HATEOAS 是 REST 的一个扩展,允许客户端通过超链接动态发现和操作资源。服务器在响应中提供相关资源的链接,客户端可以根据这些链接进行后续操作。
来源:GPT-4o-Mini
标签:Web,请求,REST,API,RESTful,资源,客户端 From: https://www.cnblogs.com/Nikole/p/18546495