From eca97d09ac2552ab0b8bd64890a32287aa3155e8 Mon Sep 17 00:00:00 2001
From: zhan <2182174962@qq.com>
Date: Sun, 19 May 2024 22:45:41 +0800
Subject: [PATCH] =?UTF-8?q?=E4=B8=8D=E8=AE=A1=E8=BE=83?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...0240516-\350\256\244\350\257\206webapi.md" | 36 +++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 "\345\215\240\347\277\212\345\206\233/20240516-\350\256\244\350\257\206webapi.md"

diff --git "a/\345\215\240\347\277\212\345\206\233/20240516-\350\256\244\350\257\206webapi.md" "b/\345\215\240\347\277\212\345\206\233/20240516-\350\256\244\350\257\206webapi.md"
new file mode 100644
index 0000000..af3e2a7
--- /dev/null
+++ "b/\345\215\240\347\277\212\345\206\233/20240516-\350\256\244\350\257\206webapi.md"
@@ -0,0 +1,36 @@
+## 常见的 Web API 类型
+
+### RESTful API
+
+RESTful API 是一种基于 REST（Representational State Transfer）原则设计的 API。它使用 HTTP 协议的不同方法（GET、POST、PUT、DELETE 等）来执行不同的操作，例如获取数据、创建资源、更新资源或删除资源。RESTful API 使用简单的 URL 结构和状态码，易于理解和实现。
+
+### GraphQL API
+
+GraphQL 是一种查询语言，允许客户端请求指定所需的数据。相比于传统的 RESTful API，GraphQL API 允许客户端精确地指定返回结果的格式和内容，避免了多次请求和返回冗余数据的问题。GraphQL API 的灵活性和效率使其在一些场景下更具优势。
+
+## RESTful API 的特点
+
+- **基于资源（Resource-based）**：在 RESTful API 中，每个 URL 代表一个资源（Resource），并且通过 HTTP 方法对资源进行操作。资源可以是实体对象（如用户、文章）或集合（如用户列表）。
+
+- **使用 HTTP 方法**：RESTful API 使用 HTTP 方法来定义对资源的操作。常用的方法包括 GET（获取资源）、POST（创建资源）、PUT（更新资源）、DELETE（删除资源）等。
+
+- **无状态（Stateless）**：RESTful API 是无状态的，每个请求都是独立的，服务器不会保存请求的上下文信息。客户端需要提供所有请求所需的数据和信息。
+
+- **使用 JSON 或 XML 进行数据交换**：通常，RESTful API 使用 JSON 或 XML 格式来传输数据。JSON 更为常用，因为它具有更好的可读性和易用性。
+
+## RESTful API 的设计原则
+
+- 使用合适的 HTTP 方法对资源进行操作，如 GET、POST、PUT、DELETE。
+- 使用简洁明了的 URL 结构，使其易于理解和记忆。
+- 对资源的操作应该是幂等的，即无论执行多少次都不会对资源状态产生影响。
+- 返回合适的状态码（如 200、201、404、500）以表示请求的成功或失败。
+
+## RESTful API 的示例
+
+假设有一个博客系统，可以使用以下方式设计 RESTful API：
+
+- 获取所有文章：`GET /api/articles`
+- 获取单篇文章：`GET /api/articles/:id`
+- 创建文章：`POST /api/articles`
+- 更新文章：`PUT /api/articles/:id`
+- 删除文章：`DELETE /api/articles/:id`
\ No newline at end of file
-- 
Gitee