搜尋
首頁web前端js教程REST API 及其架構

REST API 及其架構

Sep 08, 2024 pm 08:33 PM

簡介

在當今的 Web 開發世界中,API(應用程式介面)在實現不同軟體系統之間的通訊方面發揮著至關重要的作用。最廣泛使用的 API 類型之一是 REST API,它代表表述性狀態傳輸。 REST API 已成為建立可擴充、可維護且有效率的 Web 服務的標準。在這篇部落格中,我們將深入探討 REST API 是什麼、它們的原則、架構、元件以及如何有效地設計和實作它們。

什麼是 REST API?
REST(表述性狀態傳輸)是一種用於設計網路應用程式的架構風格。它依賴於無狀態的客戶端-伺服器通訊模型,並且基於標準 HTTP 方法。 REST API 允許不同的應用程式使用一組簡單的約定(或者我們可以說規則)透過網路進行通訊。

REST API and Its Architecture

REST API 是一個接口,允許客戶端(例如 Web 或行動應用程序,如我們的瀏覽器或手機)透過發送 HTTP 請求和接收 HTTP 回應與伺服器進行互動。伺服器提供對資源的訪問,資源可以是從用戶個人資料到圖像或部落格文章的任何內容。
休息的關鍵原則
要被視為 RESTful,API 必須具備以下六個原則:

  1. 客戶端-伺服器架構:客戶端和伺服器應該要互相獨立。客戶端負責使用者介面和使用者體驗,而伺服器則處理後端邏輯、資料儲存和處理。
  2. 無狀態性:從客戶端到伺服器的每個請求都必須包含瞭解和處理請求所需的所有資訊。伺服器在請求之間不儲存任何客戶端資訊。這使得伺服器設計更加合理並增強了可擴展性。
  3. 可緩存性:來自伺服器的回應必須明確定義為可快取或不可快取。如果回應是可快取的,客戶端可以在將來的請求中重複使用回應數據,從而減少伺服器的負載並提高效能。
  4. 統一介面:REST API 必須提供與資源互動的一致且標準化的方式。這是透過四個子原則來實現的:  - 資源識別:使用URI(統一資源標識符)來識別資源。  - 透過表示操作資源:客戶端透過在請求中傳送表示(例如 JSON、XML)來與資源互動。  - 自描述訊息:每個請求和回應必須包含足夠的資訊來描述如何處理訊息。  - 超媒體作為應用程式狀態引擎 (HATEOAS):用戶端應使用回應中提供的超連結動態導覽 API。
  5. 分層系統:架構應允許在客戶端和伺服器之間使用中間層,例如快取、負載平衡和安全層,而客戶端不知道這些層。
  6. 按需程式碼(可選):伺服器可以透過傳送要在客戶端執行的可執行程式碼(例如 JavaScript)來擴充客戶端功能。這是 REST 中的可選約束。

REST API 架構
REST API 的架構由幾個關鍵元件組成,這些元件協同工作以建立客戶端和伺服器之間的通訊:

  1. 資源:資源是 REST API 的核心概念。它們代表 API 提供存取的資料或對象,例如使用者、產品、訂單等。每個資源都由唯一的 URI 標識。

  2. HTTP 方法:REST API 使用標準 HTTP 方法對資源執行 CRUD(建立、讀取、更新、刪除)操作:
     - GET:從資源中擷取資料。
     - POST:在資源(DB)中建立新的資料變更。
     - PUT:更新資料(DB)中的現有記錄。
     - DELETE:從DB中刪除特定資料。
     - PATCH:部分更新現有資料。
     - 選項:檢索資源支援的 HTTP 方法。

  3. HTTP 狀態碼:REST API 使用標準 HTTP 狀態碼來指示請求的結果。常見的狀態代碼包括:
     - 200 OK:請求成功。
     - 201 Created:新資源創建成功。
     - 204 No Content:請求成功,但沒有內容可回傳。
     - 400 錯誤請求:請求格式錯誤或無效。
     - 401 未經授權:用戶端必須進行身份驗證才能存取資源。
     - 404 Not Found:未找到請求的資源。
     - 500 內部伺服器錯誤:伺服器發生意外錯誤。

  4. 表示格式:REST API 支援各種資料交換表示格式,包括 JSON(JavaScript 物件表示法)、XML(可擴充標記語言)和 HTML。 JSON 是最常用的格式,因為它簡單且與 JavaScript 相容。

  5. 端點:端點是定義可以從伺服器存取特定資源的位置的 URL。每個端點對應於一個特定的資源,通常使用名詞而不是動詞來設計(例如/users、/products)。

