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