HTTP verbs & RESTful

HTTP verbs 以及 RESTful API

• 主要且最常見的 HTTP verbs(或稱 methods) 為 POST，GET，PUT，DELETE，PATCH。它們對應到 create，read，update，delete 操作，簡稱 CRUD

  • 另外，OPTIONS 與 HEAD 是另外兩個比較常見的少見 methods

• 以下為 RESTful 設計的對應表格。資料來源：http://www.restapitutorial.com/lessons/httpmethods.html

• HTTP Verb	CRUD	Entire Collection (e.g. /customers)	Specific Item (e.g. /customers/{id})
  POST	Create	201 (Created), 'Location' header with link to /customers/{id} containing new ID.	404 (Not Found), 409 (Conflict) if resource already exists..
  GET	Read	200 (OK), list of customers. Use pagination, sorting and filtering to navigate big lists.	200 (OK), single customer. 404 (Not Found), if ID not found or invalid.
  PUT	Update/Replace	405 (Method Not Allowed), unless you want to update/replace every resource in the entire collection.	200 (OK) or 204 (No Content). 404 (Not Found), if ID not found or invalid.
  PATCH	Update/Modify	405 (Method Not Allowed), unless you want to modify the collection itself.	200 (OK) or 204 (No Content). 404 (Not Found), if ID not found or invalid.
  DELETE	Delete	405 (Method Not Allowed), unless you want to delete the whole collection—not often desirable.	200 (OK). 404 (Not Found), if ID not found or invalid.