構(gòu)建 Web API 的兩種流行選擇：REST vs GraphQL-魔扣目錄

在 RESTful 和 GraphQL API 之間的選擇取決于您的具體用例。RESTful API 適用于需要高可伸縮性的簡單應(yīng)用程序，而 GraphQL 則適用于具有不同數(shù)據(jù)需求的復(fù)雜應(yīng)用程序。

簡介

RESTful 和 GraphQL API 是構(gòu)建 Web API 的兩種流行選擇，各有其優(yōu)勢和劣勢。讓我們更近距離地了解一下 RESTful 和 GraphQL API，它們的區(qū)別，以及在何時選擇其中一種。

RESTful API 已經(jīng)存在了一段時間，并且通常被廣泛使用，而 GraphQL 是近年來變得流行的較新技術(shù)。

第一部分：什么是 RESTful API？

RESTful API 遵循一組規(guī)則和約束，規(guī)定了 API 應(yīng)該如何設(shè)計(jì)。

1.使用標(biāo)準(zhǔn)的 HTTP 方法

它們使用標(biāo)準(zhǔn)的 HTTP 方法，例如 GET、POST、PUT、PATCH 和 DELETE，對資源執(zhí)行操作，數(shù)據(jù)通常以 JSON 格式返回。

2.是無狀態(tài)的

RESTful API 是無狀態(tài)的，這意味著服務(wù)器不會在請求之間存儲任何客戶端上下文。相反，每個請求都包含服務(wù)器處理所需的所有信息。這使得 RESTful Web 服務(wù)高度可伸縮，因?yàn)樗鼈兛梢蕴幚泶罅空埱蠖鵁o需為會話管理負(fù)擔(dān)。

3.具有 URL 約定

RESTful URL 命名約定的主要原則之一是在 URL 路徑中使用名詞而不是動詞。例如，不適合使用 /get-user-profile 這樣的 URL，更適合使用 /users/{user_id}/profile。該 URL 使用名詞 users 表示用戶資源的集合，并使用路徑參數(shù) user_id 來標(biāo)識要訪問的特定用戶資源。

第二部分：什么是 GraphQL？

GraphQL 是一個用于 API 的查詢語言，允許客戶端定義其需要的數(shù)據(jù)的形狀和結(jié)構(gòu)。使用 GraphQL，客戶端可以向服務(wù)器發(fā)出單個請求，并準(zhǔn)確獲取它們要求的數(shù)據(jù)，而沒有其他多余的數(shù)據(jù)。

1.提供單個端點(diǎn)

與 RESTful API 不同，GraphQL 提供一個單個端點(diǎn)，通常是 /graphql，它始終接受 POST 請求。客戶端向此端點(diǎn)發(fā)送單個請求，服務(wù)器將根據(jù)通過請求體發(fā)送的查詢或變更響應(yīng)請求的數(shù)據(jù)。

這種方法使得管理和版本化 API 變得容易，因?yàn)樗懈亩伎梢栽谝粋€地方進(jìn)行。

2.是無狀態(tài)的

GraphQL API 也是無狀態(tài)的，服務(wù)器不存儲任何客戶端數(shù)據(jù)，每個請求都包含請求查詢中的所有信息。

第三部分：比較 RESTful 和 GraphQL API

RESTful 和 GraphQL API 在設(shè)計(jì)和查詢 API 方面采用不同的方法。讓我們根據(jù)一些關(guān)鍵因素進(jìn)行比較：

1.數(shù)據(jù)獲取

RESTful API 遵循嚴(yán)格的請求-響應(yīng)循環(huán)，其中來自客戶端的每個請求都導(dǎo)致服務(wù)器的單個響應(yīng)。這意味著客戶端通常需要進(jìn)行多個請求，從服務(wù)器獲取相關(guān)數(shù)據(jù)，從而導(dǎo)致過度獲取或不足獲取數(shù)據(jù)。

GraphQL 相反，允許客戶端僅請求他們需要的數(shù)據(jù)，而不是其他多余的數(shù)據(jù)。客戶端可以指定他們需要的數(shù)據(jù)的結(jié)構(gòu)，服務(wù)器會準(zhǔn)確返回該數(shù)據(jù)，減少過度獲取和不足獲取數(shù)據(jù)。