什么是REST API？

REST API（Representational State Transfer Application Programming Interface）是一种基于 REST 架构风格的接口，用于通过 HTTP 协议在客户端和服务器之间传输数据。REST API 常用于 Web 开发，尤其是前后端分离的架构中，便于不同平台（如移动端、前端和后台服务）之间的数据交互。

REST API 的基本原理

REST（Representational State Transfer）是一个软件架构风格，核心思想是无状态（stateless），即每个请求都包含所需的信息，服务器无需记忆客户端的状态。REST API 遵循一定的设计原则和 HTTP 请求方法。

常用 HTTP 方法与操作

GET：用于从服务器检索资源（数据）。

POST：用于在服务器上创建资源。

PUT：用于更新服务器上的资源。

DELETE：用于删除服务器上的资源。

这些方法是 REST API 的核心操作，可以完成增删查改功能。

REST API 的结构

REST API 使用统一的资源路径和 HTTP 方法来表示资源和操作。一般来说，一个资源对应一个 URL 路径，例如：

GET /api/users：获取所有用户。

GET /api/users/{id}：获取特定用户的信息。

POST /api/users：创建新用户。

PUT /api/users/{id}：更新特定用户的信息。

DELETE /api/users/{id}：删除特定用户。

REST API 的特点

1、无状态性：每个请求都包含所需的全部信息，服务器不存储会话数据。

2、资源导向：通过 URL 定位资源，资源的不同操作通过 HTTP 方法实现。

3、统一接口：REST API 接口具有一致性，便于理解和使用。

4、可缓存：REST API 支持缓存，以减少服务器负载和提升性能。

REST API 的数据格式

常用的数据格式是 JSON（JavaScript Object Notation），因其轻量且人类可读，非常适合在 Web 和移动端应用中使用。例如：

{
    "id": 1,
    "name": "Alice",
    "email": "alice@example.com"
}

REST API 的优势

跨平台支持：不同平台（如 Web、iOS、Android）可以通过 REST API 通信。

灵活性：遵循 HTTP 标准，允许客户端根据需求调用不同的 HTTP 方法。

可扩展性：可以轻松扩展 API 以满足新的需求。

POST /api/users
Content-Type: application/json

{
    "name": "Alice",
    "email": "alice@example.com"
}

这个请求会向 /api/users 发送数据，在服务器上创建一个新用户。