※ 引述《thefattiger (LawTea)》之銘言:
: 但查了一下資訊卻還是摸不著頭緒
: 估狗RESTful API 大概都是講到一下幾點
: 1.資源要用URL表示
: 這不是本來就這樣的嗎?
: 2.Server要回傳對應的Http Status Code
: 這不是也本來就這樣的嗎?
: 3.用GET/POST/PUT等動詞表達對資源的操作
: 意思是說, 本來只有GET/POST用法, 但其實還有PUT/PATCH/DELETE等等
: 應該要善加利用這些動詞把操作分得更清楚?
: 4.Stateless
: 這也很常看到,但Http不是本來就Stateless的嗎?
:
: 我的問題主要是,這些東西不是Http本來就有的嗎?
您的問題圍繞在"這不是Http本來就這樣的嗎"。RESTful API是利用
既有的A領域工具解決B領域的問題。B領域的人可能會覺得很新奇,
但是熟悉A領域的人,可能會覺得本來就是這樣,沒什麼特別的。
遙想199x年的古老時代,PC軟體工程師J用Java寫了一個資料處理程式。
另一個PC軟體工程師D跟J說: 我的專案剛好需要你的程式。你的程式
可以copy給我嗎?讓我可以編譯連結到我的專案程式。
J: 不行,這個程式我要申請專利,我不想copy給你。而且,你的程式是
用Delphi寫的,你要如何連結我的Java程式?
網路專家H聽到兩人的談話,也加入討論。
H: 現在網路很流行,何不這樣,J的程式放在J的電腦,不用copy給D。
讓D的電腦裡的程式透過網路呼叫J的程式,傳回結果。
J: 這麼神奇!?但是D的程式要如何透過網路呼叫我的函式呢?如何傳遞
參數呢?
D: 聽說FTP可以用來在網路上傳檔案,我們把它用來傳參數。我把參數
存成檔案,用ftp傳給你,你也把結果存成檔案,用ftp傳回給我。
J: 這個方式聽起來似乎可行,但是感覺執行起來有點麻煩。
H: 現在WWW開始流行,我家阿嬤都在用HTTP瀏覽網站。你們何不使用
HTTP? HTTP的request-response不就好像API函式呼叫嗎?HTTP的url
剛好可以當函式名稱+參數, HTTP的status code剛好也可以拿來當
function error/status code。HTTP的GET/POST/PUT/PATCH/DELETE
剛好可以對應你的資料處理CRUD。如果你的程式專利通過了,你要開放
給全世界上千萬軟體工程師呼叫,剛好HTTP是stateless,可以讓你的
電腦負荷比較小。
D: 太好了,太漂亮了,beautiful! 這種用HTTP做遠端API呼叫的方式
要叫什麼名字呢?
H: 用這種方式,工程師們不用煩惱跨語言編譯連結...等很多問題,
可以省下很多時間,這些時間可以拿來好好休息護肝。我們就叫它
RESTful API吧。