設計 RESTful API

設計 RESTful API 涉及多個步驟,以確保其遵守 REST 原則並為客戶提供無縫體驗。以下是設計 REST API 的一些最佳實踐:

  1. 對端點使用名詞:端點應以資源(名詞)而非運算(動詞)命名。例如,使用 /users 來表示使用者集合,而不是 /getUsers。

  2. 正確使用 HTTP 方法:為每個操作使用正確的 HTTP 方法。例如,使用 GET 檢索資料、POST 建立資料、PUT 更新資料、DELETE 刪除資料。

  3. 實現過濾、排序和分頁:對於傳回資源清單的端點,實現過濾、排序和分頁以提高效能並為客戶端提供更多控制。使用 ?sort=name、?page=2 或 ?limit=10 等查詢參數來實現此目的。

  4. 對 API 進行版本控制:請務必對 API 進行版本控制,以在不破壞現有客戶端的情況下處理變更。在 URL 中(例如 /api/v1/users)或標頭中包含版本號。

  5. 提供有意義的 HTTP 狀態碼:傳回適當的 HTTP 狀態碼以指示請求的結果。避免每次回覆都使用 200 OK。

  6. 使用超媒體 (HATEOAS):在回應中包含鏈接,以允許客戶端動態導航 API,而無需硬編碼 URL。

  7. 確保安全:使用 HTTPS 加密傳輸中的資料來保護您的 API。實施身份驗證(例如 OAuth、JWT)和授權來控制對資源的存取。

  8. 優雅地處理錯誤:提供有意義的錯誤訊息和 HTTP 狀態碼,以幫助客戶端了解出了什麼問題。建立可重複使用的錯誤格式,其中包含錯誤代碼、訊息和可能的解決方案等詳細資訊。

REST API 設計範例

讓我們考慮一個用於管理書籍集合的簡單 REST API 範例:

  1. 端點:/api/v1/books
  2. GET /api/v1/books:從 db 取得所有書籍的清單。  - POST /api/v1/books:在資料庫中建立一本新書。
  3. 端點:/api/v1/books/{id}
  4. GET /api/v1/books/{id}:按 ID 回傳特定書籍。  - PUT /api/v1/books/{id}:透過 ID 更新特定書籍。  - DELETE /api/v1/books/{id}:依ID刪除特定書籍
  5. 錯誤處理範例:
  6. 如果顧客要求一本不存在的書:   - 回應:404 未找到   - 身體:身體看起來像這樣

REST API and Its Architecture

實作 REST API

要實作 REST API,您可以使用各種程式語言和框架。以下是結合使用 Node.js 和 Express.js 的範例:

REST API and Its Architecture

以上是REST API 及其架構的詳細內容。更多資訊請關注PHP中文網其他相關文章!

陳述
本文內容由網友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容,請聯絡admin@php.cn
Python和JavaScript的未來:趨勢和預測Python和JavaScript的未來:趨勢和預測Apr 27, 2025 am 12:21 AM

Python和JavaScript的未來趨勢包括:1.Python將鞏固在科學計算和AI領域的地位,2.JavaScript將推動Web技術發展,3.跨平台開發將成為熱門,4.性能優化將是重點。兩者都將繼續在各自領域擴展應用場景,並在性能上有更多突破。

Python vs. JavaScript:開發環境和工具Python vs. JavaScript:開發環境和工具Apr 26, 2025 am 12:09 AM

Python和JavaScript在開發環境上的選擇都很重要。 1)Python的開發環境包括PyCharm、JupyterNotebook和Anaconda,適合數據科學和快速原型開發。 2)JavaScript的開發環境包括Node.js、VSCode和Webpack,適用於前端和後端開發。根據項目需求選擇合適的工具可以提高開發效率和項目成功率。

