[ADP-300] REST 概述

reviewing phase 1

連結所有 ADP

INFO

本 ADP 提供了 REST（表述性狀態轉移）原則和 API 設計最佳實踐的概述。

ADP 編號範圍：300-349

關鍵概念

REST 以資源為中心，資源是系統中可以識別、命名、定址或處理的任何實體。資源通常是名詞，應使用清晰、描述性的術語命名。

資源可以有多種表述形式，如 JSON、XML 或 HTML。表述格式通常使用 Content-Type 標頭指定。

RESTful API 使用標準 HTTP 方法對資源進行操作：

關於 HTTP 方法，請見 ADP-110: HTTP 方法。

客戶端向伺服器的每個請求必須包含理解和處理該請求所需的所有資訊。伺服器不應在請求之間存儲任何客戶端上下文。

設計 RESTful API 時：

以上內容在下列各 ADP 內會詳細描述。