Skip to main content

介紹RESTful api

RESTful api是什麼#

在網路上有蠻多說明他的內容,我覺得API 是什麼? RESTful API 又是什麼?這篇寫得蠻好的,可以先閱讀一下再來繼續接下來的內容

在這邊也做個簡單的說明 如果現在有個服務,會需要進行會員系統,那可以想像就會有以下流程

  • 註冊畫面(Create)
  • 查詢用戶(Read)
  • 修改密碼(Update)
  • 註銷會員(Delete)

在RESTful中,會使用改變Method的方式來取代動詞,讓網址列僅存在名詞,讓網址列的格式趨近一至

這個如果再沒有對應到RESTful的api,有可能會是 /createUser /searchUser /updateUser /deleteUser

而在RESTful api中,會用以下幾種方式來當成動詞 GET => 取得資料 POST => 創立資料 PUT => 更新資料 DELETE => 刪除資料 而在名詞部分除非明確可以感覺是單數,否則一率選擇複數為基準

所以套用以上規則,放到上方的四個功能就會變成 [GET]/users [POST]/users [PUT]/users/1234 [DELETE]/users/1234 1234為目標的唯一辨識碼,類似每個人的身分證字號的概念,每新建一個,就會產生一個獨一無二的編號

在之後設計的系統中,也都會以這個規範下去進行的