JavaScript是用C編寫的嗎?檢查證據JavaScript是用C編寫的嗎?檢查證據Apr 25, 2025 am 12:15 AM

是的,JavaScript的引擎核心是用C語言編寫的。 1)C語言提供了高效性能和底層控制,適合JavaScript引擎的開發。 2)以V8引擎為例,其核心用C 編寫,結合了C的效率和麵向對象特性。 3)JavaScript引擎的工作原理包括解析、編譯和執行,C語言在這些過程中發揮關鍵作用。

JavaScript的角色:使網絡交互和動態JavaScript的角色:使網絡交互和動態Apr 24, 2025 am 12:12 AM

JavaScript是現代網站的核心,因為它增強了網頁的交互性和動態性。 1)它允許在不刷新頁面的情況下改變內容,2)通過DOMAPI操作網頁,3)支持複雜的交互效果如動畫和拖放,4)優化性能和最佳實踐提高用戶體驗。

C和JavaScript:連接解釋C和JavaScript:連接解釋Apr 23, 2025 am 12:07 AM

C 和JavaScript通過WebAssembly實現互操作性。 1)C 代碼編譯成WebAssembly模塊,引入到JavaScript環境中,增強計算能力。 2)在遊戲開發中,C 處理物理引擎和圖形渲染,JavaScript負責遊戲邏輯和用戶界面。

從網站到應用程序:JavaScript的不同應用從網站到應用程序:JavaScript的不同應用Apr 22, 2025 am 12:02 AM

JavaScript在網站、移動應用、桌面應用和服務器端編程中均有廣泛應用。 1)在網站開發中,JavaScript與HTML、CSS一起操作DOM,實現動態效果,並支持如jQuery、React等框架。 2)通過ReactNative和Ionic,JavaScript用於開發跨平台移動應用。 3)Electron框架使JavaScript能構建桌面應用。 4)Node.js讓JavaScript在服務器端運行,支持高並發請求。

Python vs. JavaScript:比較用例和應用程序Python vs. JavaScript:比較用例和應用程序Apr 21, 2025 am 12:01 AM

Python更適合數據科學和自動化,JavaScript更適合前端和全棧開發。 1.Python在數據科學和機器學習中表現出色,使用NumPy、Pandas等庫進行數據處理和建模。 2.Python在自動化和腳本編寫方面簡潔高效。 3.JavaScript在前端開發中不可或缺,用於構建動態網頁和單頁面應用。 4.JavaScript通過Node.js在後端開發中發揮作用,支持全棧開發。

C/C在JavaScript口譯員和編譯器中的作用C/C在JavaScript口譯員和編譯器中的作用Apr 20, 2025 am 12:01 AM

C和C 在JavaScript引擎中扮演了至关重要的角色,主要用于实现解释器和JIT编译器。1)C 用于解析JavaScript源码并生成抽象语法树。2)C 负责生成和执行字节码。3)C 实现JIT编译器,在运行时优化和编译热点代码,显著提高JavaScript的执行效率。

See all articles

熱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

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

熱工具

Safe Exam Browser

Safe Exam Browser

Safe Exam Browser是一個安全的瀏覽器環境,安全地進行線上考試。該軟體將任何電腦變成一個安全的工作站。它控制對任何實用工具的訪問,並防止學生使用未經授權的資源。

Dreamweaver Mac版

Dreamweaver Mac版

視覺化網頁開發工具

WebStorm Mac版

WebStorm Mac版

好用的JavaScript開發工具

EditPlus 中文破解版

EditPlus 中文破解版

體積小,語法高亮,不支援程式碼提示功能

mPDF

mPDF

mPDF是一個PHP庫,可以從UTF-8編碼的HTML產生PDF檔案。原作者Ian Back編寫mPDF以從他的網站上「即時」輸出PDF文件,並處理不同的語言。與原始腳本如HTML2FPDF相比,它的速度較慢,並且在使用Unicode字體時產生的檔案較大,但支援CSS樣式等,並進行了大量增強。支援幾乎所有語言,包括RTL(阿拉伯語和希伯來語)和CJK(中日韓)。支援嵌套的區塊級元素(如P、DIV),