From 0d7c27a071790ceca2540b64b0ec7590abdcfa61 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=8A=93=E4=BD=8F=E4=BA=91=E6=9C=B5?= <2980290425@qq.com> Date: Sun, 19 May 2024 14:35:56 +0000 Subject: [PATCH 1/2] =?UTF-8?q?=E6=96=B0=E5=BB=BA=20=E9=83=91=E5=AE=B6?= =?UTF-8?q?=E7=82=9C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- "\351\203\221\345\256\266\347\202\234/.keep" | 0 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 "\351\203\221\345\256\266\347\202\234/.keep" diff --git "a/\351\203\221\345\256\266\347\202\234/.keep" "b/\351\203\221\345\256\266\347\202\234/.keep" new file mode 100644 index 0000000..e69de29 -- Gitee From bc06952048480a262be5f34753c54f93f7213d7c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=8A=93=E4=BD=8F=E4=BA=91=E6=9C=B5?= <2980290425@qq.com> Date: Sun, 19 May 2024 14:56:21 +0000 Subject: [PATCH 2/2] EE MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 抓住云朵 <2980290425@qq.com> --- ...0240516-\350\256\244\350\257\206webapi.md" | 36 +++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 "\351\203\221\345\256\266\347\202\234/20240516-\350\256\244\350\257\206webapi.md" diff --git "a/\351\203\221\345\256\266\347\202\234/20240516-\350\256\244\350\257\206webapi.md" "b/\351\203\221\345\256\266\347\202\234/20240516-\350\256\244\350\257\206webapi.md" new file mode 100644 index 0000000..84ec103 --- /dev/null +++ "b/\351\203\221\345\256\266\347\202\234/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