首頁 web前端 js教程 了解 REST API - 不耐煩者指南

了解 REST API - 不耐煩者指南

Nov 11, 2024 am 01:17 AM

我的文章在這裡交叉發布

REST(Re示範 State T傳輸)API 是現代 Web 開發的支柱。本文將詳細介紹如何建立和使用現代 REST API、製作 API 時要考慮哪些設計決策以及作為 REST 基礎的理論。

實用指南

本節深入探討如何將 REST API 與 HTTP 結合使用,涵蓋端點、方法、請求和回應。您將找到開始進行 API 呼叫和在專案中應用 REST 所需的一切。

如何建構 URI

一般來說,處理 URI 有兩種主要方法:

  1. 作為動作
  2. 作為資源

考慮以下兩個 URI:

  1. https://example.com/getUserData?id=1(操作)
  2. https://example.com/users/1(資源)

兩個範例都顯示我們檢索 id 為 1 的使用者的使用者資料。差別在於,在第一個範例中,路由 /getUserData 正在執行操作,而在第二個範例中,路由 /users/1 是資產,它並沒有表示正在執行什麼操作。我們可以說這種類型的 URI 充當名詞(因為它是一個事物而不是一個動作,即動詞)。

REST 模式要求我們嚴格使用 URI,如第二個範例。我們希望我們的 URI 是名詞,這樣我們就可以使用 HTTP 方法作為動詞來對這些名詞執行操作。例如,我們可以使用 HTTP 方法 GET 檢索有關 /users/1 的信息,但我們可以使用 PUT 更新相應用戶的信息,或使用 DELETE 完全刪除用戶。

關於 URI 需要注意的最後一件事是,與上面的範例一樣,當引用單一資源(例如本例中的單一使用者)時,URI 應以該資源的唯一識別碼結尾。引用給定類別中的所有資源時,應省略唯一識別碼。

  1. https://example.com/users/1 - 引用 id 為 1 的特定用戶
  2. https://example.com/users - 引用所有用戶,無論 id 為何

支持哪些行動

REST 支援4 個主要操作,我們使用縮寫CRUD 來記住它們:Create、Read、U 更新,D刪除。這些操作中的每一個都對應到一個我們可以用來執行該操作的 HTTP 方法。映射如下:

Action HTTP Method
Create POST
Read GET
Update PUT / PATCH
Delete DELETE

支援的所有操作 URI 組合

