iT邦幫忙

DAY 3
2

從無到有打造 RESTful API service系列 第 3

[API-d3] - 使用時機與實際 API 參考

小弟的規劃表 - http://blog.kerkerj.in/blog/2014/11/01/planning/
好讀版 - http://blog.kerkerj.in/blog/2014/10/03/api-d3/

什麼時候需要打造 RESTful API?
看看別人的 RESTful API (Instagram/Twitter)

什麼時候需要打造 RESTful API?
我認為當有數組資源要被多種不同平台使用時,就需要打造 RESTful API
例如,有 Android/ iOS / Web 要對同一 table 做存取時,
假設有個 MySQL DB,各個平台都使用各自的 mysql-driver 來直接操作 DB
假設有個 A 專案建立了一套書籍管理系統,資料庫裡記錄了大大小小的書籍,
而有個新的 B 專案需要使用到書籍的資料,此時 DB 操作的程式碼只能再寫一遍,
且各個平台重新撰寫,似乎是不大靠譜。

撰寫 RESTful API 的好處之一即是 RESTful 使用 HTTP 協定,
各個平台皆支援,不需要太複雜的程式,只需要使用各個平台的 http-client,
各個平台也不需要瞭解 DB 操作語法,只需要知道 json, xml 習慣的資料格式,
且開發 API 還能夠對各個資源輕易地上 cache 增進反應速度,
開發 RESTful API 好處多多,哪天想 Open API 也就不需要再多作處理了~

接著讓我們來看看兩個有名網站的 API 吧!

Instagram: http://instagram.com/developer/api-console/
Twitter: https://dev.twitter.com/rest/tools/console

順帶一提,一份良好的文件也蠻重要的,不管此 API 是公開的或是非公開的。

很顯然的,我比較喜歡 Instagram 的 API 資源定義與命名方式 :P

下一篇會介紹我接下來會用到的工具箱,暖身結束,要正式開始了!
(不好意思前面嘴炮一點 XD)


上一篇
[API-d2] - 定義 2 - RESTful 的優點與要求
下一篇
[API-d4] - 使用技術與工具介紹及原因
系列文
從無到有打造 RESTful API service30

尚未有邦友留言

立即登入留言