iT邦幫忙

2022 iThome 鐵人賽

DAY 21
1
Software Development

ASP.NET Core 30 天旅程系列 第 21

[Day21]- API 系列之 RESTful API 是什麼?

  • 分享至 

  • xImage
  •  

RESTful API 全名為 Representational State Transfer(表現層狀態轉換)由 Roy Thomas Fielding 博士於2000 提出,是一種設計提供全球資訊網絡服務的軟體構建風格

REST是設計風格而不是標準

若是今天要做新增使用者、修改使用者、刪除使用者、查詢使用者
一般的寫法可能是
查詢使用者 /getAllUser
新增使用者 /createUser
修改使用者 /updateUser
刪除使用者 /deleteUser/1

以上有可能是某位工程師寫的,那如果換另一個工程是有可能是另一種命名方式。

若使用 RESTful API
查詢使用者 GET /User
單一使用者 GET /User/1
新增使用者 POST /User
修改使用者 PUT /User/1
刪除使用者 DELETE /User/1

以上的案例可以看出 RESTful API 最大的特性統一介面(Uniform Interface)以簡潔且直觀的 URL 來表示資源的位置。

其他 REST 架構的優點及限制請點此

HTTP Status Code

狀態碼代表在傳輸過程中的狀態可分為下幾種

1xx = Informational (資訊)
2xx = Success(成功)
3xx = Redirection(重定向)
4xx = Client Error(客戶端錯誤)
5xx = Server Error(伺服器端錯誤)

例如常見的如下圖打★
https://ithelp.ithome.com.tw/upload/images/20221006/20152200KnIVzcGThz.png
(不用特意背 常使用API就會記起來了XD)


參考資料

HTTP Status Codes
表現層狀態轉換


上一篇
[Day20]-重新導向攻擊 & IP 安全清單
下一篇
[Day22]- API 系列之 JWT
系列文
ASP.NET Core 30 天旅程30
圖片
  直播研討會
圖片
{{ item.channelVendor }} {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言