“Web API” 通常指通過以下方式公開的功能和數據：
1 通過 HTTP(S) 公開
2 以 REST 風格使用 HTTP 協議
3 使用 JSON 作為數據格式
4 可通過互聯網使用
需要注意的是：
1 不是所有 Web API 都使用 JSON：大多數 API 都使用 JSON 作為數據格式，但一些 API 提供 XML 作為一種備用格式，或者甚至惟一地使用 XML。在理論上講，HTTP 可響應的任何請求都是有效的。如果您包含 MIME 類型（舉例而言，這可能意味著使用 PDF 文件），這種更廣泛的用途不那么常見。
2 不是所有 Web API 都是公共的：我們在后面的一節中將會看到，API 不僅在公共互聯網上公開和使用。但是，可以合理地認為，風格、用法以及受支持產品和協議上的許多一致意見都是互聯網用途所推動的。
3 不是所有 Web API 都直接使用 HTTP 的 REST 風格的特性：有許多面向互聯網的 SOAP/HTTP 接口，而且很難否認，這些接口在某種形式上也是 Web API。它們或許不那么 “REST 化”，而且更難使用。但是，許多 SOAP/HTTP 接口隨后引入了 JSON/HTTP “REST 風格的” 等效功能。
4 很少有 Web API 是完全 REST 風格的：在 Web API 中使用 JSON/HTTP，這意味著肯定比以前更加 REST 化。因此，它們通常被稱為 “REST” 接口。但是，實際上，大多數接口僅符合 有關該主題的原始材料 中描述的部分 REST 建議。針對自稱 REST 化的 API 的一種常見抱怨是，它們很少提供 HATEOS 方法所推薦的鏈接。
5 強烈推薦使用 HTTPS：HTTPS 顯然是首選的，而且許多人認為是 Web API 的強制要求。有效負載通常包含私有數據，用于訪問 Web API 的憑據通常是機密的。
posted on 2015-05-31 14:17
水 閱讀(2308)
評論(0) 編輯 收藏 引用 所屬分類:
架構