RESTful API 相關資訊收集
Web API 是否一定要 RESTful? RESTful API 是指實踐 REST Representational State Transfer 精神的 API 設計風格，其核心精神在於借用 HTTP 協定做為基礎，讓 API 規格簡單一致，大致有以下特色 ： 透過 URI 指定要存取或操作的資源 可使用 QueryString，但只應拿來傳遞額外過濾條件或參數，不應包含識別資源的鍵值 使用 HTTP 方法 POST、GET、PUT、DELETE 對應到建立、讀取、更新、刪除等動作。 也有人主張 PUT 是 Relace (Create 或 Update)，另外增加 PATCH 用於部分更新( Partial Update ) 透過 Accept Header 指明可接收的內容格式，例如：XML 或是 JSON 伺服器透過 HTTP 狀態碼回傳執行結果，例如：200 成功、401 存取被拒、404 找不到資源、500 伺服器錯誤 而 REST 概念的提出者 Roy Fielding 是 HTTP 規範的主要作者及 Apache HTTP Server 專案的發起人之一，這也是讓 RESTful API 風格備受推崇的原因之一。 RESTful API 設計準則與實務經驗 RESTful 是一種「軟體架構風格」 RESTful-Triangle (REST 金三角) 概念： RESTful-Triangle 右邊這個三角形描述了以下三個重要的概念： Nouns 名詞：用來定義你的網址 URL，記住，每一個網路上的資源應該僅有一個唯一的識別位置，就像你的房子有獨一無二的「住址」一樣。 Verbs 動詞：描述了對 Nouns 名詞 (資源 URL) 的操作動作，在 HTTP 1.1 的實作當然就是 HTTP Method。比如用 GET 取得文章內容、用 DELETE 刪除文章等等行為。 Content Types 資源呈現方式：比如取得某一個 URL 文章的 HTML 格式、或者 XML 格式，同樣的 URL 資源可以有不同型態的表現方式。 RESTful 的優點與要求 RESTful 的優點如下所列: 瀏覽...