每個 REST API 其實只是(至少)5-6 個路由。在我們的範例中,基本端點將是 /users,我們將假裝將其託管在 https://example.com 上。

  • 取得 https://example.com/users
    • Action:傳回所有使用者資產(每個資產為一個使用者)
    • 請求正文:空
    • 回應正文:使用者資產清單(作為 JSON 陣列)
  • GET https://example.com/users/[id] ([id] 是變數)
    • 操作:僅傳回單一請求的使用者資產
    • 請求正文:空
    • 回應正文:僅具有符合ID的使用者資產(作為JSON)
  • 發佈 https://example.com/users
    • 操作:將一項使用者資產加入集合
    • 請求正文:建立新使用者資產所需的所有資料(不需要特定格式,建議使用JSON)
    • 回應正文:插入唯一 ID (作為 JSON) 的新建立的資產
  • PUT https://example.com/users/[id] ([id] 是變數)
    • 操作:用給定資料完全取代一個現有使用者的資料
    • 請求正文:取代現有使用者資料所需的所有數據,無論是否已更改(減去 id - 不需要特定格式,建議 JSON
    • 回應正文:具有匹配ID 的新更新資產(作為JSON)
  • (可選) PATCH https://example.com/users/[id] ([id] 是變數)
    • 操作:用給定資料部分取代一個現有使用者的資料
    • Request Body:只需要更新的資料(減 id - 不需要特定格式,建議 JSON
    • 回應正文:具有匹配ID 的新更新資產(作為JSON)
  • 刪除 https://example.com/users/[id] ([id] 是變數)
    • 操作:僅從使用者表中刪除一筆記錄
    • 請求正文:無
    • 回應正文:無(僅 HTTP 回應代碼)剛刪除的具有匹配 ID 的資產中的資料(作為 JSON)

設計考慮因素

除了定義端點是否使用 REST 模式之外,在開始建立端點之前還有很多事情需要考慮。您將來是否有可能想要更新您的端點?您的輸出是否應該向使用者提供有用的提示? REST 是否適合您的情況使用?讓我們回答其中一些問題。

對您的端點進行版本控制

從一開始就開始考慮 API 的版本控制可能是個好主意,以便將來更容易進行更改。有幾種不同的方法可以確定使用者選擇使用的 API 版本:

  • URI 版本控制
    • 版本號碼被合併到 URL 路徑中,通常位於底部
    • 範例
    • https://example.com/v1/users/1
    • https://example.com/v2/users/1
  • 查詢參數
    • 版本號碼作為查詢參數附加在 API 端點
    • 範例
    • https://example.com/users/1?apiVersion=1
    • https://example.com/users/1?apiVersion=2
  • 基於標題
    • 版本號碼是一個特定且唯一的標頭欄位
    • 範例(請求標頭)
    • x-api-版本:1
    • x-api-版本:2
  • 內容協商
    • 版本是根據表徵狀態或媒體類型決定的。
    • 在下面的範例中,伺服器程式碼會知道firstName是第一個版本的名稱,並且在下一個版本中它被更改為givenName。
    • 範例(請求正文)
    • { 名字: '亨利' }
    • {給定名稱:'亨利'}

模擬快速 REST API

有時,嘗試一下是了解它們如何運作的最佳工具。我最喜歡的演示 REST 的庫之一是 json-server。設定非常簡單 - 只需幾個步驟。

安裝 JSON 伺服器

npm install json-server
登入後複製

建立一個簡單的資料儲存

{
  "users": [
    { "id": "1", "username": "gorwell", "email": "gorwell@gmail.com" },
    { "id": "2", "username": "cdickens", "email": "cdickens@gmail.com" },
    { "id": "3", "username": "jausten", "email": "jausten@gmail.com" },
    { "id": "4", "username": "vwoolf", "email": "vwoolf@gmail.com" },
    { "id": "5", "username": "sking", "email": "sking@gmail.com" }
  ]
}
登入後複製

啟動伺服器

npx json-server db.json
登入後複製

向本機伺服器發出 HTTP 請求

curl -X GET http://localhost:3000/users/1
登入後複製

簡單的 CRUD 資料網格

功能齊全的 REST 端點可以使用 ZingGrid 輕鬆連接到資料網格,只需將基本 REST URI 指向 即可。元素的 src 屬性如下

<zing-grid
  src="http://localhost:3000/users"
  editor-controls
></zing-grid>
登入後複製

Understanding REST APIs - A Guide for the Impatient

最後的想法

REST API 在網路上有多種形狀和大小,每種都是為了滿足特定需求而客製化的。透過深思熟慮地建構 URI、選擇正確的操作並牢記版本控制,您可以創建一個簡單、靈活的 API,開發人員會樂於使用它。透過這些基本步驟,即使是快速原型也可以演變成健壯、可靠、經得起時間考驗的 API。

以上是了解 REST API - 不耐煩者指南的詳細內容。更多資訊請關注PHP中文網其他相關文章!

本網站聲明
本文內容由網友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容,請聯絡admin@php.cn

熱AI工具

Undresser.AI Undress

Undresser.AI Undress

人工智慧驅動的應用程序,用於創建逼真的裸體照片

AI Clothes Remover

AI Clothes Remover

用於從照片中去除衣服的線上人工智慧工具。

Undress AI Tool

Undress AI Tool

免費脫衣圖片

Clothoff.io

Clothoff.io

AI脫衣器

Video Face Swap

Video Face Swap

使用我們完全免費的人工智慧換臉工具,輕鬆在任何影片中換臉!

熱工具

記事本++7.3.1

記事本++7.3.1

好用且免費的程式碼編輯器

SublimeText3漢化版

SublimeText3漢化版

中文版,非常好用

禪工作室 13.0.1

禪工作室 13.0.1

強大的PHP整合開發環境

Dreamweaver CS6

Dreamweaver CS6

視覺化網頁開發工具

SublimeText3 Mac版

SublimeText3 Mac版

神級程式碼編輯軟體(SublimeText3)

前端熱敏紙小票打印遇到亂碼問題怎麼辦? 前端熱敏紙小票打印遇到亂碼問題怎麼辦? Apr 04, 2025 pm 02:42 PM

前端熱敏紙小票打印的常見問題與解決方案在前端開發中,小票打印是一個常見的需求。然而,很多開發者在實...

神秘的JavaScript:它的作用以及為什麼重要 神秘的JavaScript:它的作用以及為什麼重要 Apr 09, 2025 am 12:07 AM

JavaScript是現代Web開發的基石,它的主要功能包括事件驅動編程、動態內容生成和異步編程。 1)事件驅動編程允許網頁根據用戶操作動態變化。 2)動態內容生成使得頁面內容可以根據條件調整。 3)異步編程確保用戶界面不被阻塞。 JavaScript廣泛應用於網頁交互、單頁面應用和服務器端開發,極大地提升了用戶體驗和跨平台開發的靈活性。

