RESTful API是什麼?

1. REST 是Repersentational State Transfer的縮寫

翻譯爲"表述性狀態傳遞",那麼什麼是表述性狀態傳遞呢?爲了理解這個詞語,咱們從"RESTful是什麼"這個問題開始講起。編程

REST不是標準,是一種設計風格。按照這個設計風格設計出來的API,就叫REST API。api

2. 全部的東西都是資源,全部操做都經過對資源的增刪改查(CURD)實現

這個學過編程的應該很好理解,萬物皆對象,在REST中就是"萬物皆資源",每一個資源對應一個惟一的全局資源的定位符(URI),資源是整個REST的基礎。其次,就是客戶端能夠對資源進行管理,全部的管理操做都是經過HTTP的Action來實現。服務器

3. 對資源的增刪改查對應URL的操做(POST,DELETE,PUT,GET)

4. 全部操做都是無狀態的

也就是不要使用Sessionrestful

RESTful API示例

下面舉幾個RESTful API的例子,假設下面是一個學校學生信息的項目post

  • URL: http://localhost/student
  • GET /student 獲取學生列表
  • POST /student 新學員報到
  • GET /student/110 獲取ID爲110的學生信息
  • PUT /student/110 修改ID爲110的學生信息
  • DELETE /student/110 刪除ID爲110的學生信息
  • GET /student/110/home 獲取ID爲110的學生的家庭信息

登陸/註銷該怎麼設計API呢?

思考一下,咱們登陸,確定是爲了登陸後作某些操做,實際上就是向服務器請求一些受權。那麼註銷呢,就是請求服務器刪除這個受權。因此不難理解:url

POST /teacher 登陸翻譯

DELETE /teacher 註銷設計

URI命名總結規律就是:

/資源名稱rest

/資源名稱/{資源ID}對象

/資源名稱/{資源ID}/子資源名稱

/資源名稱/{資源ID}/子資源名稱/{子資源ID}

相關文章
相關標籤/搜索