※ 引述《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吧。