誰得到更多的Python或JavaScript? 誰得到更多的Python或JavaScript? Apr 04, 2025 am 12:09 AM

Python和JavaScript開發者的薪資沒有絕對的高低,具體取決於技能和行業需求。 1.Python在數據科學和機器學習領域可能薪資更高。 2.JavaScript在前端和全棧開發中需求大,薪資也可觀。 3.影響因素包括經驗、地理位置、公司規模和特定技能。

如何實現視差滾動和元素動畫效果,像資生堂官網那樣?
或者:
怎樣才能像資生堂官網一樣,實現頁面滾動伴隨的動畫效果? 如何實現視差滾動和元素動畫效果,像資生堂官網那樣? 或者: 怎樣才能像資生堂官網一樣,實現頁面滾動伴隨的動畫效果? Apr 04, 2025 pm 05:36 PM

實現視差滾動和元素動畫效果的探討本文將探討如何實現類似資生堂官網(https://www.shiseido.co.jp/sb/wonderland/)中�...

JavaScript難以學習嗎? JavaScript難以學習嗎? Apr 03, 2025 am 12:20 AM

學習JavaScript不難,但有挑戰。 1)理解基礎概念如變量、數據類型、函數等。 2)掌握異步編程,通過事件循環實現。 3)使用DOM操作和Promise處理異步請求。 4)避免常見錯誤,使用調試技巧。 5)優化性能,遵循最佳實踐。

JavaScript的演變:當前的趨勢和未來前景 JavaScript的演變:當前的趨勢和未來前景 Apr 10, 2025 am 09:33 AM

JavaScript的最新趨勢包括TypeScript的崛起、現代框架和庫的流行以及WebAssembly的應用。未來前景涵蓋更強大的類型系統、服務器端JavaScript的發展、人工智能和機器學習的擴展以及物聯網和邊緣計算的潛力。

如何使用JavaScript將具有相同ID的數組元素合併到一個對像中? 如何使用JavaScript將具有相同ID的數組元素合併到一個對像中? Apr 04, 2025 pm 05:09 PM

如何在JavaScript中將具有相同ID的數組元素合併到一個對像中?在處理數據時,我們常常會遇到需要將具有相同ID�...

Zustand異步操作:如何確保useStore獲取的最新狀態? Zustand異步操作:如何確保useStore獲取的最新狀態? Apr 04, 2025 pm 02:09 PM

zustand異步操作中的數據更新問題在使用zustand狀態管理庫時,經常會遇到異步操作導致數據更新不及時的問題。 �...

See all articles