第1章 什麼是 Web API

1.1 Web API 的重要性

一些線上服務能夠對那些公開的API進行會話控制、訪問控制、服務分析，提供面向使用者的儀表盤，以及釋出文件等，承接了各種各樣的工作。

通過對外公開 Web API，同外部其他服務的整合變得更加便捷，並從中衍生出了新的價值，使線上服務以及業務不斷髮展，逐步形成了“API經濟學”的景象，並在這幾年受到相當大的關注。

1.2 各種各樣的 API 模式

• 將已釋出的 Web 線上服務的資料或功能通過 API 公開
• 將附加在其他網頁上的微件公開
• 構建現代 Web 應用
• 開發智慧手機應用
• 公司內部多個系統的整合

1.3 應該通過 API 公開什麼

• 最簡潔的答案是將你的線上服務所能做的事情全部通過API公開
• 不存在徹底遮蔽蒐集資訊的行為，所以無需擔心盜用，公開 API並不意味著毫無限制的訪問
• 公開 API 將原來的服務組合成新的應用來為使用者提供服務的“間接銷售”模式

1.4 設計優美 API 的重要性

• 易於使用
• 便於更改
• 健壯性好
• 不怕公之於眾

1.5 如何美化 Web API

兩個重要原則：

• 設計規範明確的內容必須遵守相關規範
• 沒有設計規範的內容必須遵守相關事實標準

1.6 REST 與 Web API

REST 一次一般指下面兩種意思：

• 符合 Fielding 的 REST 架構風格的Web服務系統
• 符合 RPC風格的 XML (或JSON) + HTTP 介面的系統(不使用SOAP)

1.8 小結

• 如果尚未公開 Web AP，則應立即考慮公開
• 設計優美的 Web API
• 不用過分拘泥於 REST 